vprerex(1) [debian man page]

VPREREX(1)																VPREREX(1)

NAME

       vprerex - graphical front-end and viewer for the prerex(1) prerequisite-chart editor

SYNOPSIS

       vprerex basefile[.tex] [ chartfile[.tex] ]

       vprerex file.pdf

       vprerex

DESCRIPTION

       vprerex	(visual  prerex) is a GUI front-end and viewer for the prerex(1) interactive editor of prerequisite-chart descriptions in the pre-
       rex(5) format.  The viewer may be used just as a minimalistic viewer of arbitrary PDF files  but supports editing of charts generated using
       prerex.sty(7)  by  allowing  coordinates  of  course boxes, arrows, and background points to be conveyed back to the prerex(1) command-line
       using the clipboard.

USAGE

       If vprerex is invoked on a PDF file, it simply displays that file.

       If the (first) argument does not have the .pdf suffix, it is assumed to be the base file for a LaTeX document  containing  a  prerequisite-
       chart  description in prerex(5) format, to be edited using prerex(1).  If a second argument is supplied, it is regarded as an included file
       containing the specific chart environment to be edited.

       If no arguments are supplied, a file-opening dialog allows the user the specify the prerex(1) base file to be edited (or the PDF file to be
       viewed); if a separate chartfile is needed, vprerex(1) must be invoked wth two arguments on the command line.

       If  the	mouse hovers over a hyperlink in the PDF viewing window, the cursor shape will change to a pointing finger and a tooltip will dis-
       play the URI.  If the PDF file displayed contains a chart generated using  prerex.sty(7)  and  the  background  coordinate  grid  has  been
       enabled,  left-clicking the mouse on a course box, arrow mid-point, or background point will load the relevant coordinates into the X clip-
       board.  The cursor shape changes to a plus-sign to indicate successful capture of the coordinates.  Middle-clicking the mouse at  the  pre-
       rex(1)  command-line  will then paste those coordinates into a command being composed.  If the chart file is regenerated, the updated docu-
       ment will be re-loaded.

DEPENDENCIES

       vprerex is based on the Qt-4 library. It calls xterm(1) and prerex(1) for the editing window and uses poppler-qt4 for rendering PDF files.

AUTHOR

       R.  D.  Tennent	(rdt@cs.queensu.ca),  adapted  from  David  Boddie's  PDFviewer,  described  in  the   QT   Quarterly:	 http://doc.troll-
       tech.com/qq/QtQuarterly27.pdf.

SEE ALSO

       prerex(1), prerex(5), prerex.sty(7), and xterm(1).

vprerex-6.2							    2011-10-28								VPREREX(1)

CAM::PDF::Content(3pm)					User Contributed Perl Documentation				    CAM::PDF::Content(3pm)

NAME

       CAM::PDF::Content - PDF page layout parser

LICENSE

       Same as CAM::PDF

SYNOPSIS

	   use CAM::PDF;
	   my $pdf = CAM::PDF->new($filename);

	   my $contentTree = $pdf->getPageContentTree(4);
	   $contentTree->validate() || die 'Syntax error';
	   print $contentTree->render('CAM::PDF::Renderer::Text');
	   $pdf->setPageContent(5, $contentTree->toString());

DESCRIPTION

       This class is used to manipulate the layout commands for a single page of PDF.  The page content is passed as a scalar and parsed according
       to Adobe's PDF Reference 3rd edition (for PDF v1.4).  All of the commands from Appendix A of that document are parsed and understood.

       Much of the content object's functionality is wrapped up in renderers that can be applied to it.  See the canonical renderer, CAM::PDF::GS,
       and the render() method below for more details.

FUNCTIONS

       $pkg->new($content)
       $pkg->new($content, $data)
       $pkg->new($content, $data, $verbose)
	   Parse a scalar CONTENT containing PDF page layout content.  Returns a parsed, but unvalidated, data structure.

	   The DATA argument is a hash reference of contextual data that may be needed to work with content.  This is only needed for toString()
	   method (which needs "doc => CAM::PDF object" to work with images) and the render methods, to which the DATA reference is passed
	   verbatim.  See the individual renderer modules for details about required elements.

	   The VERBOSE boolean indicates whether the parser should Carp when it encounters problems.  The default is false.

       $self->parse($contentref)
	   This is intended to be called by the new() method.  The argument should be a reference to the content scalar.  It's passed by reference
	   so it is never copied.

       $self->validate()
	   Returns a boolean if the parsed content tree conforms to the PDF specification.

       $self->render($rendererclass)
	   Traverse the content tree using the specified rendering class.  See CAM::PDF::GS or CAM::PDF::Renderer::Text for renderer examples.
	   Renderers should typically derive from CAM::PDF::GS, but it's not essential.  Typically returns an instance of the renderer class.

	   The rendering class is loaded via "require" if not already in memory.

       $self->computeGS()
       $self->computeGS($skiptext)
	   Traverses the content tree and computes the coordinates of each graphic point along the way.  If the $skiptext boolean is true
	   (default: false) then text blocks are ignored to save time, since they do not change the global graphic state.

	   This is a thin wrapper around render() with CAM::PDF::GS or CAM::PDF::GS::NoText selected as the rendering class.

       $self->findImages()
	   Traverse the content tree, accumulating embedded images and image references, according to the CAM::PDF::Renderer::Images renderer.

       $self->traverse($rendererclass)
	   This recursive method is typically called only by wrapper methods, like render().  It instantiates renderers as needed and calls
	   methods on them.

       $self->toString()
	   Flattens a content tree back into a scalar, ready to be inserted back into a PDF document.  Since whitespace is discarded by the
	   parser, the resulting scalar will not be identical to the original.

AUTHOR

       See CAM::PDF

perl v5.14.2							    2012-07-08						    CAM::PDF::Content(3pm)