Legend SCSI & RAID Devices Driver



Sane-Supported Scanners

This appendix provides a list of scanners supported by Sane 1.0.1.

Legend

You need to enable this backend in Sanes dll.conf (in the sane config directory). Otherwise, Sane will not enable your scanner.

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 find-scanner to find out more about the notes.)

Manufacturer

Model

Backend

Status

Comment

Abaton

Scan 300/GS

abaton

alpha

All known modes and functions supported


Scan 300/S

abaton

alpha

Untested, use with caution

AGFA

Focus GS

agfafocus

alpha

6 bit gray


Focus Lineart

agfafocus

alpha

Lineart only? Untested


Focus II

agfafocus

alpha

Gray only


Focus Color

agfafocus

alpha



Focus Color Plus

agfafocus

alpha

3-pass


Arcus II

microtek

beta

Arcus *II*, not Arcus!


StudioScan II

microtek

beta

Not quite functional yet


StudioScan IIsi

microtek

beta

Not quite functional yet


SnapScan 300

SnapScan

alpha

Only 8 bits/sample


SnapScan 310

SnapScan

alpha

Only 8 bits/sample


SnapScan 600

SnapScan

alpha

Only 8 bits/sample


SnapScan 1236s

SnapScan

alpha

Only 8 bits/sample

Apple

Apple Scanner

apple

alpha

4 bit, 16 shades of gray


OneScanner

apple

alpha

8 bit, 256 shades of gray; backend needs more work


ColorOneScanner

apple

alpha

Only non-color modes

Artec/Ultima

AT3

artec

alpha

Works (developer's own model)


A6000C

artec

alpha

Very alpha


A6000C PLUS

artec

alpha

Testing in progress


AT6

artec

alpha

Testing in progress


AT12

artec

alpha

Testing in progress

BlackWidow

BW4800SP

artec

alpha

Rebadged Artec AT3

Canon

CanoScan 300

canon

alpha

1 pass; flatbed scanner


CanoScan 600

canon

alpha

1 pass; flatbed scanner


CanoScan 2700F

canon

alpha

1 pass; film scanner

Escom

Image Scanner 256

umax

stable

SCSI-ID=UMAX UG 80

Epson

GT-5500

epson

?

OK


GT-7000

epson

?

OK

HP

HP ScanJet Plus

hp

alpha



HP ScanJet IIc

hp

alpha



HP ScanJet IIp

hp

alpha



HP ScanJet IIcx

hp

alpha



HP ScanJet 3c

hp

alpha



HP ScanJet 4c

hp

alpha



HP ScanJet 6100C

hp

alpha



HP ScanJet 3p

hp

alpha



HP ScanJet 4p

hp

alpha



HP ScanJet 5p

hp

alpha



HP ScanJet 6200C

hp

alpha



HP ScanJet 6250C

hp

alpha



HP PhotoSmart PhotoScanner

hp

alpha


Kodak

DC20

dc25

alpha

DC-20 is untested!


DC25

dc25

alpha



DC210

dc210

alpha


Linotype Hell

Jade

umax

stable

SCSI-ID=LinoHell Office


Jade2

umax

stable

SCSI-ID=LinoHell Office2


Saphir

umax

stable

Not tested


Saphir2

umax

stable

SCSI-ID=LinoHell SAPHIR2


Saphir Ultra

umax

stable

Not tested


Saphir Ultra II

umax

stable

Not tested


Saphir HiRes

umax

stable

Not tested


Opal

umax

stable

Not tested


Opal Ultra

umax

stable

Not tested

Microtek

ScanMaker E6

microtek

beta



ScanMaker E3

microtek

beta



ScanMaker E2

microtek

beta

3-pass


ScanMaker 35t+

microtek

beta

Slide-scanner


ScanMaker III

microtek

beta



ScanMaker IISP

microtek

beta



ScanMaker IIHR

microtek

beta

3-pass


ScanMaker IIG

microtek

beta

Gray only


ScanMaker II

microtek

beta

3-pass


ScanMaker 600Z(S)

microtek

beta

Untested


ScanMaker 600G(S)

microtek

beta

Gray only


ScanMaker V300

microtek2

alpha



ScanMaker V310

microtek2

alpha



ScanMaker V600

microtek2

alpha



ScanMaker E3plus

microtek2

alpha



ScanMaker X6

microtek2

alpha



ScanMaker X6EL

microtek2

alpha



ScanMaker 330

microtek2

alpha



ScanMaker 630

microtek2

alpha



ScanMaker 636

microtek2

alpha



ScanMaker 9600XL

microtek2

alpha

Only flatbed mode (?)


Phantom 636

microtek2

alpha


Mustek

MFC-600S

mustek

beta

1 pass; (f/w >= 1.01; scsi id MFC-06000CZ)


MFC-600CD

mustek

beta

1 pass; (f/w >= 2.03; scsi id MFC-06000CZ)


MFS-6000CX

mustek

beta

3 pass; (f/w >= 2.71; scsi id MSF-06000CX


MSF-6000SP

mustek

beta

1 pass; (f/w >= 3.12; scsi id MSF-06000SP)


MFS-8000SP

mustek

beta

1 pass; (f/w >= 2.05; scsi id MSF-08000SP) lineart drops lines?


MFC-800S

mustek

beta

1 pass; (f/w 1.06; scsi id MFC-08000CZ) color fails?


MFS-1200SP

mustek

beta

1 pass; (f/w 1.00; scsi id MSF-12000SP)


MFS-1200SP

mustek

beta

1 pass; (f/w 1.07; scsi id MFS-12000SP)


MFS-1200SP

mustek

beta

1 pass; (f/w 1.02; scsi id MFS-12000SP) color fails?


MFS-12000CX

mustek

beta

3 pass; (f/w 2.71; scsi id MFS-12000CX)


SE-6000SP


beta

1 pass; (f/w ? ; scsi id C03 S10IDW)


SE-12000SP


beta

1 pass; (f/w 1.01; scsi id C06 S12IDW)

Nikon

LS-20

coolscan

beta

LS-30 is not supported


LS-1000

coolscan

beta

Doesn't support gamma correction


AX-210

umax

stable


Polaroid

DMC

dmc

stable


Plustek

Plustek 4830

plustek

beta


Qtronix

Sagitta Gray

sagitta

alpha

No monocrome-mode at the moment

SHARP

JX-610

sharp

new

Preview/Color Lineart/Lineart/Threshold does not work


JX-250

sharp

new

Color Lineart does not give useful output


JX-330

sharp

new

Not tested

Siemens

S9036

agfafocus

alpha

Gray only


ST400

st400

alpha

6 bit gray

Tamarack

Artiscan 6000C

tamarack

beta

3 pass, 300 DPI; please report success to R.E.Wolff@BitWizard.nl


Artiscan 8000C

tamarack

beta

3 pass, 400 DPI; please report success to R.E.Wolff@BitWizard.nl


Artiscan 12000C

tamarack

beta

3 pass, 600 DPI

UMAX

Vista S6

umax

stable



Vista S6E

umax

stable



UMAX S-6E

umax

stable



UMAX S-6EG

umax

stable



Vista-S8

umax

stable

Not tested


Supervista S-1

umax

stable



UMAX S-12

umax

stable



UMAX S-12G

umax

stable



Astra 600S

umax

stable



Astra 610S

umax

stable



Astra 1200S

umax

stable



Astra 1220S

umax

stable



UC 630

umax

stable

Version 1.6 OK, others only lineart OK


UG 630

umax

stable



UG 80

umax

stable



UC 840

umax

stable

Version 1.6 OK, others only lineart OK


UC 1260

umax

stable

Version 1.6 OK, others unknown


Mirage

umax

stable

Not tested


Mirage II

umax

stable

Not tested


Mirage IIse

umax

stable

Not tested


Vista-T630

umax

stable

OK for some firmware versions; on others only lineart


PSD

umax

stable



PowerLook

umax

stable

Not tested


PL-III

umax

stable

Only works with some scanners (unknown why)


PowerLook III

umax

stable

Not tested


PowerLook 2000

umax

stable

Not tested


PowerLook 3000

umax

stable

Not tested


Gemini D-16

umax

stable


Vobis

HighScan

microtek2

alpha

Only E3plus-based models

Vobis/Highscree

Scanboostar Premium

umax

stable

OK, SCSI-ID=LinoHell Office2

Vuego

310S

SnapScan

alpha

Close SnapScan 310-compatible




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:

Legend SCSI & RAID Devices Driver
  • 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:

  1. GUNIT= in a GOPTIONS statement

  2. the default unit,CELLS

ACROSS=number-of-columns

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
CBLOCK=block-color

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.
CBORDER=frame-color

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
CFRAME=background-color

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

CSHADOW=shadow-color

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.
DOWN=number-of-rows

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.

FRAME

draws a frame around the legend. The colorof the frame is the first color in the color list.

FWIDTH=thickness-factor

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
LABEL=(text-argument(s)) | NONE

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:

'text-string'

provides up to 256 characters of label text. Enclose each string in quotes. Separate multiple strings with blanks.

text-description-suboption

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
MODE=PROTECT | RESERVE| SHARE

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
OFFSET=(<x><,y>)<units> |(<x <units>><,y <units>>)

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
ORDER=(value-list)

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
ORIGIN=(<x><,y>)<units>| (<x <units >><,y <units>>)

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
POSITION=(<BOTTOM| MIDDLE | TOP> <LEFT | CENTER | RIGHT> <OUTSIDE | INSIDE>)

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
REPEAT=1 | 2 | 3

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.

ROWMAJOR | COLMAJOR

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=
SHAPE=BAR(width<units>,height<units>)<units> | LINE(length) <units> | SYMBOL(width<units>,height<units>)<units>

specifies the size and shape of the legendvalues displayed in each legend entry. The SHAPE= value you specify dependson which procedure generates the legend.

BAR(width,height)<units>

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.

LINE(length) <units>

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.

SYMBOL(width<units>,height<units>)<units>

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
App
VALUE=(text-argument(s) ) | NONE

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:

'text-string'

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:

text-description-suboption

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.

COLOR=text-color

specifies the color of the text. If youomit the COLOR= suboption, a color specification is searched for in this order:

  1. the CTEXT= option for theprocedure

  2. the CTEXT= option in a GOPTIONS statement

  3. the color of the default style

C=text-color
FONT=font |NONE

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:

  1. the FTEXT= option in a GOPTIONS statement

  2. the default style font,NONE

F=font |NONE
HEIGHT=text-height <units>

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:

  1. the HTEXT= option in a GOPTIONSstatement

  2. the height specified by the default style

H=text-height<units>
JUSTIFY=LEFT| CENTER | RIGHT

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
POSITION=(<BOTTOM| MIDDLE | TOP> <LEFT | CENTER | RIGHT>)

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.

POSITION

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.
TICK=n

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