NAME

       pdftoipe - Convert PDF files into editable Ipe format

SYNOPSIS

       pdftoipe { options } PDF file [ XML file ]

DESCRIPTION

       pdftoipe converts arbitrary PDF files to Ipe's XML format.

       Note  that  pdftoipe  is  not  related  to  Ipe's  use  of the PDF file format.  PDF files
       generated by Ipe contain an extra stream with Ipe markup information, which  is  necessary
       for  Ipe  to read the file again.  If you wish to convert an Ipe-generated PDF-file to XML
       format, you should use ipetoipe -xml!  pdftoipe is meant to allow you  to  take  arbitrary
       PDF files and make them editable in Ipe.

       pdftoipe  does  a  pretty  good job on drawings, but doesn't handle text very well.  Ipe's
       text model is based on LaTeX, which is just very different from the text found in most PDF
       files.

       -notext
              Ignore all text in the PDF file, convert graphics only

       -literal
              Allow  Latex  markup  in  text  objects.   The  default is to escape all characters
              special in Latex.

       -math  Use LaTeX math mode for all text in the PDF file

       -merge int
              Set the text merge level, an integer between 0 (the default) and 2.  It  determines
              how  eagerly  pdftoipe tries to combine consecutive text in the PDF document into a
              single Ipe text object.  At level 0, only characters consecutively rendered in  PDF
              are  combined. At level 1, more text is combined.  At level 2, all text is combined
              until a path or image is drawn.

       -unicode int
              Determine what should be done with non-ASCII characters in text.  At level  0,  all
              non-ASCII  characters  are  represented as [U+XXX].  At level 1 (the default), some
              often used characters (such as bullets) are replaced by Latex  equivalents,  others
              are  represented as [U+XXX].  At level 2, characters that are not replaced by Latex
              equivalents are included in UTF-8.  At level 3,  all  characters  are  included  as
              UTF-8.

              At  level  2 and 3, UTF-8 is set as the input encoding in the Latex preamble of the
              generated Ipe document.

              Note that this only concerns characters for which the PDF file provides  a  mapping
              to Unicode.  Characters from embedded fonts without Unicode mapping (such as symbol
              fonts) are always represented as [S+XX].

       -f int First page to convert

       -l int Last page to convert

       -opw string
              Owner password for encrypted PDF files

       -upw string
              User password for encrypted PDF files

       -q     Quiet mode (don't print any messages or errors)

AUTHOR

       Otfried Cheong

REPORTING BUGS

       Please report bugs at http://ipe7.sourceforge.net/bugzilla.html

SEE ALSO

       More information about Ipe can be found in The Ipe Manual, available online at
       http://ipe7.sourceforge.net/manual/manual.html

                                         October 13, 2009                             PDFTOIPE(1)