QSurfaceFormat Class

Dokumentation der Mitgliedsfunktionen

QSurfaceFormat::QSurfaceFormat()

Konstruiert ein standardmäßig initialisiertes QSurfaceFormat.

QSurfaceFormat::QSurfaceFormat(QSurfaceFormat::FormatOptions options)

Konstruiert ein QSurfaceFormat mit dem angegebenen Format options.

QSurfaceFormat::QSurfaceFormat(const QSurfaceFormat &other)

Konstruiert 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, ist dies eine standardmäßig konstruierte QSurfaceFormat.

Siehe auch setDefaultFormat().

int QSurfaceFormat::depthBufferSize() const

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

Siehe auch setDepthBufferSize().

int QSurfaceFormat::greenBufferSize() const

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

Siehe auch setGreenBufferSize().

bool QSurfaceFormat::hasAlpha() const

Gibt true zurück, wenn die Größe des Alphapuffers größer als Null ist.

Dies bedeutet, dass die Oberfläche mit Transluzenzeffekten pro Pixel verwendet werden kann.

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 kleinere OpenGL-Version zurück.

Siehe auch setMinorVersion().

QSurfaceFormat::FormatOptions QSurfaceFormat::options() const

Gibt die aktuell eingestellten Formatoptionen zurück.

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

QSurfaceFormat::OpenGLContextProfile QSurfaceFormat::profile() const

Holt das konfigurierte OpenGL-Kontextprofil.

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

Siehe auch setProfile().

int QSurfaceFormat::redBufferSize() const

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

Siehe auch setRedBufferSize().

QSurfaceFormat::RenderableType QSurfaceFormat::renderableType() const

Ruft den Rendering-Typ ab.

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

Siehe auch setRenderableType().

int QSurfaceFormat::samples() const

Gibt die Anzahl der Samples 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)

Stellen Sie die gewünschte size in Bits des Alphakanals des Farbpuffers ein.

Siehe auch alphaBufferSize().

void QSurfaceFormat::setBlueBufferSize(int size)

Stellen Sie die gewünschte size in Bits des blauen Kanals des Farbpuffers ein.

Siehe auch blueBufferSize().

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

Legt die bevorzugte colorSpace fest.

Dies ermöglicht zum Beispiel die Anforderung von Fenstern mit Standard-Framebuffern, die sRGB-fähig sind, auf Plattformen, die dies unterstützen.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch colorSpace().

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

Legt die globale Standardoberfläche format fest.

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

Es kann jederzeit für jede einzelne Instanz mit der Funktion setFormat() der betreffenden Klasse überschrieben werden. Oft ist es jedoch bequemer, das Format für alle Fenster einmal beim Start der Anwendung zu setzen. Es garantiert auch ein korrektes Verhalten in Fällen, in denen gemeinsame Kontexte benötigt werden, da das Setzen des Formats über diese Funktion garantiert, dass alle Kontexte und Oberflächen, auch die von Qt intern erstellten, das gleiche Format verwenden.

Siehe auch defaultFormat().

void QSurfaceFormat::setDepthBufferSize(int size)

Setzen Sie die Mindestgröße des Tiefenpuffers auf size.

Siehe auch depthBufferSize().

void QSurfaceFormat::setGreenBufferSize(int size)

Stellen Sie die gewünschte size in Bits des grünen Kanals des Farbpuffers ein.

Siehe auch greenBufferSize().

void QSurfaceFormat::setMajorVersion(int major)

Legt die gewünschte major OpenGL-Version fest.

Siehe auch majorVersion().

void QSurfaceFormat::setMinorVersion(int minor)

Legt die gewünschte minor OpenGL-Version 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 gelöscht.

Um zu überprüfen, ob eine Option beachtet wurde, vergleichen Sie das tatsächliche Format mit dem angeforderten Format nach der Oberflächen-/Kontexterstellung.

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

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

Setzt die Formatoptionen auf options.

Um zu überprüfen, ob eine Option beachtet wurde, vergleichen Sie das tatsächliche Format mit dem angeforderten Format nach der Oberflächen-/Kontexterstellung.

Siehe auch options() und testOption().

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

Setzt den gewünschten OpenGL-Kontext profile.

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

Siehe auch profile().

void QSurfaceFormat::setRedBufferSize(int size)

Stellen Sie die gewünschte size in Bits des Rotkanals des Farbpuffers ein.

Siehe auch redBufferSize().

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

Legt das gewünschte Rendering fest type.

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

Siehe auch renderableType().

void QSurfaceFormat::setSamples(int numSamples)

Setzen Sie die bevorzugte Anzahl von Abtastungen pro Pixel bei aktiviertem Multisampling auf numSamples. Standardmäßig ist das Multisampling deaktiviert.

Siehe auch samples().

void QSurfaceFormat::setStencilBufferSize(int size)

Setzen Sie die bevorzugte Schablonenpuffergröße auf size bits.

Siehe auch stencilBufferSize().

void QSurfaceFormat::setStereo(bool enable)

Wenn enable true ist, wird die Stereopufferung aktiviert; andernfalls wird sie deaktiviert.

Die Stereopufferung ist standardmäßig deaktiviert.

Die Stereopufferung bietet zusätzliche Farbpuffer, um Bilder für das linke und das rechte Auge zu erzeugen.

Siehe auch stereo().

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

Legen Sie das Tauschverhalten behavior der Oberfläche fest.

Das Swap-Verhalten gibt an, ob Einfach-, Doppel- oder Dreifachpufferung gewünscht ist. Die Voreinstellung DefaultSwapBehavior gibt das Standard-Swap-Verhalten der Plattform vor.

Siehe auch swapBehavior().

void QSurfaceFormat::setSwapInterval(int interval)

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

Ein interval Wert von 0 schaltet die vertikale Synchronisierung aus, ein Wert über 0 schaltet die vertikale Synchronisierung ein. Wenn Sie interval auf einen höheren Wert, z. B. 10, einstellen, werden zwischen jedem Pufferwechsel 10 vertikale Wiederholungen durchgeführt.

Das Standardintervall ist 1.

Das Ändern des Intervalls für den Pufferwechsel wird von der zugrunde liegenden Plattform möglicherweise nicht unterstützt. In diesem Fall wird die Anfrage 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 Schablonenpuffers in Bits zurück.

Siehe auch setStencilBufferSize().

bool QSurfaceFormat::stereo() const

Gibt true zurück, wenn die Stereopufferung aktiviert ist; andernfalls wird false zurückgegeben. Die Stereopufferung 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 Tauschintervall zurück.

Siehe auch setSwapInterval().

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

Gibt true zurück, wenn die Formatoption option gesetzt ist; andernfalls wird false zurückgegeben.

Siehe auch options().

QPair<int, int> QSurfaceFormat::version() const

Gibt eine QPair<int, int> zurück, die die OpenGL-Version darstellt.

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

Siehe auch setVersion().

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

Weist diesem Objekt other zu.