SAS Component Language Dictionary

IMGINIT

Starts an image task

Category:

Image

Syntax
Details
Example

Syntax

task-id=IMGINIT(<list-id>,<option>);

task-id

contains the identifier for the image task. This identifier is used by other SCL image functions.

Type: Numeric

list-id

contains the identifier for an SCL list that contains image operation (IMGOP) and image control (IMGCTRL) commands to pass to the function. The commands are processed as the task starts. For command descriptions, see Commands Used with IMGCTRL and Commands Used with the IMGCTRL, IMGOP and PICFILL Functions.

A value of zero means that no list is passed.

Type: Numeric or List

option

specifies a window option:

'NODISPLAY': prevents the Image window from being created. This can be useful in SCL programs that read, process, or write images without displaying them.
'TOPWINDOW': causes the Image window to stay on top of the FRAME or SCL window when it is created.

Type: Character

Details

The IMGINIT function initializes the image environment. This usually means opening the Image window, but you must use this function even if you plan to manipulate images without displaying them.

When you initialize the Image window, the list that you pass to IMGINIT can include commands to initialize the window size.

Example

Initialize the Image window size:

width=700;
height=520;
xpos=0;
ypos=0;

cmdid=makelist();
allcmdid=makelist();
rc=insertc(cmdid,'WSIZE',-1);
rc=insertn(cmdid,width,-1);
rc=insertn(cmdid,height,-1);
rc=insertn(cmdid,xpos,-1);
rc=insertn(cmdid,ypos,-1);
rc=insertl(allcmdid,cmdid,-1);

taskid=imginit(allcmdid,'TOPWINDOW');

Start the image task without displaying the Image window:

taskid=imginit(allcmdid,'nodisplay');

Top of Page