SgCreateColorChooserDialog(3X)

     NAME
          SgCreateColorChooserDialog - The ColorChooser
          ColorChooserDialog convenience creation function

     SYNOPSIS
          #include <Sgm/ColorC.h>

          Widget SgCreateColorChooserDialog (parent, name, arglist, argcount)
               Widget    parent;
               String    name;
               ArgList   arglist;
               Cardinal  argcount;


     VERSION
          This page documents the version of Sgm that accompanies
          Motif 2.1.

     DESCRIPTION
          SgCreateColorChooserDialog is a convenience creation
          function that creates a DialogShell and an unmanaged
          ColorChooser child of the DialogShell.  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 presents the color
          range in Hue, Saturation, Value, (HSV) and Red, Green, Blue,
          (RGB) color spaces.  Because of drawing speed considiration
          the color hexagon and color sliders are available only if
          running under GL. For X only configuration there are Scale
          widget 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.

            o  A color hexagon that provides visual selection of the
               Hue and Saturation components of a color in an Hue,
               Saturation, Value, (HSV) color space.

            o  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 it's numerical value.

            o  Two color swatches: one for showing the current
               selected color and one for enabling the user to atore a
               second color for reference.

            o  Four buttons
          The default button labels are OK, Cancel, Apply, and Help.
          One additional WorkArea child may be added to the
          ColorChooser after creation.

          SgCreateColorChooserDialog forces the value of the
          ColorChooser resource XmNdialogType to XmDIALOG_SELECTION.

          Use XtManageChild to pop up the ColorChooserDialog (passing
          the ColorChooser as the widget parameter); use
          XtUnmanageChild to pop it down.


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