chips> chips_color_value( "red" )
  6
  chips> _chips->red
  6
	

Here we find the symbolic value for the color "red". Since we have ignored the return value ChIPS prints it out to the screen (see the 'Using ChIPS and Sherpa as a calculator' section of "ahelp tips").

  chips> chips_color_value( "green" )
  4
  chips> chips_color_value( "GREEN" )
  4
  chips> chips_color_value( "GrEEn" )
  4
	

The case of the color name is unimportant, as shown here.

  chips> chips_color_value( "UnknownColor" )
  3
  chips> chips_color_value( "default" )
  3
	

If a color is unknown, then the value for the default color is returned.

  chips> chips.curvecolor = chips_color_value( "red" );
	

Here we set the curvecolor attribute of the ChIPS state object (see "ahelp chips") to be red. Since curvecolor must be specified using the symbolic value for the color red, we use chips_color_value() to do the conversion. The following line of code can also be used to set the curvecolor attribute to red:

  chips> chips.curvecolor = _chips->red;