PDF GETFILE and GETINFO Notes
9.6A
The format of the GETFILE instruction is as follows:
Note the following:
The PRTNAME keyword returns a 'pdf:' name for a PFILE that has been opened using the 'pdf:' device name.
The 'GETFILE PRTNAME=' instruction is supported for all clients and runtimes including PLBCLIENT, PLB (Linux), PLBSSERVE (Windows and Linux), PLBWIN, and PLBNET.
The format of the GETINFO instruction is as follows:
Note the following:
The GETINFO instruction is not supported when using a Linux runtime.
The 'GETINFO FONTS' instruction is supported for Windows PLBCLIENT clients and for PLBWIN\PLBNET runtimes.
The 'GETINFO TYPE={font},,PRINTER=' instruction is supported for Windows PLBCLIENT clients and for PLBWIN\PLBNET runtimes.
The 'GETINFO TYPE={pfile}' instruction is supported and can be executed for all supported runtimes and clients.
When a PFILE has been opened for a 'pdf:' device, the GETINFO PFILE instruction returns the data as relating to the Sunbelt PDF device.
This table shows the expected values returned when a 'pdf:' device is opened in a PFILE used in a 'GETINFO TYPE={pfile}' instruction. The '(xxx)' indicates the expected results when a 'pdf:' device is being used.
|
Column |
Size |
Comment |
|
1 |
8 |
Current Sunbelt PDF version level (Value = 1) |
|
9 |
8 |
Page width in current print Units |
|
17 |
8 |
Page height in current print Units |
|
25 |
8 |
Page width in millimeter Units |
|
33 |
8 |
Page height in millimeter Units |
|
41 |
8 |
Number of color bits per pixel (Value = 24) |
|
49 |
8 |
Number of PDF specific fonts (Value = 5) |
|
57 |
1 |
Can draw pictures? (Y or N) (Value = Y) |
|
58 |
4 |
Number of copies (Value = 1) |
|
62 |
1 |
Print all PDF pages (Value = Y) |
|
63 |
1 |
Print selection only (Value = N) |
|
64 |
8 |
Print dialog start page (Value = 1) |
|
72 |
8 |
Print dialog end page (Value = 32000) |
|
80 |
1 |
Print alignment right (Y or N) |
|
81 |
1 |
Print alignment decimal (Y or N) |
|
82 |
1 |
Fill On Enabled (Y or N) |
|
83 |
1 |
Pict Rectangle Enabled (Y or N) |
|
84 |
1 |
Overlay Enabled (Y or N) |
|
85 |
4 |
Number of characters in Printer Name (Value = 4) |
|
89 |
31 |
Printer Name (Value = 'pdf:') |
|
120 |
110 |
All values are returned as '0'. |
|
230 |
8 |
Current vertical print position |
|
238 |
8 |
Current horizontal print position |
|
246 |
4 |
Current print units |
|
250 |
8 |
Current print character height in pixels |
|
258 |
8 |
Current print character width in pixels |
|
266 |
8 |
Current vertical print position in PFILE Units. |
|
274 |
8 |
Current horizontal print position in PFILE Units. |
When the 'GETINFO TYPE={font},,PRINTER=PFILE' instruction is execute where the PFILE is opened for the 'pdf:' device, the PL/B runtimes use the Windows Default printer to establish a 'Printer Device Context' which retrieves the printer {font} metrics. In addition, if the SETMODE keywords named *PDFDEFPRTMETRICS and *PDFDEFPRTNAME are used, this 'GETINFO TYPE={font},,PRINTER=PFILE' instruction first attempts to use the Windows Printer specified by these SETMODE keywords to retrieve the printer {font} metrics.
See Also: PDF Support, Printer Instructions
|
|