IMAGE Function

Displays an image in the graphics output from the current (X,Y) coordinates to the (X, Y) coordinates that are associated with the IMGPATH variable.

Updates:

XLAST, YLAST

Syntax

Details

Syntax

FUNCTION='IMAGE';

Associated Variables

HTML='link-string': specifies the text that defines the link for drill-down.

IMGPATH= 'external-file': specifies the image file to be displayed in the graphics output. The syntax of external file specifications varies across operating environments.

Note:Copying and pasting the image works only if an absolute path is specified instead of a relative path, or if the file into which the image is being pasted is opened from the directory to which the image is relative.

STYLE = 'TILE' | 'FIT';: specifies how the image is to be applied to fill the specified area of the graphics output. The default value of TILE replicates the image to fill the area. The FIT value stretches a single instance of the image to fill the area.

X=horizontal-coordinate;: specifies the horizontal coordinate that determines the size of the image displayed in the graphics output.

Y=vertical-coordinate;: specifies the vertical coordinate that determines the size of the image displayed in the graphics output.

Z=depth-coordinate;: specifies the depth coordinate for 3–D output.

ZSYS='coordinate-system': specifies the coordinate system for the Z variable. See ZSYS Variable for an explanation of coordinate-system.

Details

The following example shows how the IMAGE function adds a single stretched instance of an image to the graphics output, beginning at the current coordinates and ending at the specified coordinates:

x=10; y=5; function="move"; output;
x=35; y=15; imgpath="/images/gifs/picture.gif";
style="fit";
function="image"; output;

For a list of the file types that you can use, see Image File Types Supported by SAS/GRAPH.