DSCOPY

GDDM V3R2 Base Application Programming Reference

DSCOPY

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

Send transformed picture to alternate device.


   DSCOPY      (width, depth. hor-off, ver-off, count, option-array)

   APL code               909
   GDDM RCP code          X'0C180008' (202899464)

Parameters

width (specified by user) (short floating point)
The percentage width of the output area on the output medium.

depth (specified by user) (short floating point)
The percentage depth of the output area on the output medium.

hor-off (specified by user) (short floating point)
The percentage horizontal offset, from the left of the medium, of the output area on the output medium.

ver-off (specified by user) (short floating point)
The percentage vertical offset, from the top of the medium, of the output area on the output medium.

count (specified by user) (fullword integer)
The number of elements in the option-array parameter.

option-array (specified by user) (array of fullword integers)
An array of options for the DSCOPY call. There are three elements:

1 - source

Specifies which type of data to copy. Three possible values:

0: Graphics. Only the graphics field is copied to the output area (default).
1: Image. Only the image field is copied to the output area.
2: The whole page. All non-alphanumeric fields (graphics and image) are copied to the output area. .

2 - aspect ratio control

Specifies whether or not to maintain the aspect ratio of the required picture when copied to the output area. Two possible values:

0: Preserve aspect ratio of picture within output area (default).
1: Stretch picture to fit the output area.

3 - rotation

Specifies the clockwise rotation applied to the picture. Four possible values:

0

0 degrees (default)

1

90 degrees

2

180 degrees

3

270 degrees.

Description

Copies the contents of the chosen source to the current alternate device. The copied picture is sized and positioned (and rotated) according to the values specified in percentages of the target device's page (positioned to cell accuracy on cell-constrained devices). Thus, the size of the copy, in character cell units, can differ from that of the picture on the current page, and a larger picture may be obtained than would have been the case using FSCOPY.

If aspect-ratio-control value 1 is specified, the picture is "stretched" to fit the requested output area. Otherwise, the aspect ratio of the picture is preserved within the output area. If the picture has different proportions from those of the output area, this means that the picture will be smaller than the requested output area in one dimension, and centered within it.

Note: The picture displayed may be smaller than the field in which it is drawn, therefore, selecting 100% does not necessarily fill the page.

For more information about the handling of picture components during the copy process, refer to the FSCOPY call.

Notes:

1. A width or depth (but not both) of more than 100%, up to 1000%, may be specified, to allow the user to take advantage of devices which support drawings too long for a single sheet of paper (for example, roll-feed plotters). The dimension that can exceed 100% is that corresponding to the physical width after any rotation specified in the PLTROTAT processing option is applied. Thus if PLTROTAT specifies a rotation of 90 or 270 degrees, it is the depth value in this call that may exceed 100%.

Specifying a value >100% for a copy to a single-sheet device has unpredictable results.

2. The setting of GSARCC has no bearing on this call.

3. Printing or plotting processing options (procopts) that affect the size, rotation or position of the output are honoured in addition to values specified by the DSCOPY call.

4. The limitations to rotated graphics described by the GSSAGA call also apply to graphics rotated by the DSCOPY call.

Principal errors

ADM0070 E: NO ALTERNATE DEVICE
ADM0179 E: INVALID FUNCTION DURING GRAPHICS RETRIEVAL
ADM0277 E: '{FSSAVE|FSSHOW|FSSHOR|FSCOPY| GSCOPY|DSCOPY|MAPPING|DSFRCE|FSFRCE}' IS NOT SUPPORTED FOR THIS DEVICE |GSCOPY|MAPPING}' IS NOT SUPPORTED FOR THIS DEVICE
ADM0890 E: INVALID WIDTH n SPECIFIED
ADM0891 E: INVALID DEPTH n SPECIFIED
ADM0892 E: INVALID HORIZONTAL OFFSET n SPECIFIED
ADM0893 E: INVALID VERTICAL OFFSET n SPECIFIED
ADM0894 E: SUM OF WIDTH AND HORIZONTAL OFFSET n IS INVALID
ADM0895 E: SUM OF DEPTH AND VERTICAL OFFSET n IS INVALID
ADM0896 E: SOURCE TYPE n DOES NOT EXIST
ADM0897 E: SOURCE OF COPY n MUST BE IN THE RANGE 0 THROUGH 2
ADM0898 E: ROTATION VALUE n MUST BE IN THE RANGE 0 THROUGH 3
ADM0899 E: ASPECT RATIO CONTROL n MUST BE 0 OR 1

Notices | Terms of use | Support | Contact z/OS