Print(4)

Print(4)	 DEVICES AND NETWORK INTERFACES		 Print(4)

NAME
     Print request - print a document

SYNOPSIS
     [file] Print(in mediaType contents,
		  in boolean inquisitive,
		  in boolean covert
		  [in title docName]);

DESCRIPTION
     The Print request causes the handler to  print  a	document.
     The  handler  must	 act  as if the	user had issued, (via the
     handler's	user  interface)  either  a  ``Print   One''   or
     ``Print...'' command, depending on	the value of the inquisi-
     tive argument.

     The contents argument is the contents of the  document.   If
     this  argument  is	 unset	(in  other  words, has a value of
     (char *)0), then the contents of the  document  are  in  the
     file  named  in the message's file	attribute.  The	data type
     (mediaType) of  the  contents  argument  should  be  string,
     unless  nulls  are	 valid	in the given media type, in which
     case the data type	must be	bytes.

     The inquisitive  argument	is  a  boolean	value  indicating
     whether  the handler is allowed to	block on user input while
     carrying out the request.	However, even if  inquisitive  is
     True, the handler is not required to seek such input.

     The covert	argument is a boolean  value  indicating  whether
     the  handler may make itself apparent to the user as it car-
     ries out the request.  If False, the recipient need not make
     itself apparent.

     If	both the inquisitive argument and the covert argument are
     True,  the	recipient should attempt to limit its presence to
     the minimum needed	to receive any user  input  desired;  for
     example, through iconification.

     The docName argument contains the name of the document.   If
     the  docName  argument  is	 absent	and the	file attribute is
     set, the file name	is considered to  be  the  title  of  the
     document.	 This  string  would be	suitable for display in	a
     window title bar, for example.

APPLICATION USAGE
     The ttmedia_ptype_declare(3) function can be used to  regis-
     ter for, and help process,	this message.

     This message can be sent with the ttmedia_load(3) function.

Unix System LaboratorLast change: 13 May 1994			1

Print(4)	 DEVICES AND NETWORK INTERFACES		 Print(4)

EXAMPLES
     To	print a	PostScript document, the application can  send	a
     request of	the form:

	  Print(in PostScript contents,
		in boolean inquisitive,
		in boolean covert);

     with a first argument whose value is a vector of bytes  such
     as:

	  %!\n/inch {72	mul} def...

     The \n in the example represents the newline character.  The
     notation is the same as in	the .

     To	print a	PostScript document  contained	in  a  file,  the
     application  can  send  the Print request as above, with the
     file attribute set	to the relevant	file and with  the  value
     of	the first argument not set.

ERRORS
     The ToolTalk service may return one of the	following  errors
     in	processing the Print request:

	TT_DESKTOP_ENOENT
	      The file that was	alleged	to contain  the	 document
	      does not exist.

	TT_DESKTOP_ENODATA
	      The in-mode contents argument had	no value and  the
	      file attribute of	the message was	not set.

	TT_MEDIA_ERR_FORMAT
	      The document is not a valid instance of  the  media
	      type.

SEE ALSO
     ttmedia_ptype_declare(3), ttmedia_load(3);	Intro, Status
     requests.

Unix System LaboratorLast change: 13 May 1994			2