QGLColormap

La classe QGLColormap est utilisée pour la mise en place de palettes de couleurs personnalisées dans un QGLWidget. Plus d'informations...

#include <QGLColormap>

Voir la position dans l'arbre des classes.

Description détaillée

La classe QGLColormap est utilisée pour la mise en place de palettes de couleurs personnalisées dans un QGLWidget.

QGLColormap fournit une méthode indépendante aux plateformes pour la spécification et la mise en place de palettes de couleurs indexées dans un QGLWidget. QGLColormap est particulièrement utile lors de l'utilisation du mode de couleurs indexées d'OpenGL.

Sous X11 on doit utiliser un serveur X qui prend en charge une classe visuelle PseudoColor ou DirectColor. Si le serveur X fournit uniquement un visuel GrayScale, TrueColor, StaticColor ou StaticGray, on ne va pas pouvoir allouer des cellules de couleurs pour des opérations d'écriture. Si c'est le cas, il faut essayer de définir le serveur X dans un mode 8-bit. Il devrait alors fournir au moins un visuel PseudoColor. À noter que l'on peut avoir des flashs de palettes de couleurs si le serveur X fonctionne dans le mode 8-bit.

La taille size() de la palette de couleurs est toujours définie à 256 couleurs. À noter que sous Windows on peut aussi mettre en place des palettes de couleurs dans les widgets enfants.

Cette classe utilise le partage implicite pour optimiser la mémoire et la vitesse.

Exemple d'utilisation :

 #include <QApplication>
 #include <QGLColormap>
 
 int main()
 {
     QApplication app(argc, argv);
 
     MySuperGLWidget widget;     // un QGLWidget dans le mode indexé
     QGLColormap colormap;
 
     // Cela va remplir la palette de couleurs avec des couleurs du
     // blanc au noir.
     for (int i = 0; i < colormap.size(); i++)
         colormap.setEntry(i, qRgb(i, i, i));
 
     widget.setColormap(colormap);
     widget.show();
     return app.exec();
 }

Voir aussi QGLWidget::setColormap() et QGLWidget::colormap().

Fonctions membres

QGLColormap::QGLColormap ()

Construit un QGLColormap.

QGLColormap::QGLColormap ( const QGLColormap & map )

Construit une copie superficielle de map.

QGLColormap::~QGLColormap ()

Déréférence le QGLColormap et le supprime si c'était la dernière référence.

QColor QGLColormap::entryColor ( int idx ) const

Retourne la valeur QRgb de la cellule ayant comme index idx.

QRgb QGLColormap::entryRgb ( int idx ) const

Retourne la valeur QRgb de la cellule ayant comme index idx.

int QGLColormap::find ( QRgb color ) const

Retourne l'index de la couleur color. Si color n'est pas dans la palette, -1 est retourné.

int QGLColormap::findNearest ( QRgb color ) const

Retourne l'index de la couleur qui est la plus proche de la couleur color.

bool QGLColormap::isEmpty () const

Retourne true si la palette de couleurs est vide ou non utilisée par un QGLWidget ; sinon retourne false.

Une palette de couleurs sans valeur de couleurs est considérée comme vide. Pour des raisons historiques, une palette de couleurs qui possède des valeurs de couleurs mais qui n'est pas utilisée par un QGLWidget est aussi considérée vide.

Compare la taille size() avec zéro pour savoir si la palette de couleurs est vide sans se préoccuper de savoir si elle est utilisée par un QGLWidget ou non.

Voir aussi size().

void QGLColormap::setEntries ( int count, const QRgb * colors, int base = 0 )

Définit un tableau de cellules dans cette palette de couleurs. count est le nombre de couleurs qui devra être défini, colors est le tableau de couleurs et base est le premier index. Le premier élément dans colors est défini à base dans la palette de couleurs.

void QGLColormap::setEntry ( int idx, QRgb color )

Définit la cellule à l'index idx dans la palette de couleurs à la couleur color.

void QGLColormap::setEntry ( int idx, const QColor & color )

Il s'agit d'une fonction surchargée.

Définit la cellule avec l'index idx dans la palette de couleurs à la couleur color.

int QGLColormap::size () const

Retourne le nombre de cellules de couleurs dans la palette de couleurs.

QGLColormap & QGLColormap::operator= ( const QGLColormap & map )

Assigne une copie superficielle de map à ce QGLColormap.

Remerciements

Merci à Alexandre Laurent pour la traduction ainsi qu'à Lo?c Leguay, Jonathan Courtois et Claude Leloup pour leur relecture !