Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Print(special file)					   Print(special file)

NAME
       Print --	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 inquisitive argument.

       The contents argument is	the contents of	the document.  If  this	 argu-
       ment is unset (in other words, has a value of (char *)0), then the con-
       tents of	the document are in the	file named in the message's  file  at-
       tribute.	  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 han-
       dler 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 carries 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 con-
       sidered 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 register for, and
       help process, this message.

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

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 ISO C standard.

       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 process-
       ing 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  at-
		 tribute 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.

							   Print(special file)

NAME | SYNOPSIS | DESCRIPTION | APPLICATION USAGE | EXAMPLES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Print&sektion=4&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help