QSurfaceFormat Class

Dokumentation der Mitgliedsfunktionen

QSurfaceFormat::QSurfaceFormat()

Erstellt ein standardmäßig initialisiertes QSurfaceFormat.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

Erstellt ein `QSurfaceFormat` mit dem angegebenen Format options.

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

Erstellt eine Kopie von „ other “.

[noexcept] QSurfaceFormat::~QSurfaceFormat()

Zerstört die „ QSurfaceFormat “.

int QSurfaceFormat::alphaBufferSize() const

Ermittelt die Größe des Alphakanals des Farbpuffers in Bits.

Siehe auch setAlphaBufferSize().

int QSurfaceFormat::blueBufferSize() const

Ermittelt die Größe des blauen Kanals des Farbpuffers in Bits.

Siehe auch setBlueBufferSize().

const QColorSpace &QSurfaceFormat::colorSpace() const

Gibt den Farbraum zurück.

Siehe auch ` setColorSpace()`.

[static] QSurfaceFormat QSurfaceFormat::defaultFormat()

Gibt das globale Standard-Oberflächenformat zurück.

Wenn ` setDefaultFormat()` nicht aufgerufen wird, handelt es sich um ein standardmäßig konstruiertes ` QSurfaceFormat`.

Siehe auch ` setDefaultFormat()`.

int QSurfaceFormat::depthBufferSize() const

Gibt die Größe des Tiefenpuffers zurück.

Siehe auch „ setDepthBufferSize()“.

int QSurfaceFormat::greenBufferSize() const

Ruft die Größe des Grünkanals des Farbpuffers in Bits ab.

Siehe auch setGreenBufferSize().

bool QSurfaceFormat::hasAlpha() const

Gibt „ true “ zurück, wenn die Größe des Alpha-Puffers größer als null ist.

Das bedeutet, dass die Oberfläche möglicherweise mit pixelbezogenen Transluzenzeffekten verwendet wird.

int QSurfaceFormat::majorVersion() const

Gibt die Hauptversion von OpenGL zurück.

Die Standardversion ist 2.0.

Siehe auch ` setMajorVersion()`.

int QSurfaceFormat::minorVersion() const

Gibt die OpenGL-Nebenversion zurück.

Siehe auch „ setMinorVersion()“.

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

Gibt die aktuell eingestellten Formatierungsoptionen zurück.

Siehe auch setOption(), setOptions() und testOption().

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

Ruft das konfigurierte OpenGL-Kontextprofil ab.

Diese Einstellung wird ignoriert, wenn die angeforderte OpenGL-Version niedriger als 3.2 ist.

Siehe auch setProfile().

int QSurfaceFormat::redBufferSize() const

Ruft die Größe des roten Kanals des Farbpuffers in Bits ab.

Siehe auch setRedBufferSize().

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

Ruft den darstellbaren Typ ab.

Wählt zwischen Desktop-OpenGL, OpenGL ES und „ OpenVG “ aus.

Siehe auch ` setRenderableType()`.

int QSurfaceFormat::samples() const

Gibt die Anzahl der Abtastwerte pro Pixel zurück, wenn Multisampling aktiviert ist, oder „ -1 “, wenn Multisampling deaktiviert ist. Der Standardrückgabewert ist „ -1 “.

Siehe auch setSamples().

void QSurfaceFormat::setAlphaBufferSize(int size)

Legen Sie die gewünschte „ size “ in Bits des Alphakanals des Farbpuffers fest.

Siehe auch alphaBufferSize().

void QSurfaceFormat::setBlueBufferSize(int size)

Legen Sie den gewünschten Wert für „ size “ in Bits im blauen Kanal des Farbpuffers fest.

Siehe auch blueBufferSize().

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

Legt den bevorzugten „ colorSpace “ fest.

Dies ermöglicht es beispielsweise, auf Plattformen, die dies unterstützen, Fenster mit sRGB-fähigen Standard-Framebuffern anzufordern.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch ` colorSpace()`.

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

Legt die globale Standard-Oberflächen format fest.

Dieses Format wird standardmäßig in den Klassen ` QOpenGLContext`, ` QWindow`, ` QOpenGLWidget ` und ähnlichen Klassen verwendet.

Es kann jederzeit instanzspezifisch überschrieben werden, indem die setFormat()-Funktion der jeweiligen Klasse verwendet wird. Oft ist es jedoch praktischer, das Format für alle Fenster einmalig zu Beginn der Anwendung festzulegen. Dies gewährleistet zudem ein korrektes Verhalten in Fällen, in denen gemeinsam genutzte Kontexte erforderlich sind, da die Festlegung des Formats über diese Funktion sicherstellt, dass alle Kontexte und Oberflächen – auch die von Qt intern erstellten – dasselbe Format verwenden.

Siehe auch ` defaultFormat()`.

void QSurfaceFormat::setDepthBufferSize(int size)

Stellen Sie die minimale Größe des Tiefenpuffers auf size ein.

Siehe auch depthBufferSize().

void QSurfaceFormat::setGreenBufferSize(int size)

Legen Sie den gewünschten Wert für „ size “ in Bits im grünen Kanal des Farbpuffers fest.

Siehe auch greenBufferSize().

void QSurfaceFormat::setMajorVersion(int major)

Legt die gewünschte OpenGL-Version von „ major “ fest.

Siehe auch majorVersion().

void QSurfaceFormat::setMinorVersion(int minor)

Legt die gewünschte OpenGL-Version von „ minor “ fest.

Die Standardversion ist 2.0.

Siehe auch minorVersion().

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

Setzt die Formatoption „ option “, wenn „ on “ wahr ist; andernfalls wird die Option zurückgesetzt.

Um zu überprüfen, ob eine Option berücksichtigt wurde, vergleichen Sie nach der Erstellung der Oberfläche/des Kontexts das tatsächliche Format mit dem angeforderten Format.

Siehe auch ` setOptions()`, ` options()` und ` testOption()`.

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

Legt die Formatoptionen auf „ options “ fest.

Um zu überprüfen, ob eine Option berücksichtigt wurde, vergleichen Sie das tatsächliche Format nach der Erstellung der Oberfläche/des Kontexts mit dem angeforderten Format.

Siehe auch ` options()` und ` testOption()`.

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

Legt den gewünschten OpenGL-Kontext fest profile.

Diese Einstellung wird ignoriert, wenn die angeforderte OpenGL-Version niedriger als 3.2 ist.

Siehe auch profile().

void QSurfaceFormat::setRedBufferSize(int size)

Legen Sie den gewünschten Wert für „ size “ in den Bits des Rotkanals des Farbpuffers fest.

Siehe auch redBufferSize().

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

Legt den gewünschten darstellbaren „ type “ fest.

Wählt zwischen Desktop-OpenGL, OpenGL ES und OpenVG.

Siehe auch ` renderableType()`.

void QSurfaceFormat::setSamples(int numSamples)

Legen Sie die gewünschte Anzahl von Abtastwerten pro Pixel fest, wenn Multisampling aktiviert ist: numSamples. Standardmäßig ist Multisampling deaktiviert.

Siehe auch „ samples()“.

void QSurfaceFormat::setStencilBufferSize(int size)

Legen Sie die bevorzugte Größe des Stencil-Puffers auf size Bits fest.

Siehe auch stencilBufferSize().

void QSurfaceFormat::setStereo(bool enable)

Wenn „ enable “ auf „true“ gesetzt ist, wird die Stereo-Pufferung aktiviert; andernfalls wird sie deaktiviert.

Die Stereo-Pufferung ist standardmäßig deaktiviert.

Die Stereo-Pufferung stellt zusätzliche Farbpuffer zur Erzeugung von Bildern für das linke und das rechte Auge bereit.

Siehe auch stereo().

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

Legt das Swap- behavior der Oberfläche fest.

Das Swap-Verhalten legt fest, ob Einzel-, Doppel- oder Dreifach-Buffering gewünscht ist. Die Standardeinstellung „ DefaultSwapBehavior “ verwendet das Standard-Swap-Verhalten der Plattform.

Siehe auch swapBehavior().

void QSurfaceFormat::setSwapInterval(int interval)

Legt das bevorzugte Swap-Intervall fest. Das Swap-Intervall gibt die Mindestanzahl an Videobildern an, die angezeigt werden, bevor ein Pufferwechsel stattfindet. Dies kann verwendet werden, um die GL-Zeichnung in einem Fenster mit der vertikalen Bildwiederholfrequenz des Bildschirms zu synchronisieren.

Wird der Wert „ interval “ auf 0 gesetzt, wird die vertikale Synchronisation deaktiviert; jeder Wert größer als 0 aktiviert die vertikale Synchronisation. Wird „ interval “ auf einen höheren Wert gesetzt, beispielsweise 10, führt dies dazu, dass zwischen jedem Puffertausch 10 vertikale Rückläufe stattfinden.

Das Standardintervall beträgt 1.

Das Ändern des Austauschintervalls wird von der zugrunde liegenden Plattform möglicherweise nicht unterstützt. In diesem Fall wird die Anforderung stillschweigend ignoriert.

Siehe auch ` swapInterval()`.

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

Legt die gewünschten OpenGL-Versionen „ major “ und „ minor “ fest.

Die Standardversion ist 2.0.

Siehe auch version().

int QSurfaceFormat::stencilBufferSize() const

Gibt die Größe des Stencil-Puffers in Bit zurück.

Siehe auch „ setStencilBufferSize()“.

bool QSurfaceFormat::stereo() const

Gibt „ true “ zurück, wenn die Stereo-Pufferung aktiviert ist; andernfalls wird „false“ zurückgegeben. Die Stereo-Pufferung ist standardmäßig deaktiviert.

Siehe auch setStereo().

QSurfaceFormat::SwapBehavior QSurfaceFormat::swapBehavior() const

Gibt das konfigurierte Swap-Verhalten zurück.

Siehe auch ` setSwapBehavior()`.

int QSurfaceFormat::swapInterval() const

Gibt das Swap-Intervall zurück.

Siehe auch „ setSwapInterval()“.

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

Gibt „true“ zurück, wenn die Formatoption „ option “ gesetzt ist; andernfalls gibt sie „false“ zurück.

Siehe auch ` options()`.

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

Gibt ein std::pair<int, int> zurück, das die OpenGL-Version angibt.

Nützlich für Versionsprüfungen, zum Beispiel format.version() >= std::pair(3, 2)

Siehe auch ` setVersion()`.

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

Weist diesem Objekt „ other “ zu.