.TH PSTOEDIT 1 .SH NAME pstoedit \- a converter from Postscript(TM) to editable Objects. .SH SYNOPSIS .B pstoedit [ .B -help ] [ .B -bo ] [ .B -dt ] [ .B -dis ] [ .B -merge ] [ .B -flat number ] [ .B -s number (for tgif only) ] [ .B -f format ] [ .I input file [ .I output file ] ] .SH DESCRIPTION pstoedit converts Postscript(TM) files to a simple vector graphic format, that can be edited or imported on drawing packages. Currently tgif (-f tgif), xfig (-f fig), Framemaker(TM) MIF-format (-f mif), GNUplot (-f gnuplot), CGM (-f cgm) and flat PostScript (-f ps) are supported. Ask archie on where to find tgif or xfig. Pstoedit works by redefining the two basic painting operators of (TM)Postscript, stroke and show. Other drawing operators, e.g., image are not supported. After redefining these operators, the Postscript file that needs to be converted is processed by a PostScript interpreter, e.g., GhostScript (gs). So you need to have a PostScript interpreter installed in order to use this program. The output that is written by the interpreter due to the redefinition of the drawing operators is a sort of flat PostScript file which only contains simple operations like moveto lineto, show, .... You can look at this file using the -f debug option. This output is read by the backend part in pstoedit and triggers the drawing functions in the selected backend. To implement a new backend you can start from drvsampl.cc. See also drvbase.h and drvbase.3 for an explanation of the methods that need to be implemented for a new backend. .PP .SH OPTIONS .TP 0.6i .B -dt Text is drawn as polygons. This might produce a large output file. You might want to use this options for example if the PostScript file contains rotated text and the backend does not support this, e.g., tgif. .TP 0.6i .B -merge Some backend support the representation of filled polygons with edges that are in a different color than the fill color. Since PostScript does not support this, drawing programs typically generate two objects (the outline and the filled polygon) into the PostScript output. pstoedit is able to recombine these, if they follow each other directly and you specified -merge. .TP 0.6i .B -dis Open a display during processing by GhostScript. Some files only work correctly this way. .TP 0.6i .B -s factor scale by a factor (for tgif only). .TP 0.6i .B -f format target output format. Currently tgif, mif, fig (for xfig), cgm, met (OS/2 only) and ps are recognized. .TP 0.6i .B -flat number If the backend does not support curves in the way PostScript does, all curves are approximated by lines. Using the the -flat option one can control this approximation. This parameter is directly converted to a PostScript setflat command. .TP 0.6i .B -bo You can run a backend only (without the PostScript interpreter frontend) by first running pstoedit -f dump infile dumpfile and then running pstoedit -f format -bo dumpfile outfile. .TP 0.6i .I input file input file. .TP 0.6i .I output file output file. If no output file is given as argument, pstoedit writes the result to standard output. If neither an input nor an output file is given as argument, pstoedit works as filter reading from standard input and writing to standard output. .SH RUNNING ON OS/2 When running pstoedit on OS/2 you need to call it via the script ps2edit.cmd. .SH AUTHOR Wolfgang Glunz, Wolfgang.Glunz@zfe.siemens.de .SH ACKNOWLEDGEMENTS .TP 0.2i .B * Klaus Steinberger who wrote the initial version of this man page. .TP 0.2i .B * David B. Rosen for some ideas and some PostScript code from his ps2aplot program. .TP 0.2i .B * Ian MacPhedran for the xfig backend. .TP 0.2i .B * Carsten Hammer for the gnuplot and the intial dxf backend. .TP 0.2i .B * Christoph Jaeschke for the OS/2 metafile backend. .TP 0.2i .B * Jens Weber for the Windows metafile (WMF) backend. .TP 0.2i .B * G. Edward Johnson for the CGM draw library used in the CGM backend. .TP 0.2i .B * Gerhard Kircher for some bug fixes. .TP 0.2i .B * Bill Cheng for his help with the tgif format and some changes to tgif to make the backend easier to implement. .TP 0.2i .B * Reini Urban for his inputs regarding the extended DXF backend.