DXmCreateColorMixDialog(3X) DXmCreateColorMixDialog(3X)
NAME
DXmCreateColorMixDialog - Creates a color mixing widget with a dialog box.
SYNOPSIS
Widget DXmCreateColorMixDialog(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount );
PARAMETERS
The identifier (widget ID) of the parent widget. The name of the created widget. The application argument list. The number of arguments
in the application argument list.
DESCRIPTION
DXmCreateColorMixDialog allows your DECwindows Motif applications to query users for a color. The color mixing widget provides users with
immediate feedback, displaying each new color as it is selected. This widget uses a pop-up dialog box (or nonpop-up dialog box if you use
the DXmCreateColorMix routine) that is preconfigured to contain the following subwidgets:
------------------------------------------------------------------------------
Subwidget Description
------------------------------------------------------------------------------
Scratch pad Stores intermediate colors for later use in
color mixing.
Color display subwidget Displays the original color and the new
color.
Color model option menu sub- Implements choice of color model.
widget
Color mixer subwidget Provides graphic tools users can use to
define new colors.
Push button subwidgets Activate color mixing widget functions.
Label subwidgets Provide descriptive information.
------------------------------------------------------------------------------
The color mixing widget allows a user to choose from up to five different color models: The default color model for the color mixing widget
on color systems (it does not display on non-color systems or on systems with too few resources).
The color picker consists of a"-color color spectrum and a color palette option menu, a color interpolator and its title, a smear
button, and undo button, two paint bucket buttons, and arrow buttons to control the warmth and lightness of interpolator colors. In
the HLS color model, a color is specified by three characteristics: hue, lightness, and saturation. Hue is color. Lightness
describes the intensity of the color (the amount of the color). Saturation describes the purity of the color or how much the color
is diluted by white.
To support the HLS color model, the color mixer subwidget contains three scales that represent the ranges of hue, lightness, and
saturation. The hue scale presents color values as a range between 0 and 360. The lightness and saturation scales present their val-
ues as a range of percentages between 0 and 100. The default color model for the color mixing widget on monochrome systems.
In the RGB color model, a color is specified as a mixture of different intensities of red, green, and blue. In the X Window System,
Version 11, you specify the intensity of red, green, or blue as a value between 0 and 65,535. Zero is the lowest intensity. Black
is defined as a zero-intensity value for all three colors; white is"0 percent intensity for all three colors.
To support the RGB color model, the color mixer subwidget contains three scales that represent the ranges of intensity of red,
green, and blue. Each scale presents these color values as a percentage between 0 and 100. In addition, the color mixer subwidget
contains text widgets in which users of your application can enter RGB values directly as text. The text widgets and the scales are
linked: a change in one effects a corresponding change in the other. A scrolled window that presents the user with a list of X11
named colors. Each button in the scrolled window shows the name of an X11 color. If enough resources are available, the background
is set to that color. (If the new color is not further modified by other color models, the X11 name of this color is also returned
to the application as part of the color mixing widget's callback structure.) You can use the scroll bar to scroll through this
color list. Clicking MB1 on a color in the list causes the color display subwidget to become filled with that color. The color
browser is available on all systems.
A complete list of all the X color values available to you is located on your system. To find it, type the following command: %
find / -name '*rgb*' -print A scale widget that allows generation of gray shades ranging from black to white. When the Greyscale
mixer is selected, the current new color is converted to an appropriate shade of gray, which can then be adjusted with the scale
widget. All shades of gray generated by this model are a mixture of equal portions of red, green, and blue, which means that they
appear identically on both color and gray scale systems.
The Greyscale mixer is available on all systems.
Note
When considering whether to use a pop-up or nonpop-up color mixing widget, the following conditions are in effect: The pop-up color
mixing widget (which you create with the DXmCreateColorMixDialog routine) allocates the necessary color cells each time it is mapped
and then releases them each time the widget is unmapped. The nonpop-up color mixing widget (which you create with the DXmCreateCol-
orMix routine) allocates the necessary color cells at creation time but does not release them until the widget is destroyed. As
such, if color resources are limited, your application should use the pop-up color mixing widget instead of the nonpop-up version.
Resource Information
You can set the following widget-specific resources in the arglist when using any combination of default or application-provided color dis-
play and color mixer subwidgets:
XmString DXmNclearLabel; XmString DXmNdisplayLabel; Widget DXmNdisplayWindow; XmString DXmNhelpLabel;
XmString DXmNmainLabel; XmString DXmNmixerLabel; Widget DXmNmixerWindow; unsigned short DXmNnewBlueValue; unsigned
short DXmNnewGreenValue; unsigned short DXmNnewRedValue; unsigned short DXmNorigBlueValue; unsigned short DXmNorigGreenValue; unsigned
short DXmNorigRedValue; XmString DXmNresetLabelString; XmString DXmNscratchPadInfoLabel; XmString DXmNscratchPadLa-
bel; void proc DXmNsetMixerColorProc; void proc DXmNsetNewColorProc; XtCallbackList XmNapplyCallback; XmString XmNap-
plyLabelString; XtCallbackList XmNcancelCallback; XmString XmNcancelLabelString; XtCallbackList XmNokCallback; XmString
XmNokLabelString; Widget XmNworkWindow;
You can set the following widget-specific resources in the arglist only when using the default color display subwidget:
unsigned short DXmNbackBlueValue; unsigned short DXmNbackGreenValue; unsigned short DXmNbackRedValue; Dimension DXmNdisplayColWin-
Height; Dimension DXmNdisplayColWinWidth; Dimension DXmNdispWinMargin; Boolean DXmNmatchColors;
You can set the following widget-specific resources in the arglist only when using the default color mixer subwidget:
XmString DXmNblackLabel; XmString DXmNblueLabel; short DXmNbrowserItemCount; XmString DXmNbrowserLabel;
unsigned char DXmNcolorModel; XmString DXmNcoolerLabel; XmString DXmNdarkerLabel; XmString DXmNearthtoneLabel;
XmString DXmNfullLabel; XmString DXmNgrayLabel; XmString DXmNgreenLabel; XmString DXmNgreyscaleLabel; Boolean
DXmNgreyscaleOnGreyscale; XmString DXmNhlsLabel; XmString DXmNhueLabel; short DXmNinterpTileCount; short
DXmNinterpTileHeight; short DXmNinterpTileWidth; XmString DXmNinterpTitleLabel; XmString DXmNlighterLabel; XmString
DXmNlightLabel; short DXmNlightnessIncrement; XmString DXmNoptionLabel; XmString DXmNpastelLabel; unsigned short
DXmNpickerColors; XmString DXmNpickerLabel; short DXmNpickerTileHeight; short DXmNpickerTileWidth; XmString
DXmNpickerTitleLabel; XmString DXmNredLabel; XmString DXmNrgbLabel; XmString DXmNsatLabel; XmString DXmNslider-
Label; XmString DXmNsmearLabel; XmString DXmNspectrumLabel; XmString DXmNundoLabel; XmString DXmNuserPaletteLa-
bel; XmString DXmNvalueLabel; XmString DXmNvividLabel; XmString DXmNwarmerLabel; unsigned short DXmNwarmthIncrement;
XmString DXmNwhiteLabel;
Resources
(Default or Application-Provided Color Display/Mixer Subwidgets) Specifies the text that appears as the label of the scratch pad clear push
button. The default text is "Clear". Access is CSG. Specifies the text that appears above the color display subwidget, centered between
the left and right borders. There is no default. Access is CSG. The color display subwidget. The default is the color mixing widget's
color display subwidget. Access is CSG.
Note the following: Setting this resource to Null at widget creation time prevents the color display subwidget from being displayed.
If an application substitutes its own color display subwidget for the default color display subwidget, the application is completely
responsible for managing the subwidget (making it visible and controlling its geometry management). An application can return to
the default color display subwidget by using the Intrinsic routine XtSetValues to set the DXmNdisplayWindow resource to Null. Spec-
ifies the text that appears inside the Help push button. The default text is "Help". Access is CSG. Specifies the text that
appears at the top of the color mixing widget, centered between the left and right borders. There is no default. Access is CSG.
Specifies the text that appears above the color mixer subwidget, centered between the left and right borders. There is no default.
Access is CSG. The color mixer subwidget. The default color mixer subwidget supports the Hue Lightness Saturation (HLS), Red,
Green, Blue (RGB), Color Picker, Browser, and Greyscale Mixer color models. Setting this resource to Null at widget creation time
prevents the color mixer subwidget from being displayed. Access is CSG.
Note the following: If an application substitutes its own color mixer subwidget for the default color mixer subwidget, the applica-
tion is completely responsible for managing the subwidget (making it visible and controlling its geometry management). An applica-
tion can later return to the default color mixer subwidget by using the Intrinsic routine XtSetValues to set the DXmNmixerWindow
resource to Null. Applications that use the default color mixer subwidget are not required to update the new color value. However,
applications that provide their own color mixer subwidget must update the new color value, by using either the Intrinsic routine
XtSetValues or the DXmColorMixSetNewColor routine (which is faster). The new blue color value for the color mixing widget. The
default is 0 unless DXmNmatchColors is True. If DXmNmatchColors is True, then DXmNnewBlueValue is always set by default to match
DXmNorigBlueValue whenever the widget is created or made visible. Access is CSG. The new green color value for the color mixing
widget. The default is 0 unless DXmNmatchColors is True. If DXmNmatchColors is True, then DXmNnewGreenValue is always set by
default to match DXmNorigGreenValue whenever the widget is created or made visible. Access is CSG. The new red color value for the
color mixing widget. The default is 0 unless DXmNmatchColors is True. If DXmNmatchColors is True, then DXmNnewRedValue is always
set by default to match DXmNorigRedValue whenever the widget is created or made visible. Access is CSG. The original blue color
value for the color mixing widget. The default is 0; however, applications should set the original blue value. Access is CSG. The
original green color value for the color mixing widget. The default is 0; however, applications should set the original green
value. Access is CSG. The original red color value for the color mixing widget. The default is 0; however, applications should
set the original red value. Access is CSG. Specifies the text that appears inside the Reset push button. The default is "Reset".
Access is CSG. Specifies the text that appears as the label centered at the top of the scratch pad pop-up. The default text is
"Save colors here...". Access is CSG. Specifies the text that appears as the label of the scratch pad push button. The default
text is "Scratch Pad...". Access is CSG. The resource used by the color mixing widget to update the current color mixer controls
when the application sets a new color. (It is intended for applications that use a non-default color mixer subwidget.) The default
is a procedure (specific to the color mixing widget) that updates the appropriate default color model (Picker, HLS, RGB, Browser, or
Greyscale). Access is CSG. The resource used by the color mixing widget to update the new color values displayed in the color dis-
play subwidget. If the application replaces the default color display subwidget and requires that the color mixing widget update
the new color, the application must set this resource. Otherwise, replacing the default color display subwidget sets this resource
to Null. Access is CSG.
If this resource is set and the application manages this subwidget, the work window is placed below the color display and color
mixer subwidgets (if present) and above the color mixing widget push buttons. Callback (or callbacks) made when the user clicks the
Apply push button widget in the color mixing widget. The reason for this callback is XmCR_APPLY. The default is Null. Access is
CSG. Specifies the text that appears inside the Apply push button. The default is "Apply". Access is CSG. Callback (or call-
backs) made when the user clicks the Cancel push button widget in the color mixing widget. The reason for this callback is
XmCR_CANCEL. The default is Null. Access is CSG. Specifies the text that appears inside the Cancel push button. The default is
"Cancel". Access is CSG. Callback (or callbacks) made when the user clicks the OK push button widget in the color mixing widget.
The reason for this callback is XmCR_ACTIVATE. The default is Null. Access is CSG. Specifies the text that appears inside the OK
push button. The default is "OK". Access is CSG. An optional work area subwidget. The default is Null. Access is CSG.
Resources
(Default Color Display Subwidget Only) The value of the default color display subwidget's blue background color. The default value is
32767 (gray). Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored. The value of the
default color display subwidget's green background color. The default value is 32767 (gray). Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored. The value of the
default color display subwidget's red background color. The default value is 32767 (gray). Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored. The height of the
original and new color display windows. The default is 80 pixels. Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored. The width of the
original and new color display windows. The default is 80 pixels. Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored. The margin between
the original and the new color display windows and the outsides edges of the color display subwidget. The margin is the area
affected by the background resources (set gray by default). The default width is 20 pixels. Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored. A Boolean resource
that specifies whether new color values are matched to original color values whenever the color mixing widget is created and made
visible. When True, new color values are matched to original color values. When False, new color values are not matched to origi-
nal color values. The default is True. Access is CSG.
This resource is valid only if the default color display subwidget is used; otherwise, the resource is ignored.
Resources
(Default Color Mixer Subwidget Only) Specifies the text that appears below the left end of the middle scale subwidget. The default is
"Black". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text that appears below the left end of the bottom scale subwidget. The default is "Blue". Access is CSG.
This resource is used in the RGB mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. The number
of visible items in the browser's color list. You can set this resource only at widget creation time. Each visible item requires
that the color mix widget allocate its own color cell. The default is 5. Access is CG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears as the fourth item in the color model option menu. The default text is "Browser". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The color model cur-
rently being used. The values for this resource are as follows:
----------------------------------------------------------
Color Model Value When Default
----------------------------------------------------------
Color Picker DXmColorModelPicker Color systems
HLS DXmColorModelHLS Not used as
default
RGB DXmColorModelRGB Monochrome sys-
tems
Browser DXmColorModelBrowser Not used as
default
Greyscale DXmColorModelGreyscale Gray scale sys-
tems
----------------------------------------------------------
Applications should set this resource before the widget is managed (if at all), and allow users to switch color models by using the
option menu. Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text of
the Cooler arrow button. The default text is "Cooler". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text of
the Darker arrow button. The default text is "Darker". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The label used to
represent the earthtones palette in the picker spectrum option menu. The default text is "Earthtones". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears below the right end of the bottom scale subwidget. The default is "Full". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text that appears below the left of the bottom scale subwidget. The default is "Gray". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text that appears below the left end of the middle scale subwidget. The default is "Green". Access is CSG.
This resource is used in the RGB mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text that appears as the bottom item in the color model option menu. The default text is "Grayscale". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. A Boolean resource
that, when True, specifies that the greyscale mixing color model is to be the default on greyscale systems. The default is True.
Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears as the second item in the color model option menu. The default is "HLS". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears to the left of the top scale subwidget. The default is "Hue:". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. The number
of interpolator tiles used. (The color mixing widget must allocate a color cell for each interpolator tile.) You can set this
resource only at widget creation time. The default is 10. Access is CG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The height of each
interpolator tile, in pixels. The default is 30. Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The width of each
interpolator tile, in pixels. The default is 30. Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears centered above the interpolator widget. The default text is "Interpolator". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text of
the Lighter arrow button. The default text is "Lighter". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears to the left of the bottom scale subwidget. The default is "Lightness:". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. The per-
centage by which to increase or decrease the lightness of the color of each interpolator tile when the lighter or darker buttons are
pressed. The default is 5. Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears inside the color model option menu subwidget. The default is "Color Model:". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The label used to
represent the pastels palette in the picker spectrum option menu. The default text is "Pastels". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. A palette of ten col-
ors that will be available through the user palette menu option. If not specified, no user palette will appear in the menu; other-
wise, the user palette will become the default picker palette. You can set this resource only at widget creation time. Access is
CG.
Note that the first item in the array is the red value of the first spectrum tile, the second item is its green value, the third
item is its blue value, the fourth item is the second tile's red value, and so on. Thus, this array must contain thirty elements if
it is set.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears as the top item in the color model option menu. The default text is "Picker". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The height of each
individual spectrum tile, in pixels. The default is 30. Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The width of each
individual spectrum tile, in pixels. The default is 30. Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears centered above the picker widget. The default text is "Spectrum". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears below the left end of the top scale subwidget. The default is "Red". Access is CSG.
This resource is used in the RGB mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text that appears as the third item in the color model option menu. The default is "RGB". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears to the left of the middle scale subwidget. The default is "Saturation:". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text that appears above the left end of the top scale subwidget. The default is "Percentage". Access is CSG.
This resource is used in the RGB mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies
the text of the Smear push button. The default text is "Smear". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The label used to
represent the "rainbow" palette in the picker spectrum option menu. The default text is "Spectrum". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text of
the Undo push button. The default text is "Undo". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The label used to
represent the application-defined user palette in the spectrum option menu. The default text is "User palette". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears above the column of text subwidgets. The default is "Value". Access is CSG.
This resource is used in the RGB mixer if the default color mixer subwidget is used; otherwise, the resource is ignored. The label
used to represent the vivids palette in the picker spectrum option menu. The default text is "Vivids". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text of
the Warmer arrow button. The default text is "Warmer". Access is CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. The amount of red or
blue added to the color of each interpolator tile when the warmer or cooler buttons are pressed. The default is 5000. Access is
CSG.
This resource is valid only if the default color mixer subwidget is used; otherwise, the resource is ignored. Specifies the text
that appears below the right end of the middle scale subwidget. The default is "White". Access is CSG.
This resource is used in the HLS mixer if the default color mixer subwidget is used; otherwise, the resource is ignored.
Resource Information
The following resources inherited from XmBulletinBoard are supported differently: The default for XmNdialogStyle is XmDIALOG_MODELESS. The
default for XmNdialogTitle is "Color Mixing". The default for XmNresizePolicy is XmRESIZE_NONE.
Resource Information
typedef struct {
int reason;
XEvent *event;
unsigned short newred;
unsigned short newgrn;
unsigned short newblu;
char *newname;
unsigned short origred;
unsigned short origgrn;
unsigned short origblu*L; } DXmColorMixCallbackStruct;
Callback Field Descriptions
An integer set to the callback reason. See the Callback Reasons section for the values that are valid for this widget. A pointer to the X
event structure describing the event that generated this callback. The new red color value for the color mixing widget. The new green
color value for the color mixing widget. The new blue color value for the color mixing widget. Passes a color name to an application. If
the user selects a named color from the Browser and then triggers a callback to the application without modifying the new color, the new-
name field of the callback data structure is filled in with a pointer to an ASCII, null-terminated string that contains the color's X11
name. This string is read-only, and should not be freed or modified.
If a color is generated in one of the other color models, or generated in the browser and subsequently modified, the newname field
in the callback structure is set to Null. The original red color value for the color mixing widget. The original green color value
for the color mixing widget. The original blue color value for the color mixing widget.
Callback Reasons
The user has activated the OK push button. The user has activated the Apply push button. The user has activated the Cancel push button.
Resource Information
The color mixing widget completely controls the layout of its children.
Resizing
The color mixing widget computes the smallest possible size required to enclose all of its children, including any of the variably sized
color mixing subwidgets. The size remains fixed while the user selects different color models from the option menu.
Inherited Resources
DXmCreateColorMixDialog inherits behaviour and resources from the following superclasses:
Core Resource Set Composite Resource Set Constraint Resource Set XmManager Resource Set XmBulletinBoard Resource Set
RETURN VALUES
The identifier (widget ID) of the created color mixing widget.
SEE ALSO
DXmCreateColorMix(3X), DXmColorMixGetNewColor(3X), DXmColorMixSetNewColor(3X)
DXmCreateColorMixDialog(3X)