QOpenGLBuffer Class

Documentation des fonctions membres

QOpenGLBuffer::QOpenGLBuffer()

Crée un nouvel objet tampon de type ` QOpenGLBuffer::VertexBuffer`.

Remarque : ce constructeur se contente de créer l'instance de QOpenGLBuffer. L'objet tampon proprement dit dans le serveur OpenGL n'est créé qu'au moment où la fonction create() est appelée.

Voir aussi ` create()`.

[explicit] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer::Type type)

Crée un nouvel objet tampon de type ` type`.

Remarque : ce constructeur se contente de créer l'instance de QOpenGLBuffer. L'objet tampon proprement dit dans le serveur OpenGL n'est créé qu'au moment de l'appel à create().

Voir aussi ` create()`.

QOpenGLBuffer::QOpenGLBuffer(const QOpenGLBuffer &other)

Crée une copie superficielle de ` other`.

Remarque : QOpenGLBuffer n'implémente pas la sémantique « copy-on-write » ; par conséquent, other sera affecté chaque fois que la copie sera modifiée.

[noexcept, since 6.5] QOpenGLBuffer::QOpenGLBuffer(QOpenGLBuffer &&other)

La fonction « move » construit un nouvel objet `QOpenGLBuffer` à partir de ` other`.

Cette fonction a été introduite dans Qt 6.5.

[noexcept] QOpenGLBuffer::~QOpenGLBuffer()

Supprime cet objet tampon, y compris l'espace mémoire utilisé dans le serveur OpenGL.

void QOpenGLBuffer::allocate(const void *data, int count)

Alloue count octets d'espace au tampon, initialisé avec le contenu de data. Tout contenu préexistant sera supprimé.

On suppose que la fonction create() a été appelée sur ce tampon et que celui-ci a été lié au contexte courant.

Voir également create(), read() et write().

void QOpenGLBuffer::allocate(int count)

Alloue count octets d'espace au tampon. Tout contenu préexistant sera supprimé.

On suppose que la fonction ` create()` a été appelée sur ce tampon et que celui-ci a été lié au contexte actuel.

Voir également ` create()` et ` write()`.

bool QOpenGLBuffer::bind()

Lie le tampon associé à cet objet au contexte OpenGL actuel. Renvoie ` false ` si la liaison n'a pas pu être établie, généralement parce que la fonction ` type()` n'est pas prise en charge par cette implémentation d'OpenGL.

Le tampon doit être lié au même QOpenGLContext que celui qui était actif au moment de l’appel de create(), ou à un autre QOpenGLContext qui le partage avec celui-ci. Sinon, cette fonction renvoie false.

Voir également release() et create().

GLuint QOpenGLBuffer::bufferId() const

Renvoie l'identifiant OpenGL associé à ce tampon ; zéro si le tampon n'a pas été créé.

Voir également isCreated().

bool QOpenGLBuffer::create()

Crée l'objet tampon dans le serveur OpenGL. Renvoie « true » si l'objet a été créé ; « false » dans le cas contraire.

Cette fonction doit être appelée avec un ` QOpenGLContext` actif. Le tampon sera lié à ce contexte et ne pourra être utilisé que dans celui-ci (ou dans tout autre contexte partagé avec celui-ci).

Cette fonction renvoie « false » si l’implémentation OpenGL ne prend pas en charge les tampons, ou s’il n’existe aucun objet « QOpenGLContext » actif.

Voir également isCreated(), allocate(), write() et destroy().

void QOpenGLBuffer::destroy()

Détruit cet objet tampon, y compris l'espace mémoire utilisé dans le serveur OpenGL. Toutes les références à ce tampon deviendront invalides.

bool QOpenGLBuffer::isCreated() const

Renvoie ` true ` si ce tampon a été créé ; `false` dans le cas contraire.

Voir également create() et destroy().

void *QOpenGLBuffer::map(QOpenGLBuffer::Access access)

Mappe le contenu de ce tampon dans l'espace mémoire de l'application et renvoie un pointeur vers celui-ci. Renvoie `null` si le mappage en mémoire n'est pas possible. Le paramètre ` access ` indique le type d'accès à effectuer.

On suppose que la fonction ` create()` a été appelée sur ce tampon et que celui-ci a été lié au contexte actuel.

Voir également unmap(), create(), bind() et mapRange().

void *QOpenGLBuffer::mapRange(int offset, int count, QOpenGLBuffer::RangeAccessFlags access)

Mappe la plage spécifiée par offset et count du contenu de ce tampon dans l'espace mémoire de l'application et renvoie un pointeur vers celle-ci. Renvoie null si le mappage en mémoire n'est pas possible. Le paramètre access spécifie une combinaison d'indicateurs d'accès.

On suppose que la fonction create() a été appelée sur ce tampon et que celui-ci a été lié au contexte actuel.

Voir également unmap(), create() et bind().

bool QOpenGLBuffer::read(int offset, void *data, int count)

Lit les octets de l'count s contenus dans ce tampon, en commençant à l'adresse offset, et les stocke dans data. Renvoie true en cas de succès ; false si la lecture à partir du tampon n'est pas prise en charge. La lecture à partir d'un tampon n'est pas prise en charge sous OpenGL/ES.

On suppose que ce tampon a été lié au contexte actuel.

Voir également write() et bind().

void QOpenGLBuffer::release()

Libère le tampon associé à cet objet du contexte OpenGL actuel.

Cette fonction doit être appelée avec le même paramètre « QOpenGLContext » que celui utilisé lors de l'appel de la fonction « bind()» sur le tampon.

Voir également bind().

[static] void QOpenGLBuffer::release(QOpenGLBuffer::Type type)

Libère le tampon associé à type dans l'QOpenGLContext.

Cette fonction est un appel direct à glBindBuffer(type, 0); elle est destinée à être utilisée lorsque l’appelant ne sait pas quelle QOpenGLBuffer a été liée au contexte, mais souhaite s’assurer qu’elle est libérée.

QOpenGLBuffer::release(QOpenGLBuffer::VertexBuffer);

void QOpenGLBuffer::setUsagePattern(QOpenGLBuffer::UsagePattern value)

Définit le modèle d'utilisation de cet objet tampon sur « value ». Cette fonction doit être appelée avant allocate() ou write().

Voir également usagePattern(), allocate() et write().

int QOpenGLBuffer::size() const

Renvoie la taille des données contenues dans ce tampon, pour les opérations de lecture. Renvoie -1 si la récupération de la taille du tampon n'est pas prise en charge ou si le tampon n'a pas été créé.

On suppose que ce tampon a été associé au contexte courant.

Voir également isCreated() et bind().

[noexcept, since 6.5] void QOpenGLBuffer::swap(QOpenGLBuffer &other)

Permute ce tampon avec celui de other. Cette opération est très rapide et ne rencontre jamais d'échec.

Cette fonction a été introduite dans Qt 6.5.

QOpenGLBuffer::Type QOpenGLBuffer::type() const

Renvoie le type du tampon représenté par cet objet.

bool QOpenGLBuffer::unmap()

Démappe le tampon après qu’il a été mappé dans l’espace mémoire de l’application à la suite d’un appel précédent à la fonction ` map()`. Renvoie ` true ` si le démappage a réussi ; `false` dans le cas contraire.

On suppose que ce tampon a été lié au contexte actuel et qu’il a été préalablement mappé à l’aide de la fonction ` map()`.

Voir également map().

QOpenGLBuffer::UsagePattern QOpenGLBuffer::usagePattern() const

Renvoie le modèle d'utilisation de cet objet tampon. La valeur par défaut est StaticDraw.

Voir aussi setUsagePattern().

void QOpenGLBuffer::write(int offset, const void *data, int count)

Remplace les count octets de ce tampon, à partir de l'adresse offset, par le contenu de data. Tous les autres octets du tampon resteront inchangés.

On suppose que la fonction ` create()` a été appelée sur ce tampon et que celui-ci a été associé au contexte courant.

Voir également create(), read() et allocate().

[noexcept, since 6.5] QOpenGLBuffer &QOpenGLBuffer::operator=(QOpenGLBuffer &&other)

Cette opération attribue other à cette instance de QOpenGLBuffer.

Cette fonction a été introduite dans Qt 6.5.

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

Attribue une copie superficielle de other à cet objet.

Remarque : ` QOpenGLBuffer ` n'implémente pas la sémantique « copy-on-write » ; par conséquent, ` other ` sera affecté dès que la copie sera modifiée.