If you have problems, look in the log file /tmp/peasypdf.log for any error messages.
----------------------------------
The Convert tool converts JPEG, PNG and TIFF graphic files into PDFs. Use this if you have a single photo or scanned image that you need to package as a PDF. Other graphic formats can be converted by first opening them in mtPaint and saving as a PNG.
Text documents or spreadsheets can be converted to PDF by loading them into their default application and using Print > Print to File.
The Custom page size makes a PDF page with the exact dimensions of the graphic, so it is borderless. No other options are required with this setting.
PeasyPDF v3.7 has two new Custom sizes. If the original graphic has low resolution, the resulting PDF will be small and may require zooming in your PDF viewer. The Custom+ setting increases the initial size of the PDF. Similarly, the Custom- size shrinks a PDF made from a hi-res image that may overflow the screen.
The Landscape option turns the PDF page sideways so a landscape image will fit in its proper orientation. Use this in conjunction with a standard page size like Letter.
Use Turn if you want to fit a landscape image onto a Letter PDF page with regular portrait orientation.
--------------------------------------
The Join tool combines separate PDFs into a single document or adds more items to an existing PDF.
1. Click New. This starts a new project in the folder /tmp/PDFJoin.
2. Select a PDF file and click Add. You can:
a. select it through the file chooser dialog.
b. drag a file directly from a ROX window into the file entry box.
3. Repeat Step 2 for all the source files.
4. When done adding files, click Join.
5. Click View to open the project folder in a separate ROX window. The joined file is named PROJECT.PDF. Copy it to a permanent location and rename it.
The project folder also contains the original files numbered sequentially. They will remain until you click New. So if you want to add another file to the project, just use Add and Join again. Or move to a different source folder and add more files from there.
Hint: To join a batch of PDFs in one step, read here.
Hint: The Join function uses Ghostscript, which can be slow. You may prefer to use the pdfunite tool instead.
1. Open /usr/sbin/peasypdf in a text editor.
2. Comment out line 147 and insert a line below:
Code: Select all
#gs -dBATCH -dNOPAUSE -q -sDEVICE=pdfwrite -sOutputFile=$JOINPATH/PROJECT.PDF $JOINPATH/*.pdf
pdfunite $JOINPATH/*.pdf $JOINPATH/PROJECT.PDF
The JPEG section has two procedures for combining a batch of JPEG photos into a single PDF document.
1. Use the img2pdf tool. It is FAST, but requires Python. Download img2pdf here. Click the small green DOWNLOAD box. Tahrpup already has basic Python, otherwise get it here. Img2pdf is a one-step procedure. The JPEGs are directly combined into the file /root/JPEG2PDF.PDF. You may need to try different DPI values to get an acceptable PDF.
2. Use the tiff2pdf tool. It just needs some additional TIFF components from the package here. Tiff2pdf is a two-step procedure. The JPEGs are first converted to PDF format in /tmp/PDFJoin, then combined into the file /root/JPEG2PDF.PDF.
Update: V4.2 also handles PNG and TIFF files. It uses image-changer from PeasyScale.
Hint: If you need to change the orientation of an image, like from landscape to portrait, rotate it in PeasyScale before converting to PDF.
--------------------------
The Extract tool pulls one or more pages from a PDF file and converts them to JPG or PNG images. You can also save in PDF format. See below.
Select the PDF file and enter the page number. You can also specify a list of numbers and/or page ranges, like:
Code: Select all
1 4 9 16-25 36 49-64 81 100
The extracted files are stored in the folder /tmp/PDFExtract. Click View to see it. Use the Clear button to erase the PDFExtract folder before starting another set of extractions.
If you extract to PDF format, you have two choices:
a. If you do NOT check Combine, the individual pages are extracted and stored in /tmp/PDFExtract.
b. The Combine option ONLY works with page ranges. The set of pages are extracted and made into a single PDF file. Click View to see it.
PeasyPDF v2.3 can now extract the text from a PDF document. The text is saved in the temporary folder /tmp/PDFExtract under the name EXTRACTED.TXT.
--------------------------------
The Print tool sends a PDF directly to a CUPS printer. Use this instead of Puppy's default PDF viewer program, which does not always print correctly.
You can print the entire document, a single page or a page range like 2-10 or 25-.
------------------------------
PeasyPDF has optional support for MuPDF. MuPDF is a fast, accurate PDF viewer that may work better than your regular viewer. Download it here. Click the small green DOWNLOAD box.
MuPDF uses keyboard controls. There is a list of basic controls under the MuPDF tab.
If you like MuPDF, you can make it your default viewer. Right-click on a PDF file and choose Set Run Action. Change the command to
Code: Select all
mupdf "$1"
Update: For a simple PDF annotating tool, see the discussion about Xournal on page 5.
----------------------------
Here are some examples:
You have a 10-page PDF file. You just want to delete the first page.
a. Choose Extract with the format PDF+Combine
b. Select the page range 2-.
c. Click View to see the new PDF.
You have a PDF file. You want to build a new PDF that combines some of the original pages with some of your own.
a. Choose Extract with the format PDF, but do NOT combine.
b. Extract the pages you want.
c. Click View to open the PDFExtract folder.
d. Click the main Join tab and start a new project.
e. Drag pages from the PDFExtract window into the project and add them. Insert your own pages as needed.
f. When done, join them.
You have a 200-page PDF and you want to insert another item after page 100.
a. Extract pages 1-100 using PDF+Combine.
b. Extract pages 101-200 using PDF+Combine.
c. Click View.
d. Start a new Join project.
e. Add the "001-100.pdf" file.
f. Add the additional page.
g. Add the "101-200.pdf" file.
h. Join the three items.
----------------------------