2.3.5.1 Reset Picture List/Type (%C)

The Reset Picture List/Type command is used before any other picture commands. This command resets the picture buffer (flushes all pictures from memory) and clears the picture list.

With an argument, it changes the picture type. A picture type is specific to a Cogsys mode. Currently, there are two picture types, one for each mode:

1

640x480 pixels, 2 color, for use in Mode 1. By default displayed at location 0,0. If loaded from file, must be a PCX Version 5 file.

2

320x200 pixels, 256 color, for use in Mode 2. By default displayed at location 160, 140. If loaded from file, must be a PCX Version 5 file.

There is no default picture type. Therefore, Reset Picture List/Type must be called before any picture commands are used. By explicitly declaring picture type up front, the chance for confusion (by both user and Cogsys) is reduced.

Name:

Reset Picture List/Type.

Class:

Pictures

Code:

%C

Syntax:

%C[pictype]
pictype is 1 or 2, representing picture type

System:

Resets the picture buffer and clears the picture list.

Requires:

Although pictures will only be displayed in a graphics mode, this command will work in any mode.

History:

%C made its first appearance in Cogsys 2.9. Earlier versions had no explicit means of reseting the picture list.

Test Files:

`RPIC_T01.IN'

tests basic operation

Examples:

input

%M2%C2%Q[mypics.txt]#B[1,20]@C

cogsys

Switches to Mode 2, and sets picture type to 2. The %Q command then loads up the PCX Version 5 picture files given in the list file `mypics.txt'. Now the #B command displays the first image for 20 milliseconds at the default position for a Type 2 picture, (160,140), the center of the screen. Finally, the screen is cleared with a call to @C.