Legend SCSI & RAID Devices Driver
This appendix provides a list of scanners supported by Sane 1.0.1. |
Legend | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
You need to enable this backend in Sanes There are four types of status: · Stable: This is proven and works well if it's supported. · Beta: Usually works just fine but it can sometimes hit a bug. · Alpha: This may work but it needs more development and debugging. · New: This package is so new that it doesn't have a qualified status. The comments column often indicates how well the backend works. (It can be wise to run
|
The chart legend contains descriptions for each category in a chart. A legend always contains one or more legend items, where each legend item consists of a colored box that represents the series, and a text string that describes the series, as indicated in the following illustration. The SCSI client/server model During the communication between a host and storage, a host generally acts as a SCSI initiator. In computer storage, the SCSI initiator is the endpoint that initiates a SCSI session, meaning it sends a SCSI command. The storage often acts as a SCSI target that receives and processes SCSI commands.
Frozenriver Digital Design http://www.frozenriver.nu Voice: +46 (0)31 474356 Fax: +46 (0)31 493833 support@frozenriver.com | Publisher Coriolis http://www.coriolis.com |
Previous Page | | | Next Page |
SAS/GRAPH Statements |
Controls the location and appearance of legends on two-dimensionalplots, contour plots, maps, and charts.
GAREABAR, GCHART,GBARLINE, GCONTOUR,GMAP, GPLOT procedures |
Global |
Syntax | |
Description | |
Options | |
Text Description Suboptions | |
Using Text Description Suboptions | |
Using the LEGEND Statement | |
Positioning the Legend | |
Positioning the Legend on the Graphics Output Area | |
Using POSITION= and OFFSET= | |
Using ORIGIN= | |
Relating Legends to Other Graphic Elements | |
Interactions Between POSITION= and MODE= | |
Creating Drop Shadows and Block Effects |
Syntax |
LEGEND<1...99><options>; |
option(s) can be one ormore options from any or all of the following categories:
appearance options
ACROSS=number-of-columns
CBLOCK=block-color
CBORDER=frame-color
CFRAME=background-color
CSHADOW=shadow-color
DOWN=number-of-rows
FRAME
FWIDTH=thickness-factor
REPEAT=1| 2 | 3
ROWMAJOR | COLMAJOR
SHAPE=BAR(width,height)<units> | LINE(length) <units> | SYMBOL(width,height)<units>
position-options
MODE=PROTECT | RESERVE | SHARE
OFFSET=(<x ><,y>)<units > | (<x <units >><,y <units>>)
ORIGIN=(<x ><,y >)<units > |(<x <units >><,y <units>>)
POSITION=(<BOTTOM | MIDDLE | TOP> <LEFT |CENTER | RIGHT> <INSIDE | OUTSIDE>)
text-options
LABEL=(text-argument(s))| NONE
ORDER=(value-list)
VALUE=(text-argument(s))| NONE
Description |
LEGENDstatements specify the characteristics of a legend but do not create legends. The characteristics are as follows:
the position and appearance of the legend box
the text and appearance of thelegend label
the appearance of the legend entries, includingthe size and shape of the legend values
the text of the labels for the legend values
LEGENDdefinitions are not automatically applied whena procedure generates a legend. Instead, they must be explicitly assignedwith a LEGEND= option in the appropriate procedure statement.
The following figure illustrates the terms associatedwith the various parts of a legend.
Options |
When the syntax of an option includes units, use one of these:
CELLS | character cells |
CM | centimeters |
IN | inches |
PT | points |
PCT | percentage of the graphics outputarea |
Note: The Java applet does not support CM,IN, or PT.
If you omit units, a unitspecification is searched for in this order:
GUNIT= in a GOPTIONS statement
the default unit,CELLS
specifies the number of columns to use forlegend entries. If there are multiple rows and columns in a legend, use theROWMAJOR and COLMAJOR options to specify the arrangement of legend entries.Specify the ROWMAJOR option to arrange entries (from lowest to highest) startingfrom left to right, and then top to bottom. Specify the COLMAJOR option toarrange entries starting from top to bottom, and then left to right.
ROWMAJOR, COLMAJOR |
generates and colors a three-dimensionalblock effect behind the legend. The size and position of the block are controlledby the graphics option OFFSHADOW=(x,y).
The CBLOCK= and CSHADOW= options are mutually exclusive.If both are present, SAS/GRAPH softwareuses the last one specified. The CBLOCK= option is usually used in conjunctionwith the FRAME, CFRAME=, or CBORDER= options.
The Java applet treats the CBLOCK option like the CSHADOWoption.
The OFFSHADOW= graphics option andCreating Drop Shadows and Block Effects |
Not supported byJava. |
draws a colored frame around the legend.This option overrides the FRAME option. CBORDER= can be used in conjunctionwith the CFRAME= option.
Color attribute of the GraphBorderLinesgraph element |
specifies the background color of the legend. This option overrides the FRAME option. If both the CFRAME= and FRAME= optionsare specified, only the solid background produced by the CFRAME= option isdisplayed. The CFRAME= option can be used in conjunction with the CBORDER=option.
Color attribute of the GraphLegendBackgroundgraph element |
Legend Scsi Game
generates and colors a drop shadow behindthe legend. The size and position of the shadow is controlled by the graphicsoption OFFSHADOW=(x,y).
The CSHADOW= and CBLOCK= options are mutually exclusive.If both are present, SAS/GRAPH usesthe last one specified. The CSHADOW= option is usually specified in conjunctionwith the FRAME, CFRAME=, or CBORDER= options.
the OFFSHADOW= graphics option andCreating Drop Shadows and Block Effects. |
specifies the number of rows to use forlegend entries. If there are multiple rows and columns in a legend, usethe ROWMAJOR and COLMAJOR options to specify the arrangement of legend entries.Specify the ROWMAJOR option to arrange entries (from lowest to highest) startingfrom left to right, and then top to bottom. Specify the COLMAJOR option toarrange entries starting from top to bottom, and then left to right. The ROWMAJORoption is the default.
draws a frame around the legend. The colorof the frame is the first color in the color list.
specifies the thickness of the frame, where thickness-factor is a number. The thickness of the line increasesdirectly with thickness-factor. By default,FWIDTH=1.
Not supported byJava and ActiveX |
modifies a legend label. Text-argument(s) defines the appearance or the text of a legendlabel, or both. NONE suppresses the legend label. By default, the text ofthe legend label is either the variable name or a previously assigned variablelabel (except in the case of GPLOT with OVERLAY. In that case the defaultlabel is 'PLOT'). Text-argument(s)can be one or more of these:
provides up to 256 characters of label text. Enclose each string in quotes. Separate multiple strings with blanks.
modifies a characteristic such as the font,color, or size of the text strings that follows it. Text-description-suboption can be as follows:
COLOR=text-color |
FONT=font |NONE |
HEIGHT=text-height <units> |
JUSTIFY=LEFT | CENTER |RIGHT |
POSITION=(<BOTTOM | MIDDLE | TOP> <LEFT |CENTER | RIGHT>) |
Note: The Java applet does not support the POSITION=suboption--it draws legend labels at the top-left of the legend. Also,it does not support multiple values for the JUSTIFY= suboption (only the firstis honored). The ActiveX control supports the POSITION= option but does notsupport multiple values for the JUSTIFY suboption (only the first is honored).
See Text Description Suboptions forcomplete descriptions.
Specify as many text strings and text description suboptionsas you want, but enclose them all in one set of parentheses.
Color attribute of the GraphLabelTextgraph element |
Example 3. Rotating Plot Symbols Through the Color List andExample 8. Creating a Simple Web Page with the ODS HTML Statement |
Partially supportedby Java and ActiveX |
specifies whether the legend is drawn inthe procedure output area or whether legend elements can overlay other graphicselements. MODE= can take one of these values:
PROTECT | draws the legend in the procedureoutput area, but a blanking area surrounds thelegend, preventing other graphics elements from being displayed in the legend. (A blanking area is a protected area in which no other graphics elementsare displayed.) |
RESERVE | takes space for the legend from theprocedure output area, thereby reducing the amount of space available forthe graph. If MODE=RESERVE is specified in conjunction with OFFSET=, thelegend can push the graph off the graphics output area. RESERVE is valid onlywhen POSITION=OUTSIDE. If POSITION=INSIDE is specified, a warning is issuedand MODE= value is changed to PROTECT. |
SHARE | draws the legend in the procedureoutput area. If the legend is positioned over elements of the graph itself,both graphics elements and legend elements are displayed. |
By default, MODE=RESERVE unless POSITION=INSIDE. Inthis case, the default changes to MODE=PROTECT.
Not supported byJava andActiveX |
specifies the distance to move the entirelegend; x is the number of units to move thelegend right (positive numbers) or left (negative numbers), and y is the number of units to move the legend up (positive numbers)or down (negative numbers).
To set only the x offset,specify one value, with or without a following comma:
To set both the x and y offset, specify two values, with or without a comma separatingthem:
To set only the y offset,specify one value preceded by a comma:
The OFFSET= option is usually used in conjunction withthe POSITION= option to adjust the position of the legend. Moves are relativeto the location specified by the POSITION= option, with OFFSET=(0,0) representingthe initial position. You can also apply the OFFSET= option to the defaultlegend position.
The OFFSET= option is unnecessary with the ORIGIN= optionsince the ORIGIN= option explicitly positions the legend and requires no furtheradjustment. However, if you specify both options, the OFFSET= values areadded to the ORIGIN= values,l and the LEGEND is positioned accordingly.
Positioning the Legend and the optionPOSITION= |
Not supported byJava and ActiveX |
selects or orders the legend values thatappear in the legend. The way you specify value-listdepends on the type of variable that generates the legend:
For numeric variables, value-list is either an explicit list ofvalues, or a starting and anending value with an interval increment, or a combination of both forms:
n <...n>
n TO n<BY increment>
n <...n> TO n <BYincrement> <n <...n>>
If a numeric variable has an associated format, thespecified values must be the unformatted values.
Forcharacter variables, value-list is a list ofunique character values enclosed in quotes and separated by blanks:
'value-1' <...'value-n'>
If a charactervariable has an associated format, thespecified values must be the formatted values.
For a complete description ofvalue-list, see the option ORDER= in the AXIS statement.
Even thoughthe ORDER= option controls whether a legendvalue is displayed and where it appears, the VALUE= option controls the textthat the legend value displays.
Not supported byJava and ActiveX |
specifies the xcoordinate and the y coordinate of the lower-leftcorner of the legend box. The ORIGIN= option explicitly positions the legendanywhere on the graphics output area. It is possible to run a legend offthe page or overlay the graph.
To set only the x coordinate,specify one value, with or without a following comma:
To set both the x and y coordinates, specify two values, with or without a commaseparating them:
To set only the y coordinate,specify one value preceded by a comma:
The ORIGIN= option overrides the POSITION= option ifboth are used. Although using the OFFSET= option with the ORIGIN= optionis unnecessary, if the OFFSET= option is also specified, it is applied afterthe ORIGIN= request has been processed.
Not supported byJava andActiveX |
positions the legend on the graph. Valuesfor POSITION= are
OUTSIDE or INSIDE | specifies the location of the legendin relation to the axis area. |
BOTTOM or MIDDLE or TOP | specifies the vertical position. |
LEFT or CENTER or RIGHT | specifies the horizontal position. |
By default, POSITION=(BOTTOM CENTER OUTSIDE). You canchange one or more settings. If you supply only one value the parenthesesare not required. If you specify two or three values and omit the parentheses, SAS/GRAPH acceptsthe first value and ignores the others.
Once you assign the initial legend position, you canadjust it with the OFFSET= option.
The ORIGIN= option overrides the POSITION= option. Thevalue of the MODE= option can affect the behavior of the POSITION= option.
Note: The Java applet defaults to BOTTOM-CENTER and supportsall possible combinations of BOTTOM | MIDDLE | TOP with LEFT | CENTER | RIGHTexcept for MIDDLE-CENTER (which would overwrite the map.) The Java appletdoes not support INSIDE for positioning.
OFFSET= option andMODE= option |
Partially supportedby Java |
Use the REPEAT= option to specify how many times the plotsymbol is repeated in the legend. Valid values are 1 to 3, with 3 being thedefault.
specifies the arrangement of legend entries when there aremultiple rows and multiple columns. Specify the ROWMAJOR option (the default)to arrange entries (from lowest to highest) starting from left to right, andthen top to bottom. Specify the COLMAJOR option to arrange the entries startingfrom top to bottom, and then left to right.
ACROSS=, DOWN= |
specifies the size and shape of the legendvalues displayed in each legend entry. The SHAPE= value you specify dependson which procedure generates the legend.
is used with the GCHART and GMAP procedures,with the GPLOT procedure if you use the AREAS= option, and with the GCONTOURprocedure if you use the PATTERN option. Each legend value is a bar of thespecified width and height. By default, widthis 5, height is 0.8, and units are CELLS. You can specify unitsfor the width,heightpair or for the individual coordinates.
is used with the GPLOT and GCONTOUR procedures.Each legend value is a line of the length you specify. Plotting symbols areomitted from the legend values. By default, lengthis 5 and units are CELLS. You can specify units forlength.
is used with the GPLOT procedure. Eachlegend value (not each symbol) is the width and height you specify. For example, this specification produces legend valueslike the ones in Legend Values Produced with SHAPE= SYMBOL(a):
This specificationproduces legend values like the ones in Legend Values Produced with SHAPE= SYMBOL(b):
Bydefault, width is 5, height is 1, and units are CELLS.You can specify units for the width,height pair or for the individualcoordinates.
Not supported byJava and ActiveX |
modifies the legend value descriptions. Text-argument(s) defines the appearance or thetext of the value descriptions. By default, value descriptions are the valuesof the variable that generates the legend or an associated format value. Numericvalues are right-justified and character values are left-justified.
NONE suppresses the value descriptions although thelegend values (bars, lines, and so on) are still displayed. (NONE is not supportedby Java or ActiveX). Text-argument(s) can beone or more of these:
provides up to 256 characters of text forthe value description. Enclose each string in quotes. Separate multiple stringswith blanks.
Specified text strings are assigned to the legend valuesin order. If you submit only one string, only the first legend entry usesthe value of that string. If you specify multiple strings, the first stringis the text for the first entry; the second string is the text for the secondentry; and so on. For example, this specificationproduces legend entries like those shown in Specifying Value Descriptions with the VALUE= Option:
modifies a characteristic such as the font,color, or size of the text string(s) that follows it. Text-description-suboption can be as follows:
COLOR=text-color |
FONT=font |NONE |
HEIGHT=text-height <units > |
JUSTIFY=LEFT | CENTER |RIGHT |
TICK=n |
SeeText Description Suboptions for complete descriptions.
Place text description suboptions before the text stringsthey modify. Suboptions not followed by a text string affect the default values.To specify and describe the text for individual values or to produce multi-linetext, use the TICK= suboption.
Specify as many text strings and text description suboptionsas you want, but enclose them all in one set of parentheses.
To order or select legend entries, use the ORDER= option.
Text Description Suboptions and the optionORDER= |
Partially supportedby Java and ActiveX |
Text Description Suboptions |
Text description suboptions are used bythe LABEL= and VALUE= options to change the color, height, justification,font, and angle of either default text or specified text strings. See the LABEL= suboption andthe VALUE= suboption.
specifies the color of the text. If youomit the COLOR= suboption, a color specification is searched for in this order:
the CTEXT= option for theprocedure
the CTEXT= option in a GOPTIONS statement
the color of the default style
C=text-color |
specifies the font for the text. See Specifying Fonts in SAS/GRAPH Programs for information on specifyingfonts. If you omit the FONT= suboption, a font specification is searched forin this order:
the FTEXT= option in a GOPTIONS statement
the default style font,NONE
F=font |NONE |
specifies the height of the text charactersin the number of units. By default, HEIGHT=1 CELL. If you omit the HEIGHT=suboption, a text height specification is searched for in this order:
the HTEXT= option in a GOPTIONSstatement
the height specified by the default style
H=text-height<units> |
specifies the alignment of the text. Thedefault for character variables is JUSTIFY=LEFT. The default for numericvariables is JUSTIFY=RIGHT. Associating a character format with a numericvariable does not change the default justification of the variable.
You can use the JUSTIFY= suboption to print multiplelines of text by repeating the suboption before the text string for each line. For example, this statement produces alegend label and value descriptions like those shown in Specifying Multiple Lines of Text with the JUSTIFY= Suboption:
Specifyadditional suboptions before any string.
the suboption TICK= . |
J=L | C | R |
places the legend label in relation to thelegend entries. The POSITION= suboption is used only with the LABEL= option. By default, POSITION=LEFT.
The parentheses are not required if only one value issupplied. If you specify two or three values and omit the parentheses, SAS/GRAPH acceptsthe first value and ignores the others.
Using the POSITION= Suboption with Multiple-line Legend Labels shows some of the ways the POSITION=suboption affects a multiple-line legend label in which the entries are stackedin a column (ACROSS=1). This figure uses a label specification such as thefollowing:
In this specification,the POSITION= suboption specifies the default value, LEFT, which is representedby the first legend in the figure. The POSITION= value is indicated aboveeach legend. The default justification is used unless you also use the JUSTIFY=suboption.
In addition, specifying POSITION=RIGHT mirrorsthe effect of POSITION=LEFT, and specifying POSITION=BOTTOM mirrors the effectof POSITION=TOP.
Not supported by Java. Partiallysupported by ActiveX. |
specifies the nthlegend entry. The TICK= suboption is used only with the VALUE= option todesignate the legend entry whose text and appearance you want to modify. Forexample, to change the text of the third legend entry to Minneapolis, specify the following code:
The characteristics of all other value descriptionsremain unchanged.
If you use the TICK= suboption when you designate textfor one legend entry, you must also use it when you designate text for anyadditional legend entries. For example, this option changes the text of boththe second and third legend entries:
If you omitted TICK=3, the text of the second legendentry would be ParisSydney.
Text description suboptions that precedethe TICK= suboption affect all the value descriptions for the legend unlessthe same suboption (with a different value) follows a TICK= specification. Text description suboptions that follow the TICK= suboptionaffect only the specified legend entry. For example, suppose you specifythis option for a legend with three entries:
The text of all three entries would use the Swiss font;the first and third entries would be red and only the second entry would beblue.
T=n |
Using Text Description Suboptions |
Text description suboptions affect allthe strings that follow them unless the suboption is changed or turned off. If the value of a suboption is changed, the new value affects all the textstrings that follow it. Consider this example:
FONT=ALBANY applies to both Weight and (in tons). HEIGHT=4 affects Weight,but is respecified as HEIGHT=3 for (in tons). JUSTIFY=RIGHT affects only (in tons).
Using the LEGEND Statement |
Legend Scsi Meaning
LEGEND statements can be located anywherein yourSAS program. They are global and remain in effect until canceled or untilyou end your SAS session. LEGEND statements are not applied automatically,and must be explicitly assigned by an option in the procedure that uses them.
You can define up to 99 different LEGEND statements. If you define two LEGEND statements of the same number, the most recentlydefined statement replaces the previously defined statement of the same number. A LEGEND statement without a number is treated as a LEGEND1 statement.
Cancel individual LEGEND statements by defining a LEGENDstatement of the same number without options (a null statement):
Canceling one LEGEND statement does not affect any otherLEGEND definitions. To cancel all current LEGEND statements, use RESET= ina GOPTIONS statement:
Specifying RESET=GLOBAL or RESET=ALL cancels all currentLEGEND definitions as well as other settings.
To display a list of current LEGEND definitions in theLOG window, use the GOPTIONS procedure with the LEGEND option:
Positioning the Legend |
Bydefault, the legend shares the procedure output area with the procedure output,such as a map or bar chart. (See How Graphic Elements are Placed in the Graphics Output Area.) However, several LEGEND statementoptions enable you to position a legend anywhere on the graphics output areaand even to overlay the procedure output. This section describes these optionsand their effect on each other.
Positioning the Legend on the Graphics Output Area
There are two ways you can position the legend on thegraphics output area:
Describe the general location of the legend withthe POSITION= option. If necessary, fine-tune the position with the OFFSET=option.
Position the legend explicitly with the ORIGIN=option.
Using POSITION= and OFFSET=
Thevalues of the POSITION= option affect the legend in two ways:
OUTSIDE and INSIDE determine whether the legendis located outside or inside the axis area.
BOTTOM or MIDDLE or TOP (vertical position) andLEFT or CENTER or RIGHT (horizontal position) determine where the legend islocated in relation to its OUTSIDE or INSIDE position.
Legend Positions Inside the Axis Area showsthe legend positions inside the axis area.
Legend Positions Outside the Axis Areashows legend positions outside the axis area.
Thedefault combination is POSITION=(BOTTOM CENTER OUTSIDE).The combination (OUTSIDE MIDDLE CENTER) is notvalid.
Use OFFSET=(x,y) to adjust the position ofthe legend specified by the POSITION= option. The xvalue shifts the legend either left or right and the yvalue shifts the legend either up or down.
The offset values are always applied afterthe POSITION= request. For example, if POSITION=(TOP RIGHT OUTSIDE), the legendis located in the upper right corner of the graphics output area. If OFFSET=(0,0)is specified, the legend does not move. If OFFSET=(-5,-8)CM, the legend moves5 centimeters to the left and 8 centimeters down.
Using ORIGIN=
UseORIGIN=(x,y) tospecify the coordinates of the exact location of the lower left corner ofthe legend box. Because ORIGIN=(0,0) is the lower left corner of the graphicsoutput area, the values of x and y must be positive. If you specify negative values, a warningis issued and the default value is used.
Relating Legends to Other Graphic Elements
Legend Scsi & Raid Devices Driver Updater
By default, the legend is insidethe procedure output area and the space it occupies reduces the size of thegraph itself. To control the way the legend relates to the other elementsof the graph, use the MODE= option. These are values for the MODE= option:
Legend Scsi Command
RESERVE reserve space for the legend outside theaxis area and move the graph to make room for the legend. This is the defaultsetting and is valid only when POSITION=OUTSIDE.
PROTECT prevents the legend from being overwrittenby the procedure output. PROTECT blanks out graphics elements, allowing onlylegend elements to be displayed in the legend's space.
SHARE displays both graphics elements and legendelements in the same space. This setting is usually used when the legendis positioned inside the axis area. SHARE is useful when the graph has aspace that the legend can fit into.
Interactions Between POSITION= and MODE=
Youcannot specify both POSITION=INSIDE and MODE=RESERVE becauseMODE=RESERVE assumes that the legend is outside the axis area,and POSITION=INSIDE positions the legend inside the axis area.Therefore, when you specify POSITION=INSIDE, change the value of the MODE=option to SHARE or PROTECT. Otherwise, SAS/GRAPH issuesa warning and automatically changes the MODE= value to PROTECT.
Creating Drop Shadows and Block Effects |
To produce a drop shadow or a three-dimensional block effectbehind the legend use the CSHADOW= or CBLOCK= option in the LEGEND statementin conjunction with the graphics option OFFSHADOW=(x,y).
The value of x determineshow far the shadow or block extends to the right (positive numbers) or tothe left (negative numbers) of the legend. The value of ydetermines how far the shadow or block extends above (positive numbers) orbelow (negative numbers) the legend. If OFFSHADOW=(0,0) is specified, theshadow or block is not visible.
By default, OFFSHADOW=(0.0625, -0.0625) IN; that is,the shadow or block extends 1/16th of an inch to the right and 1/16th of aninch below the legend.
Previous Page | | | Next Page | | | Top of Page |