'Portable Document Format' FileType Plugin (.PDF)
Set of two FileType plugins which allow the digital image editor 'Paint.NET' to open and save PDFs (Portable Document format).
Open means to render the PDF via Ghostsctipt to bitmap layers in Paint.NET
Save means to embed the bitmap layers into a PDF container.
It is important to understand that you can not edit vector graphics embedded in PDFs inside of Paint.NET using these plugins to open and save PDFs. Paint.NET is a bitmap editor.
Find the latest version of the plugins here:
ImPDF.Open.FileType v1.0 (15.3.2014)
ImPDF.Save.FileType v1.4 (15.3.2014))
Follow the instructions carefully
Installation of ImPDF.Open.FileType
Install Ghostscript (http://www.ghostscript.com/download/). The plugin has been tested with Ghostscript 9.10. If Paint.NET is running as an 64bit application then you have to install "Ghostscript for Windows (64 bit)" else the 32bit version.
The plugin identifies the installed ghostscript version via the registry. Specific ghostscript version required... details here: https://forums.getpaint.net/topic/22863-portable-document-format-filetype-plugin-pdf/?do=findComment&comment=557183
If you are using the plugin w/o Ghostscript a messagebox will popup telling you that Ghostscript is required.
Copy the two files OptionBasedLibrary vX.X.dll/.dlc to the Paint.NET\ folder (NOT to Paint.NET\FileTypes\ !!!)
Copy the two files 'ImPDF.Open.FileType.dll/dlc' to the Paint.NET\FileTypes\ folder
Remove old ImPDF version from Paint.NET\FileTypes\ folder. If you need the save functionality then update to ImPDF.Save.FileType.
Do not remove older versions of the OptionBasedLibrary if they are required from other plugins.
Installation of ImPDF.Save.FileType
Unzip "ImPDF.Save.FileType vX.X.zip" and copy the two files "ImPDF.Save.FileType.dll" and "ImPDF.Command.exe" into the "FileTypes" folder of your Paint.NET installation. A typical location is "C:\Program Files\Paint.NET\FileTypes".
WARNING: Don't forget to remove older version of the ImPDF plugin (ImPDF.FileType.dll)!
Paint.NET 3.5.11 and 4.0.5
The language used in the plugin depends on the language setting of Paint.NET and the support of this language by the plugin. The fallback is the first supported language of the plugin. Languages are defined in the .dlc files. ImPDF.Open.FileType supports the following languages in the moment:
ImPDF.Save.FileType supports the following languages in the moment:
There are many options which control the features supported by this application. The following section tries to describe the options and features together with their dependencies.
Set the general options of the PDF.
Defines how many pages will be generated in the PDF.
Flat (Composite Only): 1 page
Separated Layers: (number of layers) pages
Flat + Separated: 1 + (number of layers) pages
The 'only visible' option (which is checked by default) controls if all or just the visible layers will be added. The order of converting the layers to pages is bottom to up.
PDF Basic: Allows all supported features and minimizes the storage size.
PDF/A-1B: ISO standard for long-term archiving of documents
Some organizations require that you are delivering PDFs in PDF/A format. This standard is more strict about the structure and elements of the PDF. The goal of the standard is to view the content of the PDF in the future on new devices as today on the current ones. To use this option you have to provide an RGB color profile (best would be the one of your display). See http://www.color.org for the idea of color profiles. By default the plugin looks for the profile "ImPDF.Default.icc" in the Filetypes folder of Paint.NET. So you may place a copy of a profile there using the default name. Hint: PDF/A does not allow encryption.
Defines the compression method used to compress the images in the PDF.
Zip (lossless): Compressed
JPEG (... quality) Compressed with quality loss
Allows to set some info in the PDF: title, author, subjects, keywords. The application sets the creator and producer entries of the pdf.
These settings define the size of the generated pages and the size and position of the images on the pages. Remember a pdf is a vector file format which is able to embed pixel images. So if you are talking about the size of a pdf then you are talking about a real world size using a unit. The 'Final Size' depends on the layout settings.
Page Size set to '(Based on image)'
The application calculates the page size from the pixel size of the image and the dpi value stored with the image. In Paint.NET you may set the dpi value in the 'Resize...' dialog. If the 'Borders' checkbox is checked then the size increase by the values for the top, left, right, and bottom border.
Page Size set to '(User-defined)'
Set the W x H values to define the 'Final Size'. If the 'Borders' checkbox is checked then the size available for the image is the user-defined size minus the border values.Use the 'Image' position and the 'Scaling' option to place the image on the page.
Page Size set to a fixed format like 'A4' or 'Letter'
If you select a given format then the 'Final Size' depends on the format and the 'Orientation' option. If the 'Borders' checkbox is checked then the size available for the image is the format size minus the border values.Use the 'Image' position and the 'Scaling' option to place the image on the page.
The viewer settings are providing hints how a pdf viewer application should show the pdf to the user. The viewer may use the hints or ignore them.
This option tells the viewer to rotate all pages in the pdf by 0, 90, 180, or 270 degrees. In some cases it is better to keep landscope orientated pages in portrait mode and let the viewer do the rotation. This make printing more simple.
Open PDF in 'Window View'
This is the default used by PDFs. The viewer application opens a window on the display and shows the PDF inside of this window. You may provide additional hints to the viewer. 'Don't set' in a popup or an indeterminate state of a checkbox means that you do not like to provide this hint to the viewer.
Beside the PDF pages the viewer may view a panel showing additional info about the PDF. You may set this option to the following values: Don't set, No panels, Bookmarks panel, Pages panel, Layers panel.
Here you can define how many pages are visible in the window at the same time and how these pages are presented: Don't set, Single page, Single page continous, Two-up, Two-up continous, Coverpage + Two-Up, Coverpage + Two-Up continous.
This setting describes the size of a page in the window: Don't set, Fit page, Fit page width, Fit page height, Fit visible, Fit visible width, Fit visible height, Actual size, Zoom to. Zoom to also uses the 'factor' option (a percentage value). If you do not select 'Don't set' the you should also provide a start page index.
Fit: Adapts the window size to the page size
Center: Centers the window on the display
Show Title: Shows the Info.Title entry above in the window title
Menu: Hides the menubar of the viewer
Tools: Hides the toolbar of the viewer
Controls: Hides the controls of the viewer (you may not be able to scroll, ...)
Open PDF in 'Fullscreen View'
Ask the viewer to open the pdf in fullscreen mode of the viewer. The viewer may ask the user if he accepts this. There are no additional options.
Open PDF as 'Presentation'
A presentation is a kind of slide show. The viewer will show one page after the other in fullscreen mode. You are able to define transition effects between the pages and timings. Hint: Not all pdf viewers are supporting the presentation mode.
Setting the 'Encryption' option to Low (40 bit) or High (128 bit) allows you to protect the content of the PDF. The owner password is needed if there is the need to modify the PDF later. If the user password is set then the viewer application will ask for this password to open and decrypt the PDF. The 'Allow' flags define what the user is allowed to do with the PDF.
You have to set the user environment variable ImPDFArguments (v1.1 only)
the "Defaults" button may cover other dialog controls => resize the dialog a bit
Rick will check if this is a plugin or an application issue.
Final Page Size' may show 'Unknown' => change any dialog setting forth and back
This is because the dialog has no idea about the document size temporary.
"OK" button is not diabled if the set of settings are not in a good state Only the application is able to disable the "OK" button.
"Cancel" just cancels the operation but not any changed setting. I guess this an application issue.
The preview does not show a preview of the page or the degeneration caused by JPEG encoding. The application generates the preview using the standard load method of the filetype plugin. But this plugin does not provide load because it is not able to load all variants of PDFs (just the ones the plugin generates). Maybe the application could add an OnSavePreview method in the future.
History of ImPDF.Open.FileType
ImPDF.Open.FileType 1.0 (15.3.2014)
- Removed one conflict with the PDF-Export pugin ImPDF.
- Individual filter entry for each file extensions in OpenFileSelector dialog
- Derived from the general ImPS.Open.FileType plugin.
History of ImPDF.Save.FileType
ImPDF.Save.FileType 1.4 (15.3.2014)
- Renamed dll from ImPDF.FileType.dll to ImPDF.Save.FileType.dll
- Changes to avoid conflicts with ImPDF.Open.FileType
ImPDF.FileType v1.3 (22.7.2012):
- Added Content option which allows to store the composite (flat) image or the layers or both
- Added Viewer settings for open pdf in window mode. This allows to define things like the visible panel, the layout of the pages in the window, the view size of the image, the zoom value, the start page and more
- Added Security Settings: This allows you to encrypt the PDF using 40bit and 128bit password protection. You may define a password required to open the pdf and restrict the access to the pdf. Encryption is not possible if you like create PDF/A documents
- Added conformance to PDF/A-1B ISO standard for long-term archiving of documents. Select this feature via the "Conformity" combo box in the "Save configuration" dialog. In additon you have to select an RGB color profile (best would be the one of your display). See www.color.org for the idea of color profiles. By default the plugin looks for the profile "ImPDF.Default.icc" in the Filetypes folder of Paint.NET. So you may place a copy of a profile there.
- Adds some layout and viewer options.
- Select the page size from some presets or choose a user-defined size or the image size.
- Borders may be added to restrict the part of the page used for displaying the image.
- The image can be scaled and positioned relative to the page.
- Viewer options allow you to view the page rotated or in full screen view at the time when you are opening the PDF.
v1.0: The first version is quite simple. It just allows to create a one page PDF in the size of the original image showing the composite image. The encoding and some PDF description entries can be set. Future version may generate layered PDFs.