1#!F-adobe-helvetica-medium-r-normal--18*
2#!N
3#!N
4 #!Roptions Options #!N #!N Category #!N #!N  #!Lcatstr,dxall762 h Structuring  #!EL  #!N #!N Function
5#!N #!N Associates one or more attributes with a specified object.
6#!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N output #!EF
7= Options(  #!F-adobe-times-bold-r-normal--18*   input, attribute, value, ... #!EF ); #!EF #!N
8#!N #!EC #!N #!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name
9TAB Type TAB Default TAB Description #!EF #!N TAB input TAB
10object TAB none TAB object whose attributes are to be #!N
11TAB - TAB - TAB - TAB set #!N TAB attribute
12TAB string TAB no default TAB attribute to be added #!N
13TAB value TAB value or string or object TAB no default
14TAB value of the attribute #!N TAB ... TAB - TAB
15- TAB additional attribute-value pair(s) #!N TAB - TAB - TAB
16- TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB
17Name TAB Type TAB Description #!EF #!N TAB output TAB object
18TAB the object with attributes added #!N TAB - TAB -
19TAB #!EF #!N #!N Functional Details #!N #!N This module associates
20attributes with an object. (Attributes can be extracted from an object
21with the Attribute module.) Attributes are used by some modules to
22determine the behavior of a particular input object. For example, you
23can add attributes to objects to tell the Plot module how
24to draw markers on particular lines (see  #!Lattrib21,dxall898 t Table 21  #!EL  and  #!Lplot,dxall904 h Plot  #!EL  ).
25While there is a set of attributes which Data Explorer modules
26understand, you can also add your own attributes to objects, to
27be interpreted by user-written modules. #!N #!N You can remove an
28already present attribute by setting its value to null. #!N #!I0
29#!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   input #!EF #!EF #!I50 #!N
30names the object to which one or more attributes are to
31be added. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   attribute #!EF #!EF #!I50
32#!N names the attribute to be added. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*
33 #!F-adobe-times-bold-r-normal--18*   value #!EF #!EF #!I50 #!N specifies the value of the
34attribute #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   ... #!EF #!I50 #!N One or
35more additional pairs of parameters, each specifying an  #!F-adobe-times-bold-r-normal--18*   attribute #!EF
36and a  #!F-adobe-times-bold-r-normal--18*   value #!EF to be associated with  #!F-adobe-times-bold-r-normal--18*   input
37#!EF . #!I0 #!N #!N #!N #!N A single Options module
38can specify a maximum of 21  #!F-adobe-times-bold-r-normal--18*   attribute #!EF -  #!F-adobe-times-bold-r-normal--18*
39object #!EF pairs. In the user interface, the default number of
40enabled tab-pairs is two. (Tabs can be added to the module
41icon and removed with the appropriate  #!F-adobe-times-bold-r-normal--18*   ...Input Tab #!EF options
42in the  #!F-adobe-times-bold-r-normal--18*   Edit #!EF pull-down menu of the VPE.) #!N
43#!N  #!Rattrib21 #!T,1,216,431,646  #!F-adobe-times-bold-r-normal--18*   #!N TAB Table 21. Attributes which have
44predefined meanings in Data Explorer #!N TAB Attribute name TAB Attribute
45values TAB Relevant module #!EF #!N TAB label TAB any user-supplied
46label TAB Plot #!N TAB scatter TAB 1 or 0 TAB
47Plot #!N TAB mark TAB "circle," "diamond," "dot," "square," TAB Plot
48#!N TAB - TAB "star," "triangle," "x" TAB #!N TAB mark
49every TAB positive integer TAB Plot #!N TAB mark scale TAB
50positive scalar TAB Plot #!N TAB fuzz TAB integer TAB Display,
51Render, Image #!N TAB ambient TAB positive scalar TAB Display, Render,
52Image #!N TAB diffuse TAB positive scalar TAB Display, Render, Image
53#!N TAB specular TAB positive scalar TAB Display, Render, Image #!N
54TAB shininess TAB positive integer TAB Display, Render, Image #!N TAB
55shade TAB 0 or 1 TAB Display, Render, Image #!N TAB
56opacity multiplier TAB positive scalar TAB Display, Render, Image (for volume
57#!N TAB - TAB - TAB rendering) #!N TAB color multiplier
58TAB positive scalar TAB Display, Render, Image (for volume #!N TAB
59- TAB - TAB rendering) #!N TAB texture TAB a texture
60map TAB Display, Image #!N TAB antialias TAB "lines" TAB Display,
61Image #!N TAB line width TAB positive integer TAB Display, Image
62#!N TAB direct color map TAB 0 or 1 TAB Display
63#!N TAB cache TAB 0 or 1 TAB Display, Image #!N
64TAB rendering mode TAB software or hardware TAB Display, Image #!N
65TAB rendering approximation TAB "none," "box," "dots," or "wireframe" TAB Display,
66Image #!N TAB render every TAB positive integer TAB Display, Image
67#!N TAB pickable TAB 0 or 1 TAB Pick #!N TAB
68marked component TAB string TAB Mark, Unmark #!N #!N Attributes may
69also be added to arrays to add information which may be
70needed to interpret an array as a Data Explorer component. For
71example, you can add a "ref" attribute with a value of
72"positions" to an integer list which you intend to be used
73as a connections component in a field. This use of  #!F-adobe-helvetica-bold-r-normal--18*
74 #!F-adobe-times-bold-r-normal--18*   Options #!EF #!EF should be done only with a solid
75understanding of the Data Explorer data model. See  #!Lsca,dxall223 h Standard Attributes  #!EL  in IBM
76Visualization Data Explorer User's Guide. #!N #!N Components #!N #!N The
77output object is the same as the input object except for
78the added attributes. All input components are propagated to the output.
79#!N #!N Example Visual Programs #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N PlotTwoLines.net
80#!N #!N FatLines.net #!N #!EF #!N #!N #!EC #!N #!N See
81Also #!N #!N  #!Lattrib,dxall769 h Attribute  #!EL  ,  #!Lautoaxe,dxall770 h AutoAxes  #!EL  ,  #!Ldisplay,dxall807 h Display  #!EL  ,  #!Lplot,dxall904 h Plot  #!EL  ,
82 #!Lrender,dxall923 h Render  #!EL  #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Loutput,dxall899 h Output  #!EL
83#!N  #!F-adobe-times-medium-i-normal--18*   #!N
84