PSWRAP(1)PSWRAP(1)NAMEpswrap - creates C procedures from segments of PostScript
language code
SYNOPSISpswrap [ -apr ] [ -o outputCfile ] [ -h outputHfile ] [ -s
maxstring ] inputfile
DESCRIPTIONpswrap 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.
OPTIONS
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 par-
ticular, no CPP macros (for example, #define) are
allowed inside a wrap.
-a Generates ANSI C procedure prototypes for procedure
definitions in outputCfile and, optionally, out-
putHfile. The -a option allows compilers that rec-
ognize 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 rec-
ognized by most non-ANSI C compilers, including
many compilers based on the Portable C Compiler.
Use the -a option only in conjunction with a
Adobe Systems 4 Apr 1994 1
PSWRAP(1)PSWRAP(1)
compiler that conforms to the ANSI C Standard.
-h outputHFile
Generates a header file that contains extern decla-
rations 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 pro-
duced.
-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). Reen-
trant 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.
SEE ALSO
Programming the Display PostScript System with X (Addison-
Wesley Publishing Company, Inc., 1993).
AUTHOR
Adobe Systems Incorporated
NOTES
PostScript and Display PostScript are trademarks of Adobe
Systems Incorporated which may be registered in certain
jurisdictions.
Adobe Systems 4 Apr 1994 2
PSWRAP(1)PSWRAP(1)
Copyright (c) 1988-1994 Adobe Systems Incorporated. All
rights reserved.
Adobe Systems 4 Apr 1994 3
