QSurfaceFormat Class

Documentación de las funciones miembro

QSurfaceFormat::QSurfaceFormat()

Construye un QSurfaceFormat inicializado por defecto.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

Construye un QSurfaceFormat con el formato dado options.

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

Construye una copia de other.

[noexcept] QSurfaceFormat::~QSurfaceFormat()

Destruye el QSurfaceFormat.

int QSurfaceFormat::alphaBufferSize() const

Obtiene el tamaño en bits del canal alfa del buffer de color.

Véase también setAlphaBufferSize().

int QSurfaceFormat::blueBufferSize() const

Obtiene el tamaño en bits del canal azul del buffer de color.

Véase también setBlueBufferSize().

const QColorSpace &QSurfaceFormat::colorSpace() const

Devuelve el espacio de color.

Véase también setColorSpace().

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

Devuelve el formato de superficie global por defecto.

Cuando no se llama a setDefaultFormat(), se trata de un QSurfaceFormat construido por defecto.

Véase también setDefaultFormat().

int QSurfaceFormat::depthBufferSize() const

Devuelve el tamaño del búfer de profundidad.

Véase también setDepthBufferSize().

int QSurfaceFormat::greenBufferSize() const

Obtiene el tamaño en bits del canal verde del buffer de color.

Véase también setGreenBufferSize().

bool QSurfaceFormat::hasAlpha() const

Devuelve true si el tamaño del búfer alfa es mayor que cero.

Esto significa que la superficie podría utilizarse con efectos de translucidez por píxel.

int QSurfaceFormat::majorVersion() const

Devuelve la versión principal de OpenGL.

La versión por defecto es 2.0.

Véase también setMajorVersion().

int QSurfaceFormat::minorVersion() const

Devuelve la versión menor de OpenGL.

Véase también setMinorVersion().

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

Devuelve las opciones de formato configuradas actualmente.

Véase también setOption(), setOptions() y testOption().

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

Obtiene el perfil de contexto OpenGL configurado.

Este parámetro se ignora si la versión de OpenGL solicitada es inferior a 3.2.

Véase también setProfile().

int QSurfaceFormat::redBufferSize() const

Obtiene el tamaño en bits del canal rojo del buffer de color.

Véase también setRedBufferSize().

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

Obtiene el tipo de renderizable.

Elige entre OpenGL de escritorio, OpenGL ES y OpenVG.

Véase también setRenderableType().

int QSurfaceFormat::samples() const

Devuelve el número de muestras por píxel cuando el multimuestreo está activado, o -1 cuando el multimuestreo está desactivado. El valor devuelto por defecto es -1.

Véase también setSamples().

void QSurfaceFormat::setAlphaBufferSize(int size)

Establece el size deseado en bits del canal alfa del buffer de color.

Véase también alphaBufferSize().

void QSurfaceFormat::setBlueBufferSize(int size)

Establece el size deseado en bits del canal azul del buffer de color.

Véase también blueBufferSize().

[since 6.0] void QSurfaceFormat::setColorSpace(const QColorSpace &colorSpace)

Establece la preferencia colorSpace.

Por ejemplo, esto permite solicitar ventanas con framebuffers por defecto que sean compatibles con sRGB en plataformas que lo soporten.

Esta función se introdujo en Qt 6.0.

Véase también colorSpace().

[static] void QSurfaceFormat::setDefaultFormat(const QSurfaceFormat &format)

Establece la superficie global por defecto format.

Este formato se utiliza por defecto en QOpenGLContext, QWindow, QOpenGLWidget y clases similares.

Siempre se puede anular en cada instancia utilizando la función setFormat() de la clase en cuestión. Sin embargo, a menudo es más conveniente establecer el formato para todas las ventanas una vez al inicio de la aplicación. También garantiza un comportamiento adecuado en los casos en los que se requieren contextos compartidos, ya que establecer el formato a través de esta función garantiza que todos los contextos y superficies, incluso los creados internamente por Qt, utilizarán el mismo formato.

Véase también defaultFormat().

void QSurfaceFormat::setDepthBufferSize(int size)

Establece el tamaño mínimo del búfer de profundidad en size.

Véase también depthBufferSize().

void QSurfaceFormat::setGreenBufferSize(int size)

Establece el size deseado en bits del canal verde del buffer de color.

Véase también greenBufferSize().

void QSurfaceFormat::setMajorVersion(int major)

Establece la versión de OpenGL deseada major.

Véase también majorVersion().

void QSurfaceFormat::setMinorVersion(int minor)

Establece la versión de OpenGL deseada en minor.

La versión por defecto es 2.0.

Véase también minorVersion().

void QSurfaceFormat::setOption(QSurfaceFormat::FormatOption option, bool on = true)

Establece la opción de formato option si on es verdadero; en caso contrario, borra la opción.

Para verificar que se ha respetado una opción, compare el formato real con el formato solicitado tras la creación de la superficie/contexto.

Véase también setOptions(), options() y testOption().

void QSurfaceFormat::setOptions(QSurfaceFormat::FormatOptions options)

Establece las opciones de formato en options.

Para verificar que se ha respetado una opción, compara el formato real con el formato solicitado tras la creación de la superficie/contexto.

Véase también options() y testOption().

void QSurfaceFormat::setProfile(QSurfaceFormat::OpenGLContextProfile profile)

Establece el contexto OpenGL deseado profile.

Este ajuste se ignora si la versión de OpenGL solicitada es inferior a 3.2.

Véase también profile().

void QSurfaceFormat::setRedBufferSize(int size)

Establece el size deseado en bits del canal rojo del buffer de color.

Véase también redBufferSize().

void QSurfaceFormat::setRenderableType(QSurfaceFormat::RenderableType type)

Establece el renderizable deseado type.

Elige entre OpenGL de escritorio, OpenGL ES y OpenVG.

Véase también renderableType().

void QSurfaceFormat::setSamples(int numSamples)

Establece el número preferido de muestras por píxel cuando el multimuestreo está activado en numSamples. Por defecto, el multimuestreo está desactivado.

Véase también samples().

void QSurfaceFormat::setStencilBufferSize(int size)

Establece el tamaño preferido del búfer del esténcil en size bits.

Véase también stencilBufferSize().

void QSurfaceFormat::setStereo(bool enable)

Si enable es verdadero, activa el búfer estéreo; en caso contrario, lo desactiva.

El búfer estéreo está desactivado por defecto.

El búfer estéreo proporciona búferes de color adicionales para generar imágenes del ojo izquierdo y del ojo derecho.

Véase también stereo().

void QSurfaceFormat::setSwapBehavior(QSurfaceFormat::SwapBehavior behavior)

Establece el intercambio behavior de la superficie.

El comportamiento de intercambio especifica si se desea un búfer simple, doble o triple. El valor predeterminado, DefaultSwapBehavior, proporciona el comportamiento de intercambio predeterminado de la plataforma.

Véase también swapBehavior().

void QSurfaceFormat::setSwapInterval(int interval)

Establece el intervalo de intercambio preferido. El intervalo de intercambio especifica el número mínimo de fotogramas de vídeo que se muestran antes de que se produzca un intercambio de búfer. Esto se puede utilizar para sincronizar el dibujo GL en una ventana con el refresco vertical de la pantalla.

Establecer un valor de 0 en interval desactivará la sincronización con el refresco vertical, cualquier valor superior a 0 activará la sincronización vertical. Establecer interval a un valor más alto, por ejemplo 10, resulta en tener 10 retrocesos verticales entre cada cambio de búfer.

El intervalo por defecto es 1.

Es posible que la plataforma no admita el cambio del intervalo de intercambio. En este caso, la petición será ignorada silenciosamente.

Véase también swapInterval().

void QSurfaceFormat::setVersion(int major, int minor)

Establece las versiones de OpenGL deseadas major y minor.

La versión por defecto es 2.0.

Véase también version().

int QSurfaceFormat::stencilBufferSize() const

Devuelve el tamaño del búfer del esténcil en bits.

Véase también setStencilBufferSize().

bool QSurfaceFormat::stereo() const

Devuelve true si el búfer estéreo está activado; en caso contrario, devuelve false. El búfer estéreo está desactivado por defecto.

Véase también setStereo().

QSurfaceFormat::SwapBehavior QSurfaceFormat::swapBehavior() const

Devuelve el comportamiento de intercambio configurado.

Véase también setSwapBehavior().

int QSurfaceFormat::swapInterval() const

Devuelve el intervalo de intercambio.

Véase también setSwapInterval().

bool QSurfaceFormat::testOption(QSurfaceFormat::FormatOption option) const

Devuelve true si la opción de formato option está activada; en caso contrario devuelve false.

Véase también options().

std::pair<int, int> QSurfaceFormat::version() const

Devuelve un par std::pair<int, int> que representa la versión de OpenGL.

Útil para comprobaciones de versión, por ejemplo format.version() >= std::pair(3, 2)

Véase también setVersion().

QSurfaceFormat &QSurfaceFormat::operator=(const QSurfaceFormat &other)

Asigna other a este objeto.