"Fossies" - the Fresh Open Source Software Archive

Member "dx-4.4.4/help/dxall792" (5 Feb 2002, 13217 Bytes) of package /linux/misc/old/dx-4.4.4.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 #!F-adobe-helvetica-medium-r-normal--18*
    2 #!N 
    3 #!N 
    4  #!Rcolor Color #!N #!N Category #!N #!N  #!Lcattrn,dxall763 h Transformation  #!EL  #!N #!N Function 
    5 #!N #!N Colors a field. #!N #!N Syntax #!CForestGreen #!N #!N 
    6  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N colored #!EF = Color(  #!F-adobe-times-bold-r-normal--18*   input, color, opacity, 
    7 component, delayed #!EF ); #!EF #!N #!N #!EC #!N #!N Inputs 
    8 #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Default TAB 
    9 Description #!EF #!N TAB input TAB field TAB none TAB field 
   10 to be colored #!N TAB color TAB field or vector or 
   11 string TAB no color added TAB RGB color #!N TAB opacity 
   12 TAB field or scalar TAB input dependent TAB opacity #!N TAB 
   13 component TAB string TAB "colors" TAB component to be colored #!N 
   14 TAB delayed TAB flag TAB 0 TAB 0: apply maps #!N 
   15 TAB - TAB - TAB - TAB 1: delay applying color 
   16 and #!N TAB - TAB - TAB - TAB opacity maps 
   17 (byte data #!N TAB - TAB - TAB - TAB only) 
   18 #!N TAB - TAB - TAB - TAB #!EF #!N #!N 
   19 Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB Description 
   20 #!EF #!N TAB colored TAB color field TAB color-mapped input field 
   21 #!N TAB - TAB - TAB #!EF #!N #!N Functional Details 
   22 #!N #!N This module adds a specified color to a specified 
   23 input object. #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   input 
   24 #!EF #!EF #!I50 #!N is the field to be colored. #!N 
   25 #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   color #!EF #!EF #!I50 #!N specifies how 
   26 the input field is to be colored. The specification can be 
   27 the vector value of an RGB color, a string, or a 
   28 color map. #!N #!N If  #!F-adobe-times-bold-r-normal--18*   color #!EF is an RGB 
   29 color, the value should be in the range of 0-1 (but 
   30 see  #!Lcvolrnd,dxall820 h Coloring Objects for Volume Rendering  #!EL  ). The Convert module can convert HSV (hue, saturation, 
   31 and value) colors to RGB. #!N #!N If  #!F-adobe-times-bold-r-normal--18*   color #!EF 
   32 is a string, that string should come from a lookup table, 
   33 which can be specified by setting the DXCOLORS environment variable or 
   34 by using the -colors flag with the dx command. If no 
   35 table is specified, Data Explorer will search (in the order shown) 
   36 for one of the following: #!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N 
   37 #!I30 #!N 1. the file colors.txt in DXROOT/lib #!N #!I30 #!N 
   38 2. the same file in  #!F-adobe-times-bold-r-normal--18*   /usr/lpp/dx/lib #!EF (if this was 
   39 not the setting for DXROOT). Note that the colors in this 
   40 file correspond to the X Window System** color list, except that 
   41 the Data Explorer colors are squared first (see  #!Lintcols,dxall747 h Data Explorer Colors  #!EL  in IBM 
   42 Visualization Data Explorer User's Guide). #!N #!I0 #!N #!EF #!N When 
   43 entering the names of colors, note that the module: #!N #!I0 
   44 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N #!I30 #!N o accepts spaces in names. 
   45 #!N #!I30 #!N o ignores capitalization. #!N #!I30 #!N o accepts 
   46 the spellings  #!F-adobe-times-medium-i-normal--18*   gray #!EF and  #!F-adobe-times-medium-i-normal--18*   grey #!EF . #!N 
   47 #!I0 #!N #!EF #!N #!N #!N If  #!F-adobe-times-bold-r-normal--18*   color #!EF is 
   48 a color map it can be the output of the Colormap 
   49 Editor (the first output) or an imported color map. Note also 
   50 that if this parameter is a color map (as opposed to 
   51 a single color), then the  #!F-adobe-times-bold-r-normal--18*   input #!EF parameter must contain 
   52 a "data" component; if the "data" component consists of vector data, 
   53 the color and opacity mapping are based on the magnitude of 
   54 the data. If this parameter is an imported .cm file (see 
   55  #!Limport,dxall871 h Import  #!EL  ), the color-map part of the color-opacity map is extracted 
   56 and used. #!N #!N Omitting the color specification allows you to 
   57 change the opacity of an object without modifying its color (see 
   58  #!Lwfcmap,dxall792 s WFCMAP  #!EL  for a description of a color map). #!N #!N A 
   59 well-formed color map should contain a 1-dimensional "positions"  #!Rwfcmap component and 
   60 a 3-dimensional "data" component. As with any map in Data Explorer, 
   61 the "positions" component represents the domain in which to look up 
   62 values, and the "data" component represents the range, that is, the 
   63 values which are associated with items in the "positions" component. #!N 
   64 #!N Color maps can specify either smoothly varying colors or constant 
   65 colors across a set of ranges of data values. If the 
   66 color map has position-dependent data, then linear interpolation will be used 
   67 to derive colors for data values in the data field between 
   68 those given in the "positions" component of the map (see  #!Lcolmap114,dxall792 f Figure 114  #!EL  
   69 ). #!Cbrown #!N  #!F-adobe-times-medium-r-normal--18*    #!Rcolmap114 #!N Figure 114. Position-dependent colormaps. In 
   70 this figure a diagram of a data field is shown. One 
   71 of the data values, 3.5, has been indicated. The field structure 
   72 is also shown, with "positions," "data," and "connections" components. When a 
   73 color map is applied to this field using the Color module, 
   74 the data value 3.5 is used as a lookup value into 
   75 the "positions" component of the color map. The color map has 
   76 a "data" component which is dependent on (in a one-to-one correspondence 
   77 with) the "positions" component. The color map contains colors for the 
   78 value 3 (the RGB value [0 1 1], or cyan) and 
   79 for the value 4 (the RGB value [0 0 0], or 
   80 black). Data Explorer interpolates between these two colors to derive the 
   81 color [0 .5 .5], or dark cyan, which is then placed 
   82 in the "colors" component of the data field as the color 
   83 corresponding to the data value 3.5. #!N Graphics omitted from Online 
   84 Documentation. Please see the manual. #!N #!EF #!N #!EC If the 
   85 colormap has connection-dependent data, then the color for any data value 
   86 in the data field between two values in the "positions" component 
   87 of the map will be constant (see  #!Lcolmap1115,dxall792 f Figure 115  #!EL  ). #!Cbrown #!N 
   88  #!F-adobe-times-medium-r-normal--18*    #!Rcolmap1115 #!N Figure 115. Connection-dependent colormaps. In this figure a 
   89 diagram of a data field is shown. One of the data 
   90 values, 3.5, has been indicated. The field structure is also shown, 
   91 with "positions," "data," and "connections" components. When a color map is 
   92 applied to this field using the Color module, the data value 
   93 3.5 is used as a lookup value into the "positions" component 
   94 of the color map. The color map has a "data" component 
   95 which is dependent on (in a one-to-one correspondence with) the "connections" 
   96 component. The color map contains colors for the range 1 to 
   97 1.5 (the RGB value [1 1 0], or yellow), the range 
   98 1.5 to 3 (the RGB value [0 1 1], or cyan) 
   99 and for the range 3 to 4 (the RGB value [0 
  100 0 1], or blue). Since 3.5 lies in the range 3 
  101 to 4, Data Explorer looks up the color [0 0 1] 
  102 and places it in the "colors" component of the data field 
  103 as the color corresponding to the data value 3.5. #!N Graphics 
  104 omitted from Online Documentation. Please see the manual. #!N #!EF #!N 
  105 #!EC In either case, the "connections" component of the map should 
  106 be a set of lines connecting the positions. #!N #!N The 
  107 Colormap Editor puts out a well-formed colormap. The Construct module can 
  108 also be used to create a color map. For example, you 
  109 have 10 data values to which you want to apply particular 
  110 colors. List those 10 data values as the first parameter to 
  111 Construct. Then list the 10 colors (RGB vectors) as the last 
  112 parameter to Construct. This will automatically create a position-dependent color map 
  113 of the appropriate structure to use with the Color module. Alternatively, 
  114 if you list only 9 colors (RGB vectors) as the last 
  115 parameter to Construct, a connection-dependent color map will be created. #!N 
  116 #!N For surfaces, RGB colors in a color map should range 
  117 between 0 and 1. Compute can be used to convert colors 
  118 from the range of 0 to 255 to the range 0 
  119 to 1. To choose appropriate colors for volumes see  #!Lcvolrnd,dxall820 h Coloring Objects for Volume Rendering  #!EL  . 
  120 Note that if you have an HSV (hue, saturation, and value) 
  121 color map, it can be converted to an RGB (red, blue, 
  122 green) color map using the Convert module. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   
  123  #!F-adobe-times-bold-r-normal--18*   opacity #!EF #!EF #!I50 #!N can be a scalar value 
  124 or a field specifying an opacity map. This map may be 
  125 the output of the Colormap Editor (the second output) or an 
  126 imported opacity map. If it is an imported .cm file (see 
  127  #!Limport,dxall871 h Import  #!EL  ), the opacity part of the color-opacity map will be 
  128 extracted and used (see below for a description of an opacity 
  129 map). #!N #!N The input color or opacity can also be 
  130 groups of color or of opacity maps, as long as the 
  131 hierarchy of the group matches that of  #!F-adobe-times-bold-r-normal--18*   input #!EF . 
  132 #!N #!N For surfaces, the default value of  #!F-adobe-times-bold-r-normal--18*   opacity #!EF 
  133 is 1.0; the valid range is 0-1. For volumes, the default 
  134 value is 0.5. If the object to be colored is a 
  135 volume with an aspect ratio much different from 1, it may 
  136 appear dark from certain viewing directions. In that case, use the 
  137 Compute module to multiply the contents of the data component of 
  138 the opacity and color maps by a scale factor greater than 
  139 1 before using them as an input to the Color module. 
  140 (If you are using delayed colors, modify the "color multiplier" and 
  141 "opacity multiplier" attributes. See the  #!F-adobe-times-bold-r-normal--18*   delayed #!EF parameter, described below.) 
  142 #!N #!N A well-formed opacity map should contain a 1-dimensional "positions" 
  143 component and a 1-dimensional "data" component representing opacities. For surfaces, valid 
  144 opacities range between 0 (transparent) and 1 (opaque). To choose appropriate 
  145 opacities for volumes see  #!Lcvolrnd,dxall820 h Coloring Objects for Volume Rendering  #!EL  . Just as with a color 
  146 map, the "data" component may be either position-dependent or connection-dependent. An 
  147 opacity map can be created either with the Colormap Editor or 
  148 using the Construct module as described for color maps. #!N #!I0 
  149 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   component #!EF #!EF #!I50 #!N specifies the component 
  150 to which the module adds colors. The default is the "colors" 
  151 component, which applies to both the front and the back of 
  152 the object, but you can specify "front colors" or "back colors" 
  153 instead. Either one, if present, takes precedence over the "colors" component. 
  154 If you specify  #!F-adobe-times-bold-r-normal--18*   component #!EF as "colors," the module deletes 
  155 any existing "front colors" or "back colors" components. Which faces are 
  156 "front" and which faces are "back" depends on how "connections" component 
  157 of the faces is defined (see  #!Lstancom,dxall201 h Standard Components  #!EL  in IBM Visualization Data 
  158 Explorer User's Guide). #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   delayed #!EF #!EF 
  159 #!I50 #!N causes Color to create "delayed colors." This option is 
  160 valid only for byte data. When  #!F-adobe-times-bold-r-normal--18*   delayed #!EF = 1: 
  161 #!N #!I0 #!N  #!F-adobe-times-medium-r-normal--18*   #!N #!N #!I30 #!N o the "colors" 
  162 component is a copy of the "data" component, and a "color 
  163 map" component is created (i.e., a color lookup table with 256 
  164 entries representing the appropriate color for each of the 256 possible 
  165 data values). #!N #!I30 #!N o (if  #!F-adobe-times-bold-r-normal--18*   opacity #!EF has 
  166 been specified) the "opacities" component is a copy of the "data" 
  167 component, and an opacity map with 256 entries is created. #!N 
  168 #!I30 #!N o the module adds a "direct color map" attribute 
  169 to the output object (see  #!Ludcmps,dxall813 h Using Direct Color Maps  #!EL  ). #!N #!I0 #!N #!EF 
  170 #!N #!I0 #!N #!N #!N #!N Components #!N #!N Adds a 
  171 "colors" component. An "opacities" component is added if  #!F-adobe-times-bold-r-normal--18*   opacity #!EF 
  172 is less than 1 or the input data is a volume. 
  173 If  #!F-adobe-times-bold-r-normal--18*   delayed #!EF = 1, the "colors" component is a 
  174 copy of the "data" component and a "color map" component is 
  175 created. Likewise, an "opacity map" component is created if  #!F-adobe-times-bold-r-normal--18*   opacity 
  176 #!EF is less than one or the input is a volume. 
  177 #!N #!N Example Visual Programs #!N #!N Nearly every example visual 
  178 program uses Color, including: #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N AlternateVisualizations.net #!N 
  179 Sealevel.net #!N UsingColormaps.net #!N SIMPLE/Color #!EF #!N #!N #!EC #!N #!N 
  180 See Also #!N #!N  #!Lautocol,dxall772 h AutoColor  #!EL  ,  #!Lcaption,dxall781 h Caption  #!EL  ,  #!Lconvert,dxall799 h Convert  #!EL  ,  #!Lmap,dxall891 h Map  #!EL  
  181 #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Lcolorba,dxall793 h ColorBar  #!EL  #!N 
  182  #!F-adobe-times-medium-i-normal--18*   #!N