SAS Component Language Dictionary |
Starts an image task
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
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.
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');
Copyright © 2009 by SAS Institute Inc., Cary, NC, USA. All rights reserved.