ISXCTL

GDDM V3R2 Base Application Programming Reference

ISXCTL

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To set extended image quality control parameters.


   ISXCTL      (device, count-1, array-1, count-2, array-2)

   APL code               183
   GDDM RCP code          X'0C300003' (204472323)

Parameters

device (specified by user) (fullword integer)
The image to which the call applies. Possible values are:

-1

Scanner

0

Current page

count-1 (specified by user) (fullword integer)
The number of elements in array-1, from 0 through 4.

array-1 (specified by user) (an array of fullword integers)
The limit, or limits, of approximation allowed for transforms. If a given transform element cannot be performed exactly by a device, then GDDM may approximate the function, within the limit, or limits, specified, to match the device's capability. The array elements have the following meanings:

1 Process all extractions

Specifies whether all extractions are to be processed. Possible values are:

-1

Unchanged (default if element not included)

0

Don't care

1

Yes

2 Honor scaling algorithm

Specifies whether the scaling algorithm is to be used. Possible values are:

-1

Unchanged (default if element not included)

0

Don't care

1

Yes

3 Emulate overlapped rectangles

Specifies whether overlapped rectangles are to be emulated. Possible values are:

-1

Unchanged (default if element not included)

0

Don't care

1

Yes

4 Avoid image size rounding

Specifies whether the size of extractions are to be rounded to meet the requirements of the source device (scanner). Possible values are:

-1

Unchanged (default if element not included)

0

Don't care

1

Yes

count-2 (specified by user) (fullword integer)
The number of elements in array-2, from 0 through 2.

array-2 (specified by user) (array of short floating-point numbers)
The limit, or limits, of approximation allowed for transforms. If a given transform elements cannot be performed exactly by a device, then GDDM may approximate the function, within the limit, or limits, specified, to match the device's capability. The array elements have the following meanings:

1 lower scaling limit

-1.0

Unchanged (default if element not included)

0.0-1.0

Scale factor lower multiplier

2 upper scaling limit

-1.0

Unchanged (default if element not included)

1.0

Scale factor upper multiplier

Description

Specifies the picture quality acceptable to the application, for the current page or scanner device.

This call allows individual setting of the quality control parameters described in ISCTL.

This call cannot be issued while image entry or retrieval is initialized for the page or scanner specified.

ISXCTL and ISCTL set the same image control parameters. ISXCTL partially or wholly updates values previously set by ISCTL, or the default values. ISCTL sets all of the image control parameters, and therefore overrides the effects of any previous call to ISXCTL.

Principal errors

ADM3386 E: CALL NOT ALLOWED DURING GET/PUT SEQUENCE
ADM3455 E: DEVICE n IS INVALID
ADM3457 E: COUNT_n1 n2 IS INVALID
ADM3458 E: INVALID VALUE f FOR ARRAY_n1, ELEMENT n2

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