PICT

PLBCMP GUI Only

The PICT instruction defines an object variable for a standard picture resource or file. PICTs are visual devices that also support drag/drop and clipboard operations. To define a PICT, use one of the following statement formats:

(1)	[label]	PICT	[%]
(2)	[label]	PICT	(arraysize)
(3)	[label]	PICT	^
(4)	[label]	PICT	^,{target}
(5)	[label]	PICT	^(arraysize)
(6)	[label]	PICT	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

A PICT contains no items.
The PICT is always referenced as item number zero.
Seven different image formats are supported including BMP, PCX, DCX, JPEG, GIF, TIFF and PNG (9.9B). For JPEG files, only the JFIF format is supported.
The PICT object DIB ( Device Independent Bitmap ) images do not support any 32 bit color images.
Supported TIFF formats are embedded JPEG in JFIF format, CCITT Group 1, CCITT Group 4, Packbytes, LZW, and Packbits.
Multi-dimension arrays are supported to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a PICT may be defined as Global, it is DESTROYed during a CHAIN instruction.
The runtime accepts an ALT-Left mouse button sequence that allows a PICT object hand drag operation. This provides a means of scrolling a picture without using the scrollbars
The PNG image is the only image that supports 'Transparent' colors. The PNG transparent color support is implemented as follows:

When the PNG color types include a default background color type, this image default background color replaces image full transparent pixels encountered as the image is converted into a PICT DIB image.
When the PNG color types include a default background color type, the PICT 'BACKSTYLE=$TRANSPARENT' property forces the PICT BGCOLOR background color to replace image full transparent pixels encountered as the image is converted into a PICT DIB image. The PICT 'BACKSTYLE=$TRANSPARENT' property is only used for PNG images and it is ignored for all other image formats.
When the PNG color types do not include a default background color type, the PICT BGColor property value replaces the PNG image full transparent pixels that are encountered as the image is converted into a PICT DIB image.
PNG 'partial transparent' composite image merging is not supported.
PNG Adam7 interlacing is not supported when the PNG color bit depth is less than 8 bits. In this case, an O103 object error is expected when the PICT is being created.