*GRAYSCALE (GETMODE)

PLBCMP Only

*GRAYSCALE={value}

The *GRAYSCALE list control reports the state of the gray scaling algorithm used by the runtime.

When the {value} returned is zero, gray scaling is disabled or turned off. When the {value} returned is non-zero, gray scaling is enabled or turned on. {value} must be a Numeric Variable.

The runtime implements a gray scaling algorithm when displaying a black and white picture and the picture is being scaled to less than 100% and more then 10%. In addition, if the picture is scaled to less than 50%, a Floyd-Steinberg Error Diffusion Half Toning algorithm is implemented to smooth picture roughness. These changes are implemented to improve black and white pictures that are being displayed directly via PLB language instructions.

Gray scaling is enabled by default by the runtime. The SETMODE *GRAYSCALE list control allows a user to turn gray scaling off if needed.

See Also: List Controls (GETMODE), GETMODE