ArborX

tprint

Longname: tprint  Open the Documentation Legend
Released: not available 
Created: not available 
Last modified: 7.12a 
See also: printer device tdpctrl tdplevel tfprint

Summary
 Prints the specified range of pages from a 3B2 document to the current print device (either the default printer, the printer specified with the --p command line switch, or a printer specified with the printer macro.)
Example extract

The example below prints the current page at 70% of its true size (the reduction from A3 to A4) using a printer control stream called pc1. It uses wdb to get the current page number from the Go to page dialogue box, which is then used within the macro as a variable.

 (wdb "Pg"):(tpgoto):(tprint ^pg,^pg,1,70,1,0,"pc1"^)

Syntax (7.76)
tprint Ø
tprint ( ( start_page:p  `,´ end_page:p? ) | page_range:s ) [  `,´ copies:n [  `,´ size_percent:f [  `,´ yx_ratio:f [  `,´ all_l_r:n [  `,´ pctrl:t [  `,´ print_file:s  `,´ view_no:n?  `;´ file_freq:n? ]?  ]?  ]?  ]?  ]?  ]? 
Ø Displays the Print Document dialogue box.
start_page:p

The start page in the the range of pages to be printed, defaulting to the current page. If start_page is higher than end_page, the pages will be printed in reverse order.
end_page:p

The end page in the range of pages to be printed, defaulting to the current page. If start_page is higher than end_page, the pages will be printed in reverse order.
page range:
Version specific information7.05a 

The listing of pages and/or range of pages to print. The elements in the list are separated by commas or spaces. The syntax for the page numbers is as follows: "num" for a page number, "num..num" or "num-num" for a range of pages. The two types of page numbers (.. or -) can be used in the same command. Printing a range or individual pages in a different order to the normal progress of printing is also possible.
copies:n
default: 1

The number of copies of each page to print, by default 1. If it is more than 1 then each page will be printed the given number of times before the next page is processed.
size_percent:f

The percentage size to print at. A common mistake is to follow this with a % symbol, which is not necessary.
yx_ratio:f
default: 1.0

Can be used to scale the height of the page differently. This compensates for plastic plate stretching when placed on a roller. The default value is 1.0, which does not make any adjustment.
all_ l_r:

Designate the orientation of pages to be printed.

0  Print all pages
1  Print only right hand pages
2  Print only left hand pages.
pctrl:t

The name of the printer control stream to use, if any.
print_file:s

The name of a file or printer port (e.g. lpt1, com1) to print to. You can also type the name of the port into the Print Destination: edit field when using the Print document dialogue box, this is useful if you want to try printing to a port with/without renaming it in your startdos.3ad file as discussed under device.

On Windows systems, if the first character of print_file is a '@' character then it represents the name of a Windows printer. A list of printers (without the '@') can be obtained using the tflist macro with mode 7.

When printing to a file using the dialogue, 3B2 prepends the "{@}" area name to the default filename that is to be printed. This area is initialised to the 3B2 directory, '/3d'. From version 5.20, each printer driver can print to its own area. For example, by defining an area name called "print_ps", then the postscript driver will prepend all its default filenames with "{print_ps}", instead of "{@}".

So to set areas for other printer drivers, you would define an area name corresponding to the drivers default extension, e.g. the TIFF driver which has the default extension ".tif" would need to have an area called "print_tif" defined, (see also../3d/areas.3d).
view_no:n

The alternate view number you wish to print. Note all other parameters must be included even if they are blank strings or zero. (see also tpgoto).
file_freq:n Not implemented.
For information on setting print driver/device options please see printer.

Document created on 2001-Jan-01, last reviewed on 2002-Sep-04 (revision 001)