Image: _read

Image: _read

Reads an image from an external file, SAS catalog, or device and displays it in an image object

Syntax
Details
Example

Syntax

CALL NOTIFY (image-name, '_read', pathname<, 'attributes'>CALL NOTIFY (image-name, '_read', devicename, 'DEVICE=CAMERA|SCANNER<attributes>);

Argument Type Description

pathname
C the name of the external file containing the image or the path string returned by the LNAMEMK function

devicename
C the name of a camera or scanner:

'KODAKDC40' Kodak DC 40 camera (available only under the Windows 95 operating system)

'HPSCAN' HP Scanjet scanners (available only under Windows 95, Windows 32S, and HP/UX operating systems)

If you specify a device name, you must use the DEVICE= attribute to indicate the type of device.

attributes
C file- or device-specific attributes.

Argument	Type	Description
pathname	C	the name of the external file containing the image or the path string returned by the LNAMEMK function
devicename	C	the name of a camera or scanner:
		'KODAKDC40'	Kodak DC 40 camera (available only under the Windows 95 operating system)
		'HPSCAN'	HP Scanjet scanners (available only under Windows 95, Windows 32S, and HP/UX operating systems)
		If you specify a device name, you must use the DEVICE= attribute to indicate the type of device.
attributes	C	file- or device-specific attributes.

Details

You can specify the file directly (using its physical filename path), or by using the information returned on a previous LNAMEMK function call. The LNAMEMK function allows creation of a single character variable that contains location information about the image (even if it resides in a SAS catalog) as well as other image attributes.

Example

This example reads an image stored in a SAS catalog by using the path string defined with an LNAMEMK function:

fullpath=lnamemk(5,'sashelp.imagapp.gfkids',
                'format=cat');
call notify ('imageview', '_read_',
              fullpath);

This example reads an image from an external file:

call notify ('imageview', '_read_', '/usr
             /images/color/sign.tif');

This example scans a document:

call notify ('imageview', '_read_', 'hpscan',
             'device=scanner dpi=100');

Chapter Contents
Previous
Next
Top of Page