dpsexec(1) [redhat man page]
DPSEXEC(1) General Commands Manual DPSEXEC(1) NAME
dpsexec - Display PostScript Executive SYNOPSIS
dpsexec [ -display name ][ -sync ][ -backup ][ -noexec ][ -root ][ -drawable windowId ][ -height n ][ -width n ] DESCRIPTION
dpsexec is a Display PostScript program that allows the user to interact directly with the PostScript interpreter through a command inter- face. dpsexec reads lines of text from standard input and passes each line to the PostScript interpreter for execution. It creates a win- dow that displays the results of graphics operations as they are executed. dpsexec exits when end of file is reached on standard input, or when the user types "quit<return>", which executes the PostScript quit operator. By default, dpsexec executes the PostScript executive operator before it accepts any user input. This operator puts the PostScript inter- preter in "interactive executive" mode so that the user can control the interpreter directly. In this mode, the PostScript interpreter supports certain line-editing functions and prompts the user when it is ready to execute more input. See section 2.4.4, "Using the Inter- preter Interactively," of the PostScript Language Reference Manual, Second Edition, for detailed information on this mode of operation. OPTIONS
-display name specifies the display on which to open a connection to the Display PostScript system. If no display is specified, the DISPLAY envi- ronment variable is used. -sync establishes a synchronous connection with the specified X display. -backup uses backing store for the window in which graphics are displayed, if possible. This is generally only effective with the DPS NX system. -noexec prevents dpsexec from entering "interactive executive" mode. The primary effect of this option is to inhibit printing the PS> prompt before each line of input is accepted. This option is useful when dpsexec is run with standard input redirected from a file or a pipe. -root tells dpsexec to draw into the root window instead of into a window that it creates. -drawable windowId tells dpsexec to draw into the specified window instead of into a window that it creates. -height n sets the height of the created window. -width n sets the width of the created window. DIAGNOSTICS
PostScript language error messages are printed to standard output. AUTHOR
Adobe Systems Incorporated NOTES
PostScript and Display PostScript are trademarks of Adobe Systems Incorporated which may be registered in certain jurisdictions. Copyright (c) 1990-1994 Adobe Systems Incorporated. All rights reserved. XFree86 Version Version 4.3.0 DPSEXEC(1)
Check Out this Related Man Page
PSWRAP(1) General Commands Manual PSWRAP(1) NAME
pswrap - creates C procedures from segments of PostScript language code SYNOPSIS
pswrap [ -apr ] [ -o outputCfile ] [ -h outputHfile ] [ -s maxstring ] inputfile DESCRIPTION
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. 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 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 Porta- ble 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 mod- ules 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 archi- tectures. -r Generates reentrant code for wraps shared by more than one process (as in shared libraries). Reentrant code can be called recur- sively 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. Copyright (c) 1988-1994 Adobe Systems Incorporated. All rights reserved. Adobe Systems 4 Apr 1994 PSWRAP(1)