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 !