Unix/Linux Go Back    

RedHat 9 (Linux i386) - man page for pswrap (redhat section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

PSWRAP(1)										PSWRAP(1)

       pswrap - creates C procedures from segments of PostScript language code

       pswrap [ -apr ] [ -o outputCfile ] [ -h outputHfile ] [ -s maxstring ] inputfile

       pswrap reads input from inputfile and creates C-callable procedures, known as wraps, that
       send PostScript language code to the PostScript interpreter.  inputfile contains segments
       of PostScript language code wrapped with a C-like procedure syntax.

       Wraps are the most efficient way for an application to communicate with the PostScript
       interpreter. For complete documentation of pswrap and the language it accepts, see "pswrap
       Reference Manual" in Programming the Display PostScript System with X.

	      A file that contains one or more wrap definitions.  pswrap transforms the defini-
	      tions in inputfile into C procedures. If no input file is specified, the standard
	      input (which can be redirected from a file or pipe) is used. The input file can
	      include text other than wrap definitions.  pswrap converts wrap definitions to C
	      procedures and passes the other text through unchanged. Therefore, it is possible
	      to intersperse C-language source code with wrap definitions in the input file.

	      Note: Although C code is allowed in a pswrap input file, it is not allowed within a
	      wrap body. In particular, no CPP macros (for example, #define) are allowed inside a

       -a     Generates ANSI C procedure prototypes for procedure definitions in outputCfile and,
	      optionally, outputHfile.	The -a option allows compilers that recognize the ANSI C
	      standard to do more complete type checking of parameters. The -a option also causes
	      pswrap to generate const declarations.

	      Note: ANSI C procedure prototype syntax is not recognized by most non-ANSI C com-
	      pilers, including many compilers based on the Portable C Compiler. Use the -a
	      option only in conjunction with a compiler that conforms to the ANSI C Standard.

       -h outputHFile
	      Generates a header file that contains extern declarations for non-static wraps.
	      This file can be used in #include statements in modules that use wraps. If the -a
	      option is specified, the declarations in the header file are ANSI C procedure pro-
	      totypes. If the -h option is omitted, a header file is not produced.

       -o outputCFile
	      Specifies the file to which the generated wraps and passed-through text are writ-
	      ten. If omitted, the standard output is used. If the -a option is also specified,
	      the procedure definitions generated by pswrap are in ANSI C procedure prototype

       -p     Specifies that strings passed by wraps are padded so that each data object begins
	      on a long-word (4-byte) boundary. This option allows wraps to run on architectures
	      that restrict data alignment to 4-byte boundaries and improves performance on some
	      other architectures.

       -r     Generates reentrant code for wraps shared by more than one process (as in shared
	      libraries). Reentrant code can be called recursively or by more than one thread.
	      The -r option causes pswrap to generate extra code, so use it only when necessary.

       -s maxstring
	      Sets the maximum allowable length of a PostScript string object or hexadecimal
	      string object in the wrap body input. A syntax error is reported if a string is not
	      terminated with ) or > within maxstring characters.  maxstring cannot be set lower
	      than 80; the default is 200.

       Programming the Display PostScript System with X (Addison-Wesley Publishing Company, Inc.,

       Adobe Systems Incorporated

       PostScript and Display PostScript are trademarks of Adobe Systems Incorporated which may
       be registered in certain jurisdictions.

       Copyright (c) 1988-1994 Adobe Systems Incorporated.  All rights reserved.

Adobe Systems				    4 Apr 1994					PSWRAP(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 09:22 PM.