glutCopyColormap(3)

glutCopyColormap3

Copies the logical colormap for the layer in use from a specified window to the current window.

Usage


    

    
        

void glutCopyColormap(int win);

Arguments

win

The identifier of the window to copy the logical colormap from.

Overview

glutCopyColormap copies (lazily if possible to promote sharing) the logical colormap from a specified window to the current window's layer in use. The copy will be from the normal plane to the normal plane; or from the overlay to the overlay (never across different layers). Once a colormap has been copied, avoid setting cells in the colormap with glutSetColor since that will force an actual copy of the colormap if it was previously copied by reference. glutCopyColormap should only be called when both the current window and the win window are color index windows.

Examples

Here is an example of how to create two color index GLUT windows with their colormaps loaded identically and so that the windows are likely to share the same colormap:


    

    
        

int win1, win2;

glutInitDisplayMode(GLUT_INDEX);
win1 = glutCreateWindow("first color index win");
glutSetColor(0, 0.0, 0.0, 0.0); /* black */
glutSetColor(1, 0.5, 0.5, 0.5); /* gray */
glutSetColor(2, 1.0, 1.0, 1.0); /* black */
glutSetColor(3, 1.0, 0.0, 0.0); /* red */
win2 = glutCreateWindow("second color index win");
glutCopyColormap(win1);

Author

Mark J. Kilgard ([email protected])

From freeglut 3.8.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.