MAN page from Mandriva 2009 pspdftool-0.03-1.1.x86_64.rpm

pspdftool

Section: User Commands (1)
Updated: 2007-09-18
Index

NAME

pspdftool - tool for prepress preparation of PDF and PostScript documents

SYNOPSIS

pspdftool[-ffile name] [-hhelp][commands][infile[outfile] ]

DESCRIPTION

pspdftoolrearranges pages from a supported document, creating a new file.Supported documents are PostScript and PDF.The input PostScript file should follow the Adobe Document StructuringConventions.

pspdftoolcan be used to perform a large number of arbitrary re-arrangements ofDocuments, including arranging for printing 2-up, 4-up, booklets, reversing,selecting front or back sides of documents, scaling, etc.

commandsfollow the syntax:

commands: = command ... command
command: = name(arg,name=arg2 ...){page selection}
arg: identifier, string, number, real number
page selection
number: page form begin of the list
-number: page from end of the list
number..number: page range from begin of the list
-number..number: page range from end of the list
$: end page in list

list of supported commands

Commands for working with documents:

read

(name=<str>)

append file at the end of list

write

(name=<str>)

save list to file

Commands for working with pages selections:

modulo

(pages, half, round){page_ranges}

book

select{page_ranges}

apply{page_ranges}

new{page_ranges}

add new page at the end of list

del

delete list

scale

(scale=<real>)

scale pages in the list

Command for pages' content transform:

scaleto

(paper, top, right, bottom, left)

fit page to paper

scaleto2

(x, y, top, right, bottom, left)

flip

(mode=<id>)

horizontal | vertical

number

(x, y, start, text, font, size)

add numbers to pages

crop

(paper)

crop2

(lx, ly, hx, hy)

paper

(paper)

sets paper size

paper2

(x,y)

sets papes size to exact size

orient

(orient)

set text orientation the page landscape|portrait

nup

(x, y, dx, dy, orient, rotate, by_bbox, paper, frame, center)

If is set only x to some value n, then command puts n pages to one paper.If is set x and y, then command puts x*y pages to one paper. X means number of columns and y means number of rows.Paper is name of final paper size (e.g. a4,letter ...). Rotate will rotate each page before fitting.

merge

merge list to one page

text

(x, y, text, font, size)

write text to page

line

(lx,ly,hx,hy,width)

draw line to page

rotate

(angle)

rotate page

move

matrix

transform by matrix

Misc commands:

bbox

recalculate bbox on each page by GhostScript

cmarks(by_bbox=1)

add printing marks, if by_bbox is 0 then printing marks are added by paper size, else they are added by bounding box

duplex

(long-edge)

aranges pages for duplex printing

norm

(center,scale,l_bbox,g_bbox)

normalize pages in list on the same size

OPTIONS

-h --help: display help message and exit
-f --file: read commands from file

EXAMPLE

This section contains some sample re-arrangements. To put two pages on onesheet (of A4 paper):

nup(2, paper=a4)

or:

nup(1,2, paper=a4,rotate=90)

To re-arrange pages for printing 2-up booklets, use

book nup(2, paper=a4)

select first five pages and last one from document

select{1..5 -1}

delete last page from document

select{$..1}

reverse page in list

apply{-1 del}

reverse pages in document

modulo(2){-1}

select even pages form document

modulo(2){2}

fit page to a4

scaleto(a4)

AUTHORS

Ales Snuparek <snuparekAATTatlas.cz>

TRADEMARKS

PostScriptandPDFare trademarks of Adobe Systems Incorporated.

BUGS

Pdftooldoes not accept all types of PDF and PostScript files.Cannot cut two or more PostScript files together.

This document was created byman2html,using the manual pages.