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  se-
     lecting 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  fol-
     lowing:

     A menu for setting options for the color chooser.

       *  A  color hexagon that provides visual selection of the Hue and Satura-
          tion 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


     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 chil-
     dren 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).

                                                        SgCreateColorChooser(3X)