." Text automatically generated by txt2man
.TH cocoaprint  "12 May 2013" "" ""
.SH NAME
\fBcocoaprint \fP- Native printing dialogs on OS X
\fB
.SH SYNOPSIS
.nf
.fam C

\fBpackage\fP \fIrequire\fP \fIcocoaprint\fP

\fIcocoaprint\fP::pagesetup \fIparent?\fP?

\fIcocoaprint\fP::print \fIfile?\fP? \fIparent?\fP? 


.fam T
.fi
.fam T
.fi
.SH DESCRIPTION

The \fIcocoaprint\fP \fBpackage\fP allows a Tcl/Tk application to configure a printer and print data using Mac-native print dialogs. It prints by sending a PDF \fIfile?\fP directly to the chosen printer. The \fBpackage\fP does not provide support for generating PDF data. 
.PP
\fIcocoaprint\fP::pagesetup \fIparent?\fP: This command returns a Mac-native page setup dialog for configuring a printer. It takes a \fIparent?\fP window name as an argument; specifying a \fIparent?\fP window will run the dialog as a window-modal Mac "sheet" dialog, and passing an empty string such as {} will run the dialog as a toplevel window.
.PP
\fIcocoaprint\fP::print \fIfile?\fP \fIparent?\fP: This command returns a Mac-native print dialog for initiating a print job. It takes a path for a PDF \fIfile?\fP, and a \fIparent?\fP window name, as arguments. Specifying a \fIparent?\fP window will run the dialog as a window-modal Mac "sheet" dialog, and passing an empty string such as {} will run the dialog as a toplevel window.
.SH LIMITATIONS

The \fIcocoaprint\fP \fBpackage\fP does not provide support for generating PDF data; that is the responsibility of the application using the library. As a Unix variant,
.TP
.B
Mac OS X includes several standard command-line tools for generating PostScript, such as "enscript," and Tk's canvas widget can also generate PostScript.
OS X includes a command-line tool, "pstopdf," which converts PostScript files to PDF format. 
.SH KEYWORDS

printing, Mac, Cocoa
