SgCreateColorChooser(3X) UNIX System V SgCreateColorChooser(3X)
NAME
SgCreateColorChooser - The ColorChooser widget creation
function
SYNOPSIS
#include <Sgm/ColorC.h>
Widget SgCreateColorChooser (parent, name, arglist, argcount)
Widget parent;
String name;
ArgList arglist;
Cardinal argcount;
VERSION
This page documents the version of Sgm that accompanies
Motif 1.2.
DESCRIPTION
SgCreateColorChooser creates an unmanaged ColorChooser.
ColorChooser is a dialog widget that provides a friendly and
powerful user interface for selecting colors. The
ColorChooser provides a color hexagon and color sliders that
present the color range in Hue, Saturation, Value, (HSV) and
Red, Green, Blue, (RGB) color spaces. Because of drawing
speed consideration, the color hexagon and color sliders are
available only if running under GL. For X-only
configuration, there are Scale widgets to replace the color
sliders and ther is no color hexagon. The ColorChooser
includes the following:
A menu for setting options for the color chooser.
⊕ A color hexagon that provides visual selection of the
Hue and Saturation components of a color in an Hue,
Saturation, Value, (HSV) color space.
⊕ Color slider for each of Hue, Saturation, Value, Red,
Green, Blue color components. The color sliders are
visible depening on the user color chooser menu
selection. Each of the color sliders and the color
hexagon is accompanied with a text edit widget to view
the exact value of the current color component and to
set its numerical value.
⊕ Two color swatches: one for showing the current
selected color and one for enabling the user to store a
second color for reference.
⊕ Three or four buttons
Page 1 (printed 4/30/98)
SgCreateColorChooser(3X) UNIX System V SgCreateColorChooser(3X)
The default button labels are OK, Cancel, and Help. By
default an Apply button is also created; if the parent of
the ColorChooser is a DialogShell it is managed, and
otherwise it is unmanaged. Additional work area children
may be added to the ColorChooser after creation.
parent Specifies the parent widget ID
name Specifies the name of the created widget
arglistSpecifies the argument list
argcount
Specifies the number of attribute/value pairs in the
argument list (arglist)
For a complete definition of ColorChooser and its associated
resources, see SgColorChooser(3X).
RETURN VALUE
Returns the ColorChooser widget ID.
RELATED INFORMATION
SgColorChooser(3X).
Page 2 (printed 4/30/98)