*PICT (PRTPAGE)

PLBCMP GUI Only

(1) *PICT={top}:{bottom}:{left}:{right}:{pic}

(2) *PICT={top}:{bottom}:{left}:{right}:{jpgimage}

This list control creates a rectangle bounded by {top}:{bottom}:{left}:{right} around the graphics image. The image is resized up or down to fit the rectangle. {pic} is a PICT object variable as shown in format (1). The {jpgimage} is a Character String Variable or Literal that contains the file name of a JPG image file used in format (2).

Note:

1. The {jpgimage} file must be a JPG image file in compliance to the guidelines defined in the standard PDF specifications.

2. The {jpgimage} can be a fully qualified name of the physical image file containing the JPG image data. The {jpgimage} physical file must exist on the same OS file system where the PLB runtime is executing.

3. This *PICT control syntax using the {jpgimage} is supported by all PLB runtimes including Linux\Linux runtime.

4. When using a PL/B Web Server runtime, the *PICT control must use the syntax format (2). In this case, the {jpgimage} file must be located in the current working directory of the PWS server or it must be a fully qualified 'path+filename' for the image.

5. The PRTPAGE *PICT control syntax format (2) can only be used when the output is directed to the Sunbelt 'pdf:' device. Otherwise, the control syntax format (2) operation is ignored.

Example:

PF PFILE

.

       PRTOPEN PF, "pdf:", "mydoc.pdf"

       ...

       PRTPAGE PF; *PICT=1:10:1:10:"prod.jpg"

In this case, the "prod.jpg" image must exist in the current working dirctory of the PLB runtime. Otherwise, PLB runtime uses the PLB_PATH to locate the JPG image.

       ...

       PRTPAGE PF; *PICT=1:10:1:10:"c:\temp\prod.jpg"

See Also: List Controls (PRTPAGE), PRTPAGE