Table of Contents
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. 
 
- inputfile 
- A file that contains one or more wrap definitions.
 pswrap  transforms the definitions 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 wrap.  
- -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  compilers, 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. 
- -f specialHFile 
- Adds a #include to the generated source
file for a special header file. 
- -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 prototypes.
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  written. 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 syntax.  
- -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., 1993). 
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.
Table of Contents