Sets device-specific information in the DUMP DEVICE IS device. The param array must be a one dimensional INTEGER array. The number of elements required depends on the device driver. The first element is the operation number and the subsequent elements are the values associated with that operation.
For the dump drivers, code 106, operation 1 is used to specify a portion of the screen to dump when DUMP GRAPHICS is executed. The syntax is:
GESCAPE PRT,106,param(*)
The param array must be a one dimensional INTEGER array of five elements. The first element is the operation number. The remaining elements specify the boundary for the DUMP. The boundary is specified in screen units:
param(1) - 1
param(2) - Beginning row
param(3) - Ending row
param(4) - Must be 0
param(5) - Must be 0
The row parameters will revert back to the default of full screen if any of the following conditions occur:
1. Beginning row greater than ending row
2. A new Plotter, Graphics, or Dump driver is loaded
3. A GINIT, SCRATCH A, PLOTTER IS, GRAPHICS INPUT, or CONFIGURE DUMP commands are executed, or a Basic reset is performed.
The CONFIGURE DUMP statement must be executed before the GESCAPE statement. The following program demonstrates this capability:
10 INTEGER A(1:5)
20 DUMP DEVICE IS PRT
30 CONFIGURE DUMP TO "PCL"
40 A(1)=1 ! operation code, always 1
50 A(2)=100 ! begin row, screen units
60 A(3)=300 ! end row, screen units
70 A(4)=0 ! reserved, must be 0
80 A(5)=0 ! reserved, must be 0
90 GESCAPE PRT,106,A(*)
100 FRAME
110 MOVE 0,0
120 DRAW 100,100
130 DUMP GRAPHICS
140 END
