Arguments for Diagram Appearance

The following arguments for the DS2TREE and DS2CONST macros specify non-default behavior and appearance of the node and link diagram in the respective applet.
None of the following arguments are required.
ACTION=text
specifies the default text that is displayed in a pop-up menu when the Web user selects a node with the right mouse button. Selecting this menu option displays the URL that is associated with that node in the NURL= argument. This argument is overridden by the NACTION= argument (see Arguments for Data Definition). The ACTION= argument is useful when you want to use a single menu text string for most of the nodes in your diagram. The default menu option text is Open URL.
Used by:DS2CONST, DS2TREE
ANGLE=link-angle
works with the TREESPAN= argument to determine the direction of growth for the diagram. The ANGLE= argument is valid only when you do not specify the TREEDIR= argument. The TREESPAN= argument defines the angular width of the tree (narrow or wide layout). The TREESPAN angle can be visualized as a V shape, with the starting node positioned at the base of the V. The rest of the nodes are laid out between the spreading arms of the V. The ANGLE= argument specifies the angle of the V shape. By default, the value of the ANGLE= argument is zero (0) and the V shape opens to the right, as if the letter V was rotated 90 degrees clockwise, to the three-o'clock position. Values of the ANGLE= argument that are greater than zero rotate the V shape counterclockwise away from the three-o'clock position. Valid values for the ANGLE= argument range from zero (0) to 360 degrees.
Used by:DS2TREE
BORDER=Y | N
specifies whether a border is drawn around the background area. The default value is N.
Used by:DS2CONST, DS2TREE
CATEXT=default-text-color
specifies a default color for the text in the diagram, using an HTML 3.2 color name or a 6-digit hexadecimal RGB value. For DS2CONST, this argument is overridden by the FNTNAME= argument (see below) and the NTEXTCOL argument (see Arguments for Data Definition).
Used by:DS2CONST, DS2TREE
CBACK=color
specifies a background color for the Treeview Applet. The value must be a valid HTML 3.2 color name.
Used by:DS2TREE
CHANDLE=color
specifies the color of the Collapse/Expand handle on the nodes. The handle is represented by a small plus sign (+) that is prefixed to the label of the node when its subtree is collapsed. The value must be a valid HTML color name.
Used by:DS2TREE
CLINK=default-link-color
specifies a default color for the links in the diagram, using an HTML 3.2 color name or a 6-digit RGB value. For DS2CONST, this argument is overridden by the LCOLOR= and LCOLVAL= arguments (see Arguments for Data Definition).
Used by:DS2CONST, DS2TREE
CNODE=color
specifies the node background color. The value must be a valid HTML color name. The value specified here can be overridden by specifying a value for the NCOLOR= argument.
Used by:DS2TREE
CNODE=default-node-color
specifies a default background color for the nodes, using an HTML 3.2 color name or a 6-digit RGB value. This argument is overridden by the NCOLOR=, NCOLVAL=, NVALUE=, or NSCBACK= arguments (see Arguments for Data Definition).
Used by:DS2CONST
COLORMAP=N | Y
when the value is N (default), specifies that the Constellation Applet is to use the NCOLOR= and LCOLOR= arguments (see Arguments for Data Definition) to determine node and link colors rather than using the color map.
Used by:DS2CONST
CSELECT=color
specifies a color for nodes that are selected by the mouse or as the result of a node search. The value must be a valid HTML 3.2 color name.
Used by:DS2CONST, DS2TREE
CUTOFF=detail-percentage
specifies the percentage of the nodes that will be displayed with node labels. After the percentage has been reached, nodes are drawn as rectangles. The size of those rectangles decreases as the distance from the starting node increases. Valid values range from 0.0 to 1.0 (The decimal value is mapped to a percentage from 0% to 100%). The default value is 0.5. See also the DEPTH argument.
Used by:DS2CONST, DS2TREE
DEPTH=max-path-length
specifies a whole number greater than zero that determines the maximum number of links that are to be displayed in the node and link diagram. Paths whose lengths exceed the limit are truncated. This argument affects only the initial display of the diagram. Nodes that are initially hidden can become visible as a user selects nodes and navigates around the diagram.
Note that this value is ignored if CUTOFF= 1.0. There is no default value for this argument.
Used by:DS2TREE
DRILTARG=target-window-or-frame
specifies the HTML target or the name of the browser window or frame where drill-down URLs are displayed. The default behavior is to open a new browser window and reuse it for subsequent drill-down requests. Specifically, the default value is _BLANK, which is one of several reserved names for targets in HTML. The value can also be the name of a window or frame in the Web presentation.
Used by:DS2CONST, DS2TREE
DUPCHECK=TRUE | FALSE
specifies whether the applet will check for duplicate node IDs. The default value is FALSE. When set to TRUE, this argument will cause the applet to update an ID if a duplicate ID is found, instead of creating a new node with the same ID. This enables you to collect node information from different locations in the data set.
Used by:DS2TREE
FACTOR=fish-eye-distortion-factor
specifies the distortion factor for the fish-eye lens. The distortion factor determines the amount that the central region of the display is to be expanded (or zoomed). The value specified must be greater than or equal to 1.0. The default value is 1.0, which represents the lowest amount of distortion. This argument is valid only when the value of the FISHEYE= argument is Y. The maximum effective value (beyond which no further distortion is visible) is variable depending on the number of nodes in the diagram.
Used by:DS2TREE
FISHEYE=Y | N
indicates whether the diagram is to be displayed with the fish-eye distortion, which displays the central region of the diagram at a specified size and displays the rest of the diagram as if it were mapped onto a ball, with the nodes and links disappearing over a curved horizon. The Web user can move the diagram past the central region by scrolling or searching for nodes. The amount of distortion used in the fish-eye lens is determined by the FACTOR= argument. The default value is Y.
Used by:DS2TREE
FNTNAME=default-node-label-font
specifies the default text font for node labels. Valid values can be SERIF, SANSSERIF, DIALOG, DIALOGINPUT, or MONOSPACED. This argument is overridden by the NFNTNAME or NSFNTNAM= arguments (see Arguments for Data Definition).
Used by:DS2CONST, DS2TREE
FNTSIZE=node-font-size
specifies the size of the node label text font, in points. This argument is overridden by the NFNTSIZE= argument.
Used by:DS2CONST, DS2TREE
FNTSTYL=node-font-style
specifies the text font style for node labels. Valid values are BOLD, ITALIC, and PLAIN. PLAIN is the default value. This argument is overridden by the NFNTSTYL= argument.
Used by:DS2CONST, DS2TREE
IBACKLOC=image-URL
specifies a URL for the image that you want to use in the background of the diagram. See also the IBACKPOS= argument.
Used by:DS2CONST, DS2TREE
IBACKPOS=CENTER | SCALE | TILE | POSITION
specifies how to display the background image in the IBACKLOC= argument. Specify one of the following options:
CENTER
centers the image in the browser window without resizing the image.
SCALE
resizes the image to fit the browser window.
TILE
fills the browser window by replicating the image at its original size.
POSITION
positions the image without resizing at the values specified by the IBACKX= and IBACKY= arguments.
Used by:DS2CONST, DS2TREE
IBACKURL=background-drilldown-URL
specifies the URL that is displayed when you click on the background image. This argument is valid only when the value of the IBACKPOS= argument is POSITION. If you are including the Powered by SAS logo, then you must use this argument to link the image to the SAS Web site.
Used by:DS2CONST, DS2TREE
IBACKX=corner-coordinate
IBACKY=corner-coordinate
specifies the x (horizontal) and y (vertical) pixel coordinates of the upper left corner of the background image. Positive values are measured from the upper left corner of the background area. Negative values are measured from the lower right corner of the background area. These values are valid only if the value of the IBACKPOS= argument is POSITION. Always specify both the IBACKX= and IBACKY= arguments.
Used by:DS2CONST, DS2TREE
NODEBDR=LINE | NONE | FILL | OUTLINE
specifies the appearance of the node border line, using one of the following values:
LINE
show solid border lines around the nodes.
NONE
show no border lines or background.
FILL
show background but no border lines.
OUTLINE
show a border line and background. This is the default value.
Used by:DS2TREE
NODESHAP=shape
specifies the shape of the nodes. Valid values can be CIRCLE, DIAMOND, NONE, SQUARE, or TRIANGLE. The default value is SQUARE. This argument is overridden by the NSHAPE= argument (see Arguments for Data Definition).
Used by:DS2CONST
RBSIZING=Y | N
the default value N indicates that size information from the resource bundle is not to be used for sizing the two dialog boxes that can be invoked from the pop-up menu that appears when a user right-mouse-clicks on a diagram. The two dialog boxes are the About dialog box and the Mouse Help dialog box.
Specify Y for this argument for languages other than English.If you specify Y, then the height and the width of the dialog box frames are read in from the resource bundle. This allows translators to set appropriate heights and widths for the frames in the resource bundle, based on the length of the message strings in each language.
Used by:DS2CONST, DS2TREE
SCLNKWT=Y | N
when the value is Y (default), specifies that the link weight values are to be scaled into the range of 0–1, which corresponds to 0–100%. When SCLNKWT=Y, the scroll bar in Constellation Applet displays a percentage of the range of the link weights. When SCLNKWT=N, the link weights are not scaled and the scroll bar reflects the actual link weight data values. These values are real numbers that are specified in the LVALUE= argument (see Arguments for Data Definition). The SCLNKWT= argument is valid only when the value of the DATATYPE= argument is ASSOC. Note that the range of link weights (maximum minus minimum) must be greater than 2 when SCLNKWT=N. Otherwise, the scroll bar will not correctly map the link weights.
Used by:DS2CONST
SCLWIDTH=Y | N
when the value is Y (default), indicates that the link width values are to be scaled into the range of 0–1. Specifying N indicates that the link widths are already scaled into that range. This argument is valid only when the value of the DATATYPE= argument is ASSOC.
Used by:DS2CONST
SCNSIZE=Y | N
when the value is Y (default), indicates that the node size values are to be scaled into the range of 0–1. Specifying N indicates that the node sizes are already scaled into that range. This argument is valid only when the value of the DATATYPE= argument is ASSOC. Node sizes are specified with the NSIZE= argument (see Arguments for Data Definition).
Used by:DS2CONST
SHOWLINKS=Y | N
specifies whether initially to display all arc lines between nodes. Specifying N suppresses all arc lines. The default value is Y.
Note: This argument affects only the initial display. A viewer can subsequently control which arc lines are displayed by right-mouse clicking and selecting a Show links option from the pop-up menu.
Used by:DS2CONST
SPREAD=angular-factor
specifies the angular spreading factor for the layout of the diagram. The value specified must be greater than or equal to 1.0. The default value is 1.25.
Used by:DS2TREE
TIPS=Y | N
indicates whether pop-up data tips are displayed when the cursor is positioned over nodes or links or both. The default value is Y.
Used by:DS2CONST, DS2TREE
TIPTYPE=TRACKING | STATIONARY
when the value is TRACKING (default), indicates that the pop-up data tips windows are to move with the cursor while the cursor moves within the area of a single node or link.
Used by:DS2CONST
TREEDIR=C | D | L | R | U
determines the growth direction of the node and link diagram using the following values.
C | CIRCULAR
grows the tree in a circular pattern. This is the default value.
D | DOWN
grows the tree from top to bottom using center alignment.
L | LEFT
grows the tree from left to right and top to bottom.
R | RIGHT
grows the tree from right to left and top to bottom.
U | UP
grows the tree from the bottom up using center alignment.
If the value of the TREEDIR= argument is UP or DOWN, then the value of the TREESPAN= argument is used to set the angular width of the diagram. The starting node is aligned horizontally in the center of the applet. The diagram grows out of the starting node based on the angular width specified in the TREESPAN= argument. The wider the angle, the wider the layout of the diagram.
The TREEDIR= argument overrides the ANGLE= argument.
Used by:DS2TREE
TREESPAN=angular-diagram-width
specifies the angular width of the diagram in degrees. Valid values must be greater than zero and less than 360. The default value is 60. For details, see the TREEDIR= and ANGLE= arguments.
Used by:DS2TREE
ZOOM=starting-percentage
specifies the zoom value that is used for the initial display of the diagram. After the initial display, the Web user can change the zoom percentage dragging the mouse up and down while pressing the Ctrl + left mouse button. Selecting the Refresh button on the browser runs the applet and restores the initial zoom setting. The default value is 100%. The initial diagram can be scaled up with a value greater than 100 or scaled down with a value less than 100.
Used by:DS2CONST