Commands Used with the IMGCTRL, IMGOP and PICFILL Functions

EXECLIST

Executes a list of commands

Syntax
Details
Example

Syntax

rc=IMGOP(task-id, 'EXECLIST', commandlist-id);

region-id=PICFILL(graphenv-id, type, ulr, ulc,
lrr, lrc, source<, 'EXECLIST'<, arguments>>);

commandlist-id

contains the identifier of the SCL list of commands to pass and execute. The commands are processed as the task starts. A value of zero means that no list is passed.

Type: Numeric

Details

EXECLIST provides a mechanism for sending multiple commands to be processed at one time. If your program includes the same set of commands several times, you can fill an SCL list with those commands and then use EXECLIST to execute the commands.

Example

Create an SCL list that consists of two sublists. Each sublist contains one item for a command name and one item for each command argument.

length rc 8;
init:
   task-id=imginit(0);
   main_list=makelist(0, 'G');

   sub_list1=makelist(0, 'G');
   main_list=setiteml(main_list, sub_list1, 1, 'Y');
   sub_list1=setitemc(sub_list1, 'WSIZE', 1, 'Y');
   sub_list1=setitemn(sub_list1, 500, 2 , 'Y');
   sub_list1=setitemn(sub_list1, 500, 3 , 'Y');

   sub_list2=makelist(0, 'G');
   main_list=setiteml(main_list, sub_list2, 2, 'Y');
   sub_list2=setitemc(sub_list2, 'WTITLE', 1, 'Y');
   sub_list2=setitemc(sub_list2, 'EXECLIST example',
       2, 'Y');
   rc=imgop(task-id, 'EXECLIST', main_list);
return;

main:
return;
term:
   rc=imgterm(task-id);
return;

Top of Page