


DXmCreateColorMixDialog(3X)			  DXmCreateColorMixDialog(3X)



NAME
  DDXXmmCCrreeaatteeCCoolloorrMMiixxDDiiaalloogg - Creates a color mixing widget with a dialog	box.

SYNOPSIS

  WWiiddggeett DDXXmmCCrreeaatteeCCoolloorrMMiixxDDiiaalloogg((_p_a_r_e_n_t,, _n_a_m_e,, _a_r_g_l_i_s_t,,	_a_r_g_c_o_u_n_t))
	  WWiiddggeett    _p_a_r_e_n_t;;
	  SSttrriinngg    _n_a_m_e;;
	  AArrggLLiisstt   _a_r_g_l_i_s_t;;
	  CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;

PARAMETERS

  _p_a_r_e_n_t
      The identifier (widget ID) of the	parent widget.

  _n_a_m_e
      The name of the created widget.

  _a_r_g_l_i_s_t
      The application argument list.

  _a_r_g_c_o_u_n_t
      The number of arguments in the application argument list.

DESCRIPTION

  DDXXmmCCrreeaatteeCCoolloorrMMiixxDDiiaalloogg 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 DDXXmmCCrreeaatteeCCoolloorrMMiixx
  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 subwidget

				      Implements choice	of color
				      model.

  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 infor-
				      mation.

  ______________________________________________________________

  The color mixing widget allows a user	to choose from up to five different
  color	models:

  CCoolloorr	PPiicckkeerr
      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 but-
      ton, and undo button, two	paint bucket buttons, and arrow	buttons	to
      control the warmth and lightness of interpolator colors.

  HHLLSS ((HHuuee,, LLiigghhttnneessss,, SSaattuurraattiioonn))
      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 satura-
      tion.  The hue scale presents color values as a range between 0 and
      360.  The	lightness and saturation scales	present	their values as	a
      range of percentages between 0 and 100.

  RRGGBB ((RReedd,, GGrreeeenn,, BBlluuee))
      The default color	model for the color mixing widget on monochrome	sys-
      tems.

      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.

  BBrroowwsseerr ((XX1111 nnaammeedd ccoolloorrss))
      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:


	   %% ffiinndd // --nnaammee ''**rrggbb**'' --pprriinntt

  GGrreeyyssccaallee MMiixxeerr
      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 sys-
      tems.

      The Greyscale mixer is available on all systems.

      NOTE:  When considering whether to use a pop-up or nonpop-up color mix-
      ing widget, the following	conditions are in effect:

	oo++
	The pop-up color mixing	widget (which you create with the
	DDXXmmCCrreeaatteeCCoolloorrMMiixxDDiiaalloogg	routine) allocates the necessary color cells
	each time it is	mapped and then	releases them each time	the widget is
	unmapped.

	oo++
	The nonpop-up color mixing widget (which you create with the
	DDXXmmCCrreeaatteeCCoolloorrMMiixx routine) allocates the necessary color cells at
	creation time but does not release them	until the widget is des-
	troyed.	 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 _a_r_g_l_i_s_t when
  using	any combination	of default or application-provided color display 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	       DXmNscratchPadLabel;
       void proc       DXmNsetMixerColorProc;
       void proc       DXmNsetNewColorProc;
       XtCallbackList  XmNapplyCallback;
       XmString	       XmNapplyLabelString;
       XtCallbackList  XmNcancelCallback;
       XmString	       XmNcancelLabelString;
       XtCallbackList  XmNokCallback;
       XmString	       XmNokLabelString;
       Widget	       XmNworkWindow;

  You can set the following widget-specific resources in the _a_r_g_l_i_s_t only
  when using the default color display subwidget:

       unsigned	short  DXmNbackBlueValue;
       unsigned	short  DXmNbackGreenValue;
       unsigned	short  DXmNbackRedValue;
       Dimension       DXmNdisplayColWinHeight;
       Dimension       DXmNdisplayColWinWidth;
       Dimension       DXmNdispWinMargin;
       Boolean	       DXmNmatchColors;

  You can set the following widget-specific resources in the _a_r_g_l_i_s_t 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	       DXmNsliderLabel;
       XmString	       DXmNsmearLabel;
       XmString	       DXmNspectrumLabel;
       XmString	       DXmNundoLabel;
       XmString	       DXmNuserPaletteLabel;
       XmString	       DXmNvalueLabel;
       XmString	       DXmNvividLabel;
       XmString	       DXmNwarmerLabel;
       unsigned	short  DXmNwarmthIncrement;
       XmString	       DXmNwhiteLabel;

  Resources

  (Default or Application-Provided Color Display/Mixer Subwidgets)

  DDXXmmNNcclleeaarrLLaabbeell
      Specifies	the text that appears as the label of the scratch pad clear
      push button.  The	default	text is	"Clear".  Access is CSG.

  DDXXmmNNddiissppllaayyLLaabbeell
      Specifies	the text that appears above the	color display subwidget, cen-
      tered between the	left and right borders.	 There is no default.  Access
      is CSG.

  DDXXmmNNddiissppllaayyWWiinnddooww
      The color	display	subwidget.  The	default	is the color mixing widget's
      color display subwidget.	Access is CSG.

      Note the following:

	oo++
	Setting	this resource to Null at widget	creation time prevents the
	color display subwidget	from being displayed.

	oo++
	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 con-
	trolling its geometry management).  An application can return to the
	default	color display subwidget	by using the Intrinsic routine XXttSSeett--
	VVaalluueess to set the DDXXmmNNddiissppllaayyWWiinnddooww resource to	Null.

  DDXXmmNNhheellppLLaabbeell
      Specifies	the text that appears inside the Help push button.  The
      default text is "Help".  Access is CSG.

  DDXXmmNNmmaaiinnLLaabbeell
      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.

  DDXXmmNNmmiixxeerrLLaabbeell
      Specifies	the text that appears above the	color mixer subwidget, cen-
      tered between the	left and right borders.	 There is no default.  Access
      is CSG.

  DDXXmmNNmmiixxeerrWWiinnddooww
      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:

	oo++
	If an application substitutes its own color mixer subwidget for	the
	default	color mixer subwidget, the application is completely respon-
	sible for managing the subwidget (making it visible and	controlling
	its geometry management).  An application can later return to the
	default	color mixer subwidget by using the Intrinsic routine XXttSSeett--
	VVaalluueess to set the DDXXmmNNmmiixxeerrWWiinnddooww resource to Null.

	oo++
	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 XXttSSeettVVaalluueess or the
	DDXXmmCCoolloorrMMiixxSSeettNNeewwCCoolloorr routine (which is faster).

  DDXXmmNNnneewwBBlluueeVVaalluuee
      The new blue color value for the color mixing widget.  The default is 0
      unless DDXXmmNNmmaattcchhCCoolloorrss is	True.  If DDXXmmNNmmaattcchhCCoolloorrss is True, then
      DDXXmmNNnneewwBBlluueeVVaalluuee is always set by	default	to match DDXXmmNNoorriiggBBlluueeVVaalluuee
      whenever the widget is created or	made visible.  Access is CSG.

  DDXXmmNNnneewwGGrreeeennVVaalluuee
      The new green color value	for the	color mixing widget.  The default is
      0	unless DDXXmmNNmmaattcchhCCoolloorrss is True.	 If DDXXmmNNmmaattcchhCCoolloorrss is True, then
      DDXXmmNNnneewwGGrreeeennVVaalluuee	is always set by default to match DDXXmmNNoorriiggGGrreeeennVVaalluuee
      whenever the widget is created or	made visible.  Access is CSG.

  DDXXmmNNnneewwRReeddVVaalluuee
      The new red color	value for the color mixing widget.  The	default	is 0
      unless DDXXmmNNmmaattcchhCCoolloorrss is	True.  If DDXXmmNNmmaattcchhCCoolloorrss is True, then
      DDXXmmNNnneewwRReeddVVaalluuee is always	set by default to match	DDXXmmNNoorriiggRReeddVVaalluuee
      whenever the widget is created or	made visible.  Access is CSG.

  DDXXmmNNoorriiggBBlluueeVVaalluuee
      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.

  DDXXmmNNoorriiggGGrreeeennVVaalluuee
      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.

  DDXXmmNNoorriiggRReeddVVaalluuee
      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.

  DDXXmmNNrreesseettLLaabbeellSSttrriinngg
      Specifies	the text that appears inside the Reset push button.  The
      default is "Reset".  Access is CSG.

  DDXXmmNNssccrraattcchhPPaaddIInnffooLLaabbeell
      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.

  DDXXmmNNssccrraattcchhPPaaddLLaabbeell
      Specifies	the text that appears as the label of the scratch pad push
      button.  The default text	is "Scratch Pad...".  Access is	CSG.

  DDXXmmNNsseettMMiixxeerrCCoolloorrPPrroocc
      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.

  DDXXmmNNsseettNNeewwCCoolloorrPPrroocc
      The resource used	by the color mixing widget to update the new color
      values displayed in the color display 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 subwidg-
      ets (if present) and above the color mixing widget push buttons.

  XXmmNNaappppllyyCCaallllbbaacckk
      Callback (or callbacks) made when	the user clicks	the Apply push button
      widget in	the color mixing widget.  The reason for this callback is
      XXmmCCRR__AAPPPPLLYY.  The default is Null.	 Access	is CSG.

  XXmmNNaappppllyyLLaabbeellSSttrriinngg
      Specifies	the text that appears inside the Apply push button.  The
      default is "Apply".  Access is CSG.

  XXmmNNccaanncceellCCaallllbbaacckk
      Callback (or callbacks) made when	the user clicks	the Cancel push	but-
      ton widget in the	color mixing widget.  The reason for this callback is
      XXmmCCRR__CCAANNCCEELL.  The	default	is Null.  Access is CSG.

  XXmmNNccaanncceellLLaabbeellSSttrriinngg
      Specifies	the text that appears inside the Cancel	push button.  The
      default is "Cancel".  Access is CSG.

  XXmmNNookkCCaallllbbaacckk
      Callback (or callbacks) made when	the user clicks	the OK push button
      widget in	the color mixing widget.  The reason for this callback is
      XXmmCCRR__AACCTTIIVVAATTEE.  The default is Null. Access is CSG.

  XXmmNNookkLLaabbeellSSttrriinngg
      Specifies	the text that appears inside the OK push button.  The default
      is "OK".	Access is CSG.

  XXmmNNwwoorrkkWWiinnddooww
      An optional work area subwidget.	The default is Null.  Access is	CSG.

  Resources

  (Default Color Display Subwidget Only)

  DDXXmmNNbbaacckkBBlluueeVVaalluuee
      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.

  DDXXmmNNbbaacckkGGrreeeennVVaalluuee
      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.

  DDXXmmNNbbaacckkRReeddVVaalluuee
      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.

  DDXXmmNNddiissppllaayyCCoollWWiinnHHeeiigghhtt
      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.

  DDXXmmNNddiissppllaayyCCoollWWiinnWWiiddtthh
      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.

  DDXXmmNNddiissppWWiinnMMaarrggiinn
      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.

  DDXXmmNNmmaattcchhCCoolloorrss
      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 original
      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)

  DDXXmmNNbbllaacckkLLaabbeell
      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.

  DDXXmmNNbblluueeLLaabbeell
      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.

  DDXXmmNNbbrroowwsseerrIItteemmCCoouunntt
      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.

  DDXXmmNNbbrroowwsseerrLLaabbeell
      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.

  DDXXmmNNccoolloorrMMooddeell
      The color	model currently	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 systems

      Browser	     DXmColorModelBrowser

					      Not used as default

      Greyscale	     DXmColorModelGreyscale

					      Gray scale systems

      ___________________________________________________________

      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.

  DDXXmmNNccoooolleerrLLaabbeell
      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.

  DDXXmmNNddaarrkkeerrLLaabbeell
      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.

  DDXXmmNNeeaarrtthhttoonneeLLaabbeell
      The label	used to	represent the earthtones palette in the	picker spec-
      trum 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.

  DDXXmmNNffuullllLLaabbeell
      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.

  DDXXmmNNggrraayyLLaabbeell
      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.

  DDXXmmNNggrreeeennLLaabbeell
      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.

  DDXXmmNNggrreeyyssccaalleeLLaabbeell
      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.

  DDXXmmNNggrreeyyssccaalleeOOnnGGrreeyyssccaallee
      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.

  DDXXmmNNhhllssLLaabbeell
      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.

  DDXXmmNNhhuueeLLaabbeell
      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.

  DDXXmmNNiinntteerrppTTiilleeCCoouunntt
      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.

  DDXXmmNNiinntteerrppTTiilleeHHeeiigghhtt
      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.

  DDXXmmNNiinntteerrppTTiilleeWWiiddtthh
      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.

  DDXXmmNNiinntteerrppTTiittlleeLLaabbeell
      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.

  DDXXmmNNlliigghhtteerrLLaabbeell
      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.

  DDXXmmNNlliigghhttLLaabbeell
      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.

  DDXXmmNNlliigghhttnneessssIInnccrreemmeenntt
      The percentage 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.

  DDXXmmNNooppttiioonnLLaabbeell
      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.

  DDXXmmNNppaasstteellLLaabbeell
      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.

  DDXXmmNNppiicckkeerrCCoolloorrss
      A	palette	of ten colors that will	be available through the user palette
      menu option.  If not specified, no user palette will appear in the
      menu; otherwise, 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.

  DDXXmmNNppiicckkeerrLLaabbeell
      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.

  DDXXmmNNppiicckkeerrTTiilleeHHeeiigghhtt
      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.

  DDXXmmNNppiicckkeerrTTiilleeWWiiddtthh
      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.

  DDXXmmNNppiicckkeerrTTiittlleeLLaabbeell
      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.

  DDXXmmNNrreeddLLaabbeell
      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.

  DDXXmmNNrrggbbLLaabbeell
      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.

  DDXXmmNNssaattLLaabbeell
      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.

  DDXXmmNNsslliiddeerrLLaabbeell
      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.

  DDXXmmNNssmmeeaarrLLaabbeell
      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.

  DDXXmmNNssppeeccttrruummLLaabbeell
      The label	used to	represent the "rainbow"	palette	in the picker spec-
      trum 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.

  DDXXmmNNuunnddooLLaabbeell
      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.

  DDXXmmNNuusseerrPPaalleetttteeLLaabbeell
      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.

  DDXXmmNNvvaalluueeLLaabbeell
      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.

  DDXXmmNNvviivviiddLLaabbeell
      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.

  DDXXmmNNwwaarrmmeerrLLaabbeell
      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.

  DDXXmmNNwwaarrmmtthhIInnccrreemmeenntt
      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.

  DDXXmmNNwwhhiitteeLLaabbeell
      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 XXmmBBuulllleettiinnBBooaarrdd are supported dif-
  ferently:

    oo++  The default for XXmmNNddiiaallooggSSttyyllee is _X_m_D_I_A_L_O_G__M_O_D_E_L_E_S_S.

    oo++  The default for XXmmNNddiiaallooggTTiittllee is "Color	Mixing".

    oo++  The default for XXmmNNrreessiizzeePPoolliiccyy is _X_m_R_E_S_I_Z_E__N_O_N_E.

  Resource Information


       ttyyppeeddeeff ssttrruucctt
       {{
	     iinntt	     _r_e_a_s_o_n;;
	     XXEEvveenntt	     **_e_v_e_n_t;;
	     uunnssiiggnneedd sshhoorrtt  _n_e_w_r_e_d;;
	     uunnssiiggnneedd sshhoorrtt  _n_e_w_g_r_n;;
	     uunnssiiggnneedd sshhoorrtt  _n_e_w_b_l_u;;
	     cchhaarr	     **_n_e_w_n_a_m_e;;
	     uunnssiiggnneedd sshhoorrtt  _o_r_i_g_r_e_d;;
	     uunnssiiggnneedd sshhoorrtt  _o_r_i_g_g_r_n;;
	     uunnssiiggnneedd sshhoorrtt  _o_r_i_g_b_l_u*_L;
       } _D_X_m_C_o_l_o_r_M_i_x_C_a_l_l_b_a_c_k_S_t_r_u_c_t;

  CCaallllbbaacckk FFiieelldd DDeessccrriippttiioonnss

  _r_e_a_s_o_n
       An integer set to the callback reason. See the Callback Reasons sec-
       tion for	the values that	are valid for this widget.

  _e_v_e_n_t
       A pointer to the	X event	structure describing the event that generated
       this callback.

  _n_e_w_r_e_d
       The new red color value for the color mixing widget.

  _n_e_w_g_r_n
       The new green color value for the color mixing widget.

  _n_e_w_b_l_u
       The new blue color value	for the	color mixing widget.

  _n_e_w_n_a_m_e
       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 _n_e_w_n_a_m_e 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 _n_e_w_n_a_m_e field in the
       callback	structure is set to Null.

  _o_r_i_g_r_e_d
       The original red	color value for	the color mixing widget.

  _o_r_i_g_g_r_n
       The original green color	value for the color mixing widget.

  _o_r_i_g_b_l_u
       The original blue color value for the color mixing widget.

  Callback Reasons


  XXmmCCRR__AACCTTIIVVAATTEE
      The user has activated the OK push button.

  XXmmCCRR__AAPPPPLLYY
      The user has activated the Apply push button.

  XXmmCCRR__CCAANNCCEELL
      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 mix-
  ing subwidgets. The size remains fixed while the user	selects	different
  color	models from the	option menu.

  Inherited Resources

  DDXXmmCCrreeaatteeCCoolloorrMMiixxDDiiaalloogg 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.

RELATED	INFORMATION

  DDXXmmCCrreeaatteeCCoolloorrMMiixx(3X), DDXXmmCCoolloorrMMiixxGGeettNNeewwCCoolloorr(3X),
  DDXXmmCCoolloorrMMiixxSSeettNNeewwCCoolloorr(3X)









