Creates a simplecolor bar that can be used to view and interactively shift a color table.
(optional) The widget or shell ID of the parent widget (long). If parent is not specified, WgCbarTool runs on its own (i.e., in its own event loop).movedCallback
(optional) A string containing the name of the callback routine that is executed when the color bar is shifted to the left or right.range
(optional) The range of colors to be displayed in the color bar. The default is to display the entire range of colors, as defined in the system variable !D.Table_Size.
(optional) The ID of the newly created widget. If the procedure fails, zero (0) is returned.windowid
(optional) The window ID of the graphics window. (For information on window IDs, see the description for the WINDOW procedure.)
The index of the color table to load when the widget is created; a positive integer in the range (0...15).Horizontal
If present and nonzero, the color bar is oriented horizontally (see Figure 2-147). (Default: vertical orientation)
Popup
If present and nonzero, the color bar widget is displayed in its own Main window. A two-element vector specifying the x- and y-coordinates of the upper-left corner of the CbarTool window (long integer). The elements of the vector are [x, y], where x (horizontal) and y (vertical) are specified in pixels. These coordinates are either: 1) if parent is present and the Popup keyword is not specified or has a value of zero, measured from the upper-left corner of a layout (container) widget or 2) if the Popup keyword is present and nonzero (regardless of whether parent is present and/or nonzero), measured from the upper-left corner of the screen. A two-element vector specifying the width and height of the color bar (long integer). If not specified, the default size of the color bar is 30-by-256 pixels. A string containing the title that appears in the header of the CbarTool window. Default value is "Color Bar". If present and nonzero, the color bar is oriented vertically. This is the default orientation.
Background
Specifies the background color name. Specifies the base color. Specifies the name of the font used for text. Specifies the foreground color name.
Bottom
If a widget ID is specified (for example, Bottom=wid), then the bottom of the color bar widget is attached to the top of the specified widget. If no widget ID is specified (for example, /Bottom), then the bottom of the color bar widget is attached to the bottom of the parent widget. If a widget ID is specified (for example, Left=wid), then the left side of the color bar widget is attached to the right side of the specified widget. If no widget ID is specified (for example, /Left), then the left side of the color bar widget is attached to the left side of the parent widget. If a widget ID is specified (for example, Right=wid), then the right side of the color bar widget is attached to the left side of the specified widget. If no widget ID is specified (for example, /Right), then the right side of the color bar widget is attached to the right side of the parent widget. If a widget ID is specified (for example, Top=wid), then the top of the color bar widget is attached to the bottom of the specified widget. If no widget ID is specified (for example, /Top), then the top of the color bar widget is attached to the top of the parent widget.
NOTE: Use the window manager menu of the window frame to dismiss the CbarTool window from the screen.
Figure 2-147 WgCbarTool creates an array of colors that match the colors in the current color table. This color bar widget has been created using the Horizontal option; the default is for the color bar to be displayed in a vertical orientation.
Figure 2-148 WgCbarTool creates an array of colors that match the colors in the current color table. This color bar widget has been created using the Horizontal option; the default is for the color bar to be displayed in a vertical orientation.
prompt Enter the procedure name at the WAVE prompt to display the color bar widget. The color bar widget handles its own event loop by calling WwLoop.
If the Popup keyword is present and nonzero, the color bar widget has its own Main window. The application (not the color bar widget) handles the event loop by calling WwLoop.
Another application combines the color bar widget with other widgets inside a layout widget. The application (not the color bar widget) handles the event loop by calling WwLoop.
You can use the output parameter windowid to keep track of the PV-WAVE window ID that is assigned to the color bar. You can create multiple instances of the color bar; each one will be assigned a different PV-WAVE window ID.
Colors common block.Most color table procedures maintain the current color table in a common block called
Colors, defined as follows:
COMMON Colors, r_orig, g_orig, b_orig, r_curr, g_curr, b_curr
r_curr, g_curr, and b_curr.
parent is defined, WgCbarTool is created as a child of parent; otherwise, WgCbarTool runs on its own (i.e., in its own event loop).When you are finished interacting with the WgCbarTool window, close it using the window manager menu.
PRO Sample_wgcbartool, parent, tool_shell IF N_ELEMENTS(parent) NE 0 THEN BEGIN WgCbarTool, parent, tool_shell, /Horizontal, /Popup
ENDIF ELSE BEGIN WgCbarTool, /Horizontal
ENDELSE END
For more information about color table indices, refer to Experimenting with Different Color Tables in Chapter 11 of the PV-WAVE User's Guide.
For more information about how to write an application program based on WAVE Widgets, refer to Chapter 5, Using WAVE Widgets, in the PV-WAVE GUI Application Developer's Guide. For more information about how to write an application program based on the PV-WAVE Widget Toolbox, refer to Chapter 6, Using the Widget Toolbox, in the PV-WAVE GUI Application Developer's Guide.
