pdftoipe(1) [debian man page]

PDFTOIPE(1)						      General Commands Manual						       PDFTOIPE(1)

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 with-
	      out 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)

pdftotext(1)						      General Commands Manual						      pdftotext(1)

NAME

       pdftotext - Portable Document Format (PDF) to text converter (version 3.00)

SYNOPSIS

       pdftotext [options] [PDF-file [text-file]]

DESCRIPTION

       Pdftotext converts Portable Document Format (PDF) files to plain text.

       Pdftotext  reads  the PDF file, PDF-file, and writes a text file, text-file.  If text-file is not specified, pdftotext converts file.pdf to
       file.txt.  If text-file is '-', the text is sent to stdout.

OPTIONS

       -f number
	      Specifies the first page to convert.

       -l number
	      Specifies the last page to convert.

       -r number
	      Specifies the resolution, in DPI.  The default is 72 DPI.

       -x number
	      Specifies the x-coordinate of the crop area top left corner

       -y number
	      Specifies the y-coordinate of the crop area top left corner

       -W number
	      Specifies the width of crop area in pixels (default is 0)

       -H number
	      Specifies the height of crop area in pixels (default is 0)

       -layout
	      Maintain (as best as possible) the original physical layout of the text.	The default is to 'undo' physical layout (columns, hyphen-
	      ation, etc.) and output the text in reading order.

       -raw   Keep  the  text  in content stream order.  This is a hack which often "undoes" column formatting, etc.  Use of raw mode is no longer
	      recommended.

       -htmlmeta
	      Generate a simple HTML file, including the meta information.  This simply wraps the text in <pre> and </pre> and prepends  the  meta
	      headers.

       -bbox  Generate an XHTML file containing bounding box information for each word in the file.

       -enc encoding-name
	      Sets the encoding to use for text output. This defaults to "UTF-8".

       -listenc
	      Lits the available encodings

       -eol unix | dos | mac
	      Sets the end-of-line convention to use for text output.

       -nopgbrk
	      Don't insert page breaks (form feed characters) between pages.

       -opw password
	      Specify the owner password for the PDF file.  Providing this will bypass all security restrictions.

       -upw password
	      Specify the user password for the PDF file.

       -q     Don't print any messages or errors.

       -v     Print copyright and version information.

       -h     Print usage information.	(-help and --help are equivalent.)

BUGS

       Some  PDF  files  contain  fonts whose encodings have been mangled beyond recognition.  There is no way (short of OCR) to extract text from
       these files.

EXIT CODES

       The Xpdf tools use the following exit codes:

       0      No error.

       1      Error opening a PDF file.

       2      Error opening an output file.

       3      Error related to PDF permissions.

       99     Other error.

AUTHOR

       The pdftotext software and documentation are copyright 1996-2004 Glyph & Cog, LLC.  pdffonts(1), pdfimages(1),  pdfinfo(1),  pdftocairo(1),
       pdftohtml(1), pdftoppm(1), pdftops(1)

								  22 January 2004						      pdftotext(1)