2.3.5.5 Create Pictures from CXR (%I)

The Create Pictures from CXR command is the interface to the new picture generator extensions. Extensions are discussed in detail in 3. Extensions. Briefly, a Cogsys extension routine (CXR) is a file that adds capabilities to Cogsys which is only loaded when needed. As of Cogsys 3.0.15, the only extensions which exist are for generating pictures. The extensions are loaded using the Load External Routine command (2.3.1.10 Load External Routine (%X)), and are invoked with this command.

The details of the arguments and options which can be passed to a particular extension are described in the Extension User's Reference. Here we only describe that part of the syntax which is universal.

Name:

Create Pictures from CXR

Class:

Pictures

Code:

%I

Syntax:

%I[numpics, [ Ppreimage, ] args]
numpics and preimage are integers from 1 to MAX_UNIQUE_PICS, by default .

System:

Calls the currently loaded Extension numpics times with argument(s) args to create pictures. Created pictures are unnamed, and are loaded with numbers starting after the last currently loaded/created picture. preimage, if present, specifies the number of an existing picture to use as a background before the creator is invoked.

Requires:

Create Pictures from CXR requires that the extension be loaded (and that the preimage, if used, exist).

Test Files:

`PCXR_T01.IN'

tests basic operation

`PCXR_B01.IN'

benchmarks the create pictures process for some standard configurations

Examples:

input

%X[randext.cxr]%M2%C2%I[1,2,10]#B[1,20]

cogsys

Loads the extensions routine `randext.cxr', switches into Mode 2 and resets the picture list. Now %I calls the picture generator once (as specified by the 1) with arguments `2,10', which create a solid screen of green. Finally, the #B command displays the created picture.

input

%I[50,P1,3,8.9,MY FRIEND SALLY]#J[2,51,1]

cogsys

(This example does not use a real extension, included just for illustration). Here, %I calls the currently loaded extension fifty times with arguments `3,8.9,MY FRIEND SALLY', using as a preimage picture number 1 (presumably loaded or created earlier). Then, the %J command displays the created pictures (numbered 2 though 51, since one was already loaded) at a rate of one frame each.