3-Heights™ PDF to Image Converter Shell, User Manual
Contents
1. controlled by a quality index ranging from 1 to 100 and normally defaulted at 75 Lossy algorithms usually provide a better compression rate at the cost of visual quality Lossy compression is normally used for photographs It is applied to the following types of images JPEG JPEG2000 if quality is less than 100 and JBIG2 if quality is less than 100 There are various compression types supported for the TIFF image format These are CCITT Group 3 Group 3 2D CCITT Group 3 is the predecessor to CCITT Group 4 it is a simpler algorithm that normally results in a lower compression ratio CCITT Group 4 CCITT Group 4 is the standard compression for bi level TIFF images i e facsimile LZW LZW Lempel Ziv Welch compression is a lossless compression algorithm for images Please consult the copyright laws of your country prior to using this compression algorithm JPEG TIFF allows images to be compressed with JPEG which is a lossy compression algorithm JPEG provides a high compression ratio for 8 and 24 bit images It is best suited for TIFFs containing photographs and little or no text ZIP Flate ZIP is a lossless compression algorithm It is useful for the compression of large images with no loss in quality Flate compression also used by the ZIP format and JPEG compression can be used for color or grey scale images CCITT Group 3 3 2D and 4 as well as Flate can be used for black and white images Example Ap2. TOOLS COM VEDI Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 User Manual Contact pdfsupport pdf tools com Owner PDF Tools AG Kasernenstrasse 1 8184 Bachenb lach Switzerland http www pdf tools com Copyright 2001 2015 3 Heights PDF to Image Converter Shell Version 4 5 July 1 2015 Page 2 of 34 Table of Contents 1 2 3 4 5 Introd ction uses ue unu haer apscRrCE nn esamshaEU Rue RUE L Description om eee LE 2 CPEUnGctloOris soeur v EVE ee REVO U EVO Vs Features an ahnen Formats ILE RM UM M IM UEM IE 1 3 Operating Systems aaa ede Installation nn 2 1 Installing the 3 Heights PDF to Image Converter How to Set the Environment Variable Path cccssceseeneeneeneees License Management ununuanannanannnnunnanannanunnanannanannanan namen 3 1 Graphical License Manager Tool sees List all installed license keys eeseeseeeemmmIe Add and delete license keys ccceceee eect ee eens teens nenn nenn anne Display the properties of a license seen Select between different license keys for a single product 3 2 Command Line License Manager Tool ssseeseses List all installed license keys eese Add and delete license keys eesseseeee mnn Select between different l
3. ssersensenenenn none onen nun nun nennen nennen nennen nnn 34 6 3 TRANSPARENCY sic nee ash 34 PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 5 of 34 July 1 2015 Introduction 1 1 Description The 3 Heights PDF to Image Converter converts PDF documents into single page or multi page raster images such as TIFF or JPEG It can also convert PDF files into rasterized PDF Its areas of use include the web TIFF based DMS solutions archive and workflow systems and the protection of PDF documents The Converter is characterized by its high speed and outstanding quality PDF to Image Converter TIFF Codec JPEG Codec E ja TIFF JPEG Other Codec E Image z E i m 5 c o D o E PDF Codec Parameters 1 2 Functions The 3 Heights PDF to Image Converter merges pages from different input files to form one or more files Color space and image size are defined automatically during the process The Converter supports scaled and non scaled conversions and a variety of image formats such as PNG TIFF JBIG2 or JPEG2000 Features e Create single page and multi page image files and rasterized PDF documents e Convert individual pages PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 6 of 34 July 1 2015 Convert a PDF file into a PDF image file so that the new file contains the entire
4. Page ssssssemmmn 22 b Set the Bits per Pixel a ea a a nennen means nea nna nean nn 22 cms Set the color management engine nuserensenennnnennnnnn nennen nen nennen nennen 22 Gh Center MOGG iur otiose Bend aren Deu IRA a ROC DRE Ea RETE I RUP Ea RR ANE 22 cs Set the Color Space unennennennennonnnnnnnnnnnnn nun nun nun nun nun nun nun sea sea sea se nn nnn 23 d Set the Resolu tlon x ee e e u 23 dx Set the X Resolution iiini a Ix Fa races en Rea Een E RR FRU REY nae 23 dy Set the Y Resolution ersernennennennnnnnn none nn none nn nun nun nun memes nnns 23 f Fit Page Mode ee ku 23 fax Convert to Class F riris ea aan pen Ur DRE nn ee a EINA 23 fo Bit Fill Order aa a EEE 24 fS Filter Sizer ine ek 24 g Gray Color jSpace uns nee nun Pa RR UE Kane RC E DM UE RERO FERE ERE 24 h Dithering Mode ore retten tnr ne 24 i Indexed Color Space ni xe ten eR x ete nat 25 If Set Line Width Multiplication Factor sessseemmm 25 Iw Set Minimum Line Width cece eee eee eee erence nena eee eee ea menn 25 m Rendering Mode eee xr Rn 25 Ok Use Typelt FOnts eee Utd rettet oe bx Ex ee ner bees 25 oe Do not Use Embedded Fonts cceceeeeceee eect nena teeta eee nennen nenne nennen 25 ofp Use Pre Installed fonts nee ee ee ee one s 25 op Disable Pattern zersersennennennennennnn nen non ennennenn nennen nennen nenne nun nennen nennen nenn 26 oq Disable Hig
5. license keys on the left pane of the window This includes licenses of other PDF Tools products The user can choose between e Licenses available for all users Administrator rights are needed for modifications e Licenses available for the current user only Add and delete license keys License keys can be added or deleted with the Add Key and Delete buttons in the toolbar e The Add key button installs the license key into the currently selected list e The Delete button deletes the currently selected license keys PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 9 of 34 July 1 2015 Display the properties of a license If a license is selected in the license list its properties are displayed in the right pane of the window Select between different license keys for a single product More than one license key can be installed for a specific product The checkbox on the left side in the license list marks the currently active license key 3 2 Command Line License Manager Tool The command line license manager tool icmgr is available in the bin directory for all platforms except Windows A complete description of all commands and options can be obtained by running the program without parameters licmgr List all installed license keys liemgr list The currently active license for a specific product is marked with a star on the l
6. provides two executables pdf2img and pdf2pdfimg pdf2img is used to convert PDF files to raster images such as TIFF JPEG etc The functionality of this executable is documented in this manual pdf2pdfimg is used to render PDF files to images and re embed these images back into a new PDF document As a result the new PDF document contains exactly one image per page an no further content objects Alternatively the text can be retained option oa That means only images and vector graphics are converted to an image and the text is added on top of the image pdf2pdfimg is not further described in this documentation Most of its switches are equivalent to those of pdf2img All switches are described in the usage of the tools Type pdf2img or pdf2pdfimg with no arguments to list the usage 4 1 Getting Started The simplest command requires one parameters The name of the PDF input file When no output file name is specified the output file will be named as the input file and the image type TIFF is selected PDF Tools AG Premium PDF Technology 4 2 3 Heights PDF to Image Converter Shell Version 4 5 Page 11 of 34 July 1 2015 Example The following command pdf2img input pdf creates an uncompressed TIFF file It inherits the name of the input file and is named input tif If the PDF file has more than one page the generated TIFF will be a multi page TIFF Keep in mind that TIFF supports multi paging whereas mo
7. supports transparency functions such as a number of blend modes as well as isolated and non isolated transparency groups but not transparency in general PDF Tools AG Premium PDF Technology
8. text and all the vector graphics as raster images to prevent text extraction for instance Convert PDF files to CCITT fax files Set page mode Define page dimensions in points or pixels Set rotation identical to the incoming PDF document or portrait or landscape Resolution in DPI including X and Y direction Dithering Floyd Steinberg Halftone Block Halftone Continuous Set image filters Set color depth Set color space Set TIFF file compression Set the quality of lossy image compression Set bit filling order for fax files Define minimum line width Formats Input Formats PDF 1 x e g PDF 1 4 PDF 1 5 etc Target Formats 1 3 TIFF Tagged Image File Format JPEG Joint Photographic Expert Group PNG Portable Network Graphics GIF Graphics Interchange Format BMP Window Bitmap EPS Encapsulated PostScript JBIG2 Joint Bi level Image Experts Group JPEG2000 Extended JPEG2000 PBM Portable Bitmap File Format Operating Systems Windows XP Vista 7 8 8 1 32 and 64 bit Windows Server 2003 2008 2008 R2 2012 2012 R2 32 and 64 bit PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 7 of 34 July 1 2015 Installation 2 1 Installing the 3 Heights PDF to Image Converter The retail version of the 3 Heights PDF to Image Converter Service comes as a ZIP archive containing various files including runtime binary execut
9. to 150 dpi Example Set the resolution in X to 72 dpi pdf2img dx 72 input pdf Set the Y Resolution Set the resolution only for the Y axis The default resolution is set to 150 dpi Fit Page Mode Make the PDF fit the page in either width or height This option is useful in combination with setting page dimensions Example Convert a PDF to 800 by 600 pixel TIFF image and scales the page of the PDF to fit the page of the image pdf2img s 800 600 f input pdf output tiff Convert to Class F This switch creates a Class F TIFF which is used by fax machines There are two types Table Class F TIFF TIT Description Is equal to the following settings PDF Tools AG Premium PDF Technology h 3 Heights PDF to Image Converter Shell Version 4 5 Page 24 of 34 July 1 2015 s standard rp sp 1728 0 dx 204 dy 98 g3 h high resolution rp sp 1728 0 dx 204 dy 196 g3 Example Convert a PDF to a standard Class F Tiff pdf2img fax s input pdf output tiff Bit Fill Order Set the fill order of bits used in fax compressions Table Bit Fill Order Description 1 default Most Significant Bit MSB first 2 Least Significant Bit LSB first Filter Size This setting is used to enable and parameterize super sampling a technique to initially render the image at a higher resolution and then sample it down to the target resolution As a result of that process the final image appears smo
10. 5 4 pdf2pdfimg Specific Options cece eee cece nen nn nennen une mmm 29 nl Disable the copying of links sess 29 no Disable the copying of outlines essssssssesssseemmmene 29 nv Disable the copying of viewer preferences essenennnnnnnnnnnnnnnnen nennen nennen nenn 29 5 5 General Options reine 29 V Verbose Mode acer tahanan aaia paa aia ba aaa a aA 29 lke Setlicense Key a sende eere et tudo A eie unde a esu 30 5 6 Return Codes sue e prep v nete va varese dte t E al a ale 30 6 Tips Ticks and Troubleshooting eese eren nnne nnn nnn 31 PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 4 of 34 July 1 2015 nC T 31 Pages Are Rotate dis i set see er En de Pea EE ERR ERU PE uar RR ya de aa er 31 Generated Files Have a Large Size sneinen oniani NaN NEENA NENANA EANNA mene 31 Images Are of too Low Quality 2ssessenennnnennn nenne nun nn nennen nennen nennen nn nennen 31 Image Does Not Contain the Whole Content sssssssrsssrresrrresrrnusrrnnerrnnerrnnne 31 Colors Afe GONG xs we e m LUE 31 MM CD a ai aa a aada aa eda a e airada e 32 Font Replacement Strategy cceceecee cece eee eee eee eee nee ne eee eee en nun ernennen 32 Installed Font Collection rennen hl 33 Using the Font Mapping File fonts ini s userannenannnnn eee nn une nun mmm 33 Other Ways to Deal with Text Issues
11. All images below have quite a low resolution As a result the effects of the different dithering types become more obvious The higher the resolution and the large the number of colors the higher the quality of the image 2 The rendering filter and current zoom level of the PDF viewing application may have an additional impact on how the images below are displayed Color Images Color Space RGB 24 bit Dithering None File Size as PNG 129 kB A 24 bit RGB color image can have up to 16 7 millions 7 of different colors Dithering does not need to be applied since all required colors exist and none need to be simulated Black Text Black Text White Text Highest quality 2o 0000 NEN Highest file size Blue Text Blue Tex a Red Text Red Text BEEN Green Text Color Space 16 colors 4 bit Dithering None File Size as PNG 16 kB T Small file size Works well for images with a small number of colors artificial images text Does not work well for images with lots of colors LLL photographic images parts of the image can become sue Tex Bee Se lain col d and detail t lost plain colored an etalls get Ios Red Text Red Text Red Tex Green Text PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 18 of 34 July 1 2015 Color Space 16 colors 4 bit Dithering Floyd Steinberg File Size as PNG 18 kB Renders details better Usual
12. DF to Image Converter generates multi page images if the TIFF format is selected and the input PDF has more than one pages To create one TIFF file per PDF page simply use the switch 1 This option should also be used for all other formats which do not support multi paging if the input PDF document has more than one page When doing so the output files can be named with wildcards Example Create images consisting of 1 page per image add the page number to the file name as four digit number pdf2img 1 input pdf output 04d png Image files created this way are named output0001 png output0002 png output0003 png etc 4 5 The Use of Wildcards pdf Wildcards can also be used to process multiple input files Example If a directory contains the following PDF files AOl pdf A02 pdf A03 pdf BO1 pdf Then the following command processes all PDF files starting with A pdf2img A pdf Or this command processes the files that end with 01 pdf pdf2img 01 pdf Note that the file extension of the input file must always be pdf When using wildcards it is helpful to enable the verbose mode using the switch v Example Using wildcards in verbose mode pdf2img v 01 pdf And the generated output message looks like this Converting file A01 pdf Rendering page 1 Rendering page 2 Converting file BOl pdf Rendering page 1 PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Sh
13. able code documentation and license terms 1 Download the ZIP archive of the product from your download account at www pdf tools com Open the ZIP archive Check the appropriate option to preserve file paths folder names and unzip the archive to a local folder e g C program files pdf tools 4 The unzip process now creates the following subdirectories e Bin Contains the runtime executable binary code e Bin Fonts Contains the font ZapfDingbats and the font mapping file Copy and thereby install the two fonts to the OS fonts directory SystemRoot Fonts e g C Windows Fonts or deploy the directory together with the product s executable e Doc Contains documentation files 5 To start the 3 Heights PDF to Image Converter from a shell the directory needs to be included in the Path environment variable How to Set the Environment Variable Path To set the environment variable Path on Windows 2000 go to Start gt Settings gt Control Panel gt System gt Advanced gt Environment Variables Windows XP go to Start gt Control Panel classic view gt System gt Advanced Environment Variables Select Path and Edit then add the directory where pdf2img exe is located to the Path If the environment variable Path does not exist create it PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 8 of 34 July 1 2015 License Managem
14. dded font program or the embedded font is not usable The mapping only works if the font types of the specified fonts are matching e g if the font in the PDF is a symbolic font such as Symbol or ZapfdingBats the mapped font must be symbolic too The section fonts is only considered if the font matcher does not find an appropriate font amongst the existing installed fonts It is suggested to only use this section The section replace is stronger and applied before the font matcher This means a font will be replaced as defined even if the correct installed font is available on the system Syntax The syntax of the mapping file is this fonts PDF font l installed font 1l font style PDF font 2 installed font 2 font style replace PDF font n installed font n font style PDF font is the name of the font in the PDF This name can be found in one of the following ways eUse any tool that can list fonts Such as 3 Heights PDF Extract or 3 Heights PDF Optimization Ignore possible prefixes of subset fonts A subset prefix consists of 6 characters followed by the plus sign For example KHFOKE MonotypeCorsiva in this case only use MonotypeCorsiva as font name in the mapping file PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 34 of 34 July 1 2015 Ir Open the document with Adobe Acrobat use the MarkUp Text Tool mark the text of
15. e drawn in any another way as by using the PDF operators m and move to line to It does not affect text unless text is drawn with lines instead of using a font Set Minimum Line Width In cases where lines are rendered too thin a minimum line width in PDF points can be defined Any line will then be printed with at least the defined minimum line width Note that as a result thin and very thin lines can no longer be distinguished On order to scale all lines with a certain factor use the switch If instead This option only affects lines It has no influence when lines are drawn in any another way as by using the PDF operators m and move to line to It does not affect text unless text is drawn with lines instead of using a font Rendering Mode Deprecated Version 2 0 and higher only support one rendering mode Use Type1 Fonts This switch converts OpenType fonts to Type1 fonts Do not Use Embedded Fonts This switch disables the use of embedded fonts and replaces them with fonts installed on the operating system Use Pre Installed fonts When using this switch embedded fonts are replaced by fonts installed in the operating system Only non symbolic fonts that have an equal name are replaced The default behavior is that all embedded fonts are used PDF Tools AG Premium PDF Technology p pgs q 3 Heights PDF to Image Converter Shell Version 4 5 Page 26 of 34 July 1 2015 Disable Pattern This swi
16. eft side Add and delete license keys Install new license key licmgr store X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX Delete old license key licmgr delete X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX Both commands have the optional argument s that defines the scope of the action e g For all users e u Current user Select between different license keys for a single product licmgr select X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX 3 3 License Key Storage Depending on the platform the license management system uses different stores for the license keys PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 10 of 34 July 1 2015 Windows The license keys are stored in the registry e HKLM Software PDF Tools AG for all users e HKCU Software PDF Tools AG for the current user Mac OS X The license keys are stored in the file system e Library Application Support PDF Tools AG for all users e Library Application Support PDF Tools AG for the current user Unix Linux The license keys are stored in the file system e etc opt pdf tools for all users e pdf tools for the current user Note The user group and permissions of those directories are set explicitly by the license manager tool It may be necessary to change permissions to make the licenses readable for all users Example chmod R gotrx etc opt pdf tools User Guide The 3 Heights PDF to Image Converter Shell
17. ell Version 4 5 Page 13 of 34 July 1 2015 Done Wildcards return a list of existing documents therefore they cannot be used for naming not yet exiting documents If you would like to convert all PDF documents in a directory to individual multi page TIFF documents it is required to use a variable to name the output files Example Use the FOR command of the CMD shell to converts all pdf images to TIFFs with the same name and the extension tif in the same folder for i in pdf do pdf2img v i ni tif Example Of course one can adjust the paths or use a different output name for i in C PDF pdf do pdf2img i C Img ni tif For additional help to the FOR command type the command for Note that in batch files variables have two leading instead of just one 9o 4 6 How to Reduce the File Size There are different ways to reduce the file size of an image One needs to be aware that from a certain point on a smaller file size results in a poorer visual quality The main factors on which the file size of an image depend are e Dimensions in pixel width and height e Bits per pixel e Compression Type e The content of the image influenced by dithering Dimensions Reducing the dimensions and therefore the amount of the total pixels reduces also the file size Obviously a 1024x768 pixel image has a larger file size than an equivalent 600x480 image Example Set the size of the image to 600 by 480 p
18. ent 3 1 There are three possibilities to pass the license key to the application 1 The license key is installed using the GUI tool Graphical user interface This is the easiest way if the licenses are managed manually It is only available on Windows 2 The license key is installed using the shell tool This is the preferred solution for all non Windows systems and for automated license management 3 The license key is passed to the application at runtime via the command line switch 1k property This is the preferred solution for OEM scenarios Graphical License Manager Tool The GUI tool LicenseManager exe is located in the bin directory of the product kit n amp PDF Tools License Ma File Edit Help X 5 Add Key Delete Refresh List All Users Curent User License Properties 3 Heights TM Document Converter amp Name Value V M 0 10A0M TARF a a Key 0 J0A94 RRL Luz 7 M 0 BCASN VTJE SOT LA FOREN Product 3 Heights TM Image 3 Heights TM Image to PDF Converter API af Intended Use Productive 7 0 JOA94 iniiai iin Aa Y Platform Windows 3 Heights TM Image to PDF Converter Service Volume m Page s rn V A 0 1CA0 XTCRH TIC OMBRA v Expiration Does not expire Y Maintainance Expiration 2033 12 31 2 Uniaht TRA Tmaan ta ANE Canenetar Chall List all installed license keys The license manager always shows a list of all installed
19. g Jpeg2000 or Jbig2 For images which support PDF Tools AG Premium PDF Technology r S sp 3 Heights PDF to Image Converter Shell Version 4 5 Page 27 of 34 July 1 2015 lossy and lossless compression such as Jpeg2000 or Jbig2 a quality value of 100 means lossless compression Note that Jpeg is always lossy The default value is 75 A lower value of the quality parameter results in a higher compression at the cost of visual quality loss Example Lossy compression with a quality index of 50 pdf2img q 50 input pdf output jpg Example Lossless compression pdf2img q 100 imput pdf output jp2 Rotate Pages According to Page Rotate Attribute A PDF document can have a page rotation attribute that describes if the PDF is to be rotated when displayed for example when a 90 degree rotated portrait is displayed as landscape The PDF to Image Converter by default ignores this attribute Using the switch r the generated images have the same rotation as the input PDF Rotate Pages to Landscape This switch rotates all pages to landscape Rotate Pages to Portrait This switch rotates all pages to portrait Set Width and Height of Image in Points When not specified the image will have the same dimensions as the input PDF To set the dimensions manually use the switch s followed by two parameters for the width and the height If either of the dimensions is set to 0 the value will be calculated prop
20. h Quality Rendering z444 sHRHen nenne nennen nennen une nn nennen 26 zot Use True Ty Pe FONUS Hiss c opem er na rd 26 p Read an Encrypted PDF File cceeceeeeeee teens une n eset mme 26 pgi Set Page Range are dx e ke a ne e und RE 26 DOS Set of Pages ann aa a a aaa ne a ana nen Ee E rea meters 26 q Set Image Quality of Lossy Compression uuauserennnnennnnnn nenn nennen nnn nn nen 26 r Rotate Pages According to Page Rotate Attribute ceeceeeeeee ann ees 27 rl Rotate Pages to Landscape seirian ee ee eee e eee nenne nennen nennen nennen nen 27 rp Rotate Pages to Portrait esses nennen mensem nnn nnn 27 S Set Width and Height of Image in Points esseseseeeeme 27 sp Set Width and Height of Image in Pixel sessesseeseee 27 sa Set Width and Height in Pixel and Preserve Ratio ecceeeeeeeeeeeeeeeeeees 28 t Set Threshold When Dithering is Disabled sessseeseeeeeeeeese 28 5 3 Compression OPUONS eite de pex ra re tu i ler nn UR DERE REI RE TEES 28 g3 Compression CCITT Group 3 ucnesnensennennennnnnnnnnn nun memes nnn 28 94 Compression CCITT Group 4 ir e ere lc Ra ele ena en 28 Compression LZW sun su a a heic euet bet RE Pec ne t peor RE teed 28 j Compression JPEG ecd edel cupo eue en chaste Dri edere here 28 jo Compression JPEG 6 ccc rer a u 29 Z Compression ZIP en RE E E UE Fa be rx UE att edad 29
21. h a high resolution in combination with 8bit grey scale or 24bit color images will generate huge files several hundreds of MBs uncompressed and around 10 MB using JPEG compression DPI values larger than 2400 will take a lot of CPU power and memory we recommend not using values above 2400 for A4 paper size PDF documents 4 8 How to Select the Color Profiles The 3 Heights PDF Rendering Engine works in the RGB color space For color conversions the two color profiles in the folder Icc are used Color profiles can be downloaded from the links provided in the directory Icc The color profiles that are applied must be named CMYK icc and sRGB icm Alternatively color profiles can be downloaded from the following websites e www pdf tools com public downloads resources colorprofiles zip e www color org srgbprofiles html In order to change the default color profile replace these two color profiles with new color profiles If no color profile is available the conversion is done algorithmically using Neugebauer 4 9 Dithering Dithering is a common means used in images to simulate colors that are not available as actual colors Its use is best observed in image with a low color depth where colors or shades of grey need to simulated with other colors e g only black white pixels PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 17 of 34 July 1 2015 Remarks 1
22. icense keys for a single product 3 3 License Key Storage eem e Rer ei RE eee Windows ns a En a ee nee 4 Getting Started estie ceo bi cereo oer a ed 3 d ep bd ds 4 2 General Settings are na a der denn edhe 4 3 Specify Image Type File Name and Output Folder 4 4 Single Page or Multi Page Images seen 4 5 The Use of Wildcards pdf essem 4 6 How to Reduce the File Size ssssssrrssrrrsrrrrsrrrrsrrrrnrrrrerrrns Dimensions eene een ei pr emt hc kg e m e a Resol tlon 3 5 edt dalek os du teagan teehee ek be ern cd bert ta ine nen Bits per PIXel uice iere rente ER PREX PLE VR REP E RR KR E UE Format Compression Type uueranseranennunennnnennanennnn ernennen nn Image Content Dithering s ssssssserssrrrssrrrrsrrnusrrnusrrnnerrnerrrnens 4 7 Options for Best Results on a Printer ccceeeeeee esse teeta ees 4 8 How to Select the Color Profiles seseeseeseseeeeseeess 4 9 Dithering i eie ged en da gece ee HER nah EEE segues Remarks norria a ea ren fernen Color Images LER Bi tonal IMAGES an sn ee ne a nee ICE Ip EE Reference Manual cc cerae aaa anne neuen nannte 5 1 Supported Codecs swiss les dade ree pex ERE e M ARR 5 2 Rendering Optio Sisenna aaa PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 3 of 34 July 1 2015 1 Create one Image File per PDF
23. ingle black pixels Red Text Not well suited for text unless the color of the text must be reflected Green Text Color Space Grayscale 1 bit Dithering Halftone File Size as PNG 4 kB Small file size Approximates shades of gray Not well suited for text or artificial images Color Space Grayscale 1 bit Dithering Pattern File Size as PNG 5 kB Works acceptable for all types of content text photographic images artificial images Is not excellent in any type of content Blue Text Red Text Green Text Guidelines As seen in the examples above different types of dithering behave different for different types of content Below are some suggestions which dithering type is normally best for a give type of content Text OCR No dithering PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 20 of 34 July 1 2015 Artificial images with few colors and No dithering no bright colors Artificial images with many colors Test which dithering type yields the best result Photographic images Floyd Steinberg Mixed content Test which dithering type yields the best result Mixed content high resolution For resolutions above 300 dpi Floyd Steinberg almost always yields the best result exception for pure black text on white background use no dithering Keep in mind that dithering should only applied for images with a low color depth such as black a
24. ixel scale the page to fit the given dimensions sp 600 480 f Example Set the size of the image to 600 by 480 points scale the page to fit the given dimensions s 600 480 f If the dimensions are set in points the dimensions in pixel are calculated depending on the resolution PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 14 of 34 July 1 2015 Resolution The resolution in dots per inch dpi lets you specify how detailed the image is The default value is 150 dpi which generates an image that looks sharp when not zoomed into A larger value generates a more detailed image but also will increases the file size because it requires more pixels On the other hand a lower resolution generates a file with a smaller file size but the image is also of lower visual quality Example Set the resolution to a value of 75 dpi in order to reduce the file size to about one quarter d 75 Bits per Pixel Using 1 bit black white or 8 bit grey scale instead of 24 bit true color will reduce the file size Keep in mind that not all formats support all color depths Example The following command will create a bi level image black white TIFF image b 1 h 6 oq 8 bit grey scale images are a third as large in size as 24 bit color images With 1 bit images that use dithering the size heavily depends on the content It can be as small as 1 of the 8 bit image Forma
25. ly better overall quality specially in photographic images than without dithering Sometimes generates unwanted artifacts striking sick ex Black Text pixels Grey t Grey Text Grey Text Blue Text Blue Text i Red Text Red Text Red Tex Green Text Larger file size then without dithering Bi tonal Images Color Space Grayscale 8 bit Dithering None File Size as PNG 46 kB The 8 bit image just acts are reference Black Text Black Text Blue Text Blue Text EEE Red Text Red Text BEBE Green Text Color Space Grayscale 1 bit a ER Dithering None E File Size as PNG 2 6 kB Smallest File Size Works well for documents with high contrast black text on white background Does not generate artifacts 2 rn Details get lost because shades of gray are not Blue Text Blue Text MEE approximated but converted to either black or white in Red Text Red Text fact images or part of them can become completely mum black or white PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 19 of 34 July 1 2015 Color Space Grayscale 1 bit Dithering Floyd Steinberg File Size as PNG 9 kB Generally higher quality specially of phtographic images Can approximate any shade of gray Larger file size than without dithering Back Text Generates artifacts e g a very bright gray paper is Bias Text approximated by far spread s
26. n the nearest font from the installed font collection is tailored to the metrics of the font 5 If the font is embedded then it is converted to outlines 6 In all other cases the nearest font from the installed font collection is used 1 e g Times Roman Helvetica Courier The outline of a glyph is a vector graphic without any reference to the original font program PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 33 of 34 July 1 2015 Installed Font Collection The installed font collection contains fonts from the directories SystemRoot Fonts and Fonts which must be a direct sub directory of where the product s executable resides The fonts and their properties are cached in a font cache located in the files TMP font database It is recommended to clear the cache if you add or remove fonts from the font directories Using the Font Mapping File fonts ini fonts ini is a configuration file to map fonts used in the PDF to fonts pre installed on the system The mapping file must reside a directory named Fonts which must be a direct sub directory of where the main DLL or executable resides The mapping file is optional It consists of two sections fonts and replace Both sections are used to map fonts in the PDF to fonts in the installed font collection on the operating system This comes into play when the font in the PDF document does not have an embe
27. nd white 1 bit Dithering for images with a color depth of 8 bit or higher 256 colors or grey scale has little to no visual impact PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 21 of 34 July 1 2015 Reference Manual 5 1 Supported Codecs The following table lists which capabilities of the different codecs are supported by the PDF to Image Converter Table Codecs Codec Bits Per Pixel Gray Indexed Quality Compression TIFF 1 2 4 8 24 Yes Yes Yes Raw Flate LZW JPEG Group3 Group3_2D Group4 JPEG 8 24 Yes No Yes JPEG Lossy only BMP 1 2 4 8 24 Yes Yes No Raw GIF 2 8 Yes Yes No LZW PNG 1 8 24 Yes Yes No Flate JBIG2 1 Yes No Yes JBIG2 Lossless Q 100 JPEG2000 8 24 Yes Yes Yes JPEG2000 Lossless Q 100 PBM 1 8 24 Yes No No Raw EPS 1 2 4 8 24 Yes No No Raw Codec The Compression Decompression Type Bits Per Pixel The supported values for bits per pixel 1 bi tonal 8 256 colors grey scales 24 true color Gray This format supports grey scale Indexed This format supports indexed colors Quality This format supports the setting of a quality parameter Compression Supported compression types For palette creation The number of palette entries is equal to 2 BitsPerPixel where BitsPerPixel is smaller or equal to 8 This means it is possible to create a 3 bits per pixel TIFF BMP or EPS but the palette
28. ortionally based on the other value Example The following command will generate an image that is 400x300 points pdf2img s 400 300 input pdf Set Width and Height of Image in Pixel This option can be used to set the dimensions of the image in pixels manually If either of the dimensions is set to 0 the value will be calculated proportionally based on the other value Example The following command creates a file with a width of 1024 pixels the height is calculated proportionally PDF Tools AG Premium PDF Technology j 3 Heights PDF to Image Converter Shell Version 4 5 Page 28 of 34 July 1 2015 pdf2img sp 1024 0 input pdf Set Width and Height in Pixel and Preserve Ratio The switch sa has the same effect as sp but the aspect ratio is preserved This means you can specify the maximum size allowed the image will then be scaled to fit one of the dimensions Example A 400 by 400 points PDF is converted with the option sa 600 800 The ratio width to height of the input file is preserved which is 1 1 The maximum that fits in 600 by 800 pixels is therefore a 600 by 600 pixel image Set Threshold When Dithering is Disabled When producing bi tonal images e g by the switches b 1 g3 or fax then the dithering mode is set with the h switch If no dithering is selected h 0 then the conversion of color or grayscale images is done by applying a threshold All pixels with brightness above the thre
29. other i e anti aliased Applying super sampling improves the image quality when rendering at low target resolutions 72 dpi or less the higher the target resolution the less the visual impact This setting requires memory and CPU time quadratically to the ratio therefore only small values such as s 2 or s 3 should be used If a too high value in combination with the original image size is set it is ignored Gray Color Space No longer supported Use the switch cs instead Dithering Mode Set the dithering mode Allowed values are Table Dithering Mode Value Description 0 no dithering 1 Default Floyd Steinberg 2 Halftone block 3 Halftone continuous 6 Atkinson dithering is very fast and produces images that can be PDF Tools AG Premium PDF Technology m ofp 3 Heights PDF to Image Converter Shell Version 4 5 Page 25 of 34 July 1 2015 compressed really well with a reasonably good image quality Dithering provides a better image quality especially for 1 bit images at the cost of a larger file size Example Disable dithering for a bi tonal image pdf2img h 0 b 1 input pdf Indexed Color Space No longer supported Use the switch cs instead Set Line Width Multiplication Factor In cases where lines are rendered with an undesired width e g too thin the switch If can be applied to scale them This option only affects lines It has no influence when lines ar
30. ply Flate compression to a TIFF image Image Content Dithering The content of the image itself has a direct impact on how well it compresses It seems quite obvious that a plain white image compresses much better than a page filling photograph Dithering is an algorithm that arranges the pixels of an image in a way that it creates a visual effect of colors that do not exist in the available colors of the image such as different grays in a 1 bit black and white image This complex arrangement of pixels PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 16 of 34 July 1 2015 however does not compress well and increase the file size Disabling dithering therefore reduces the file size In the PDF to Image Converter dithering is also implemented for color images Example Disable dithering e g for a black and white scanned text h 0 See also chapter Dithering 4 7 Options for Best Results on a Printer Regular laser printers use a resolution of 600 or 1200 dpi For best results on b w printers choose a resolution of the same value 600 dpi In this case it is also important to generate black and white images and thus set the bits per pixel to 1 Example Create a bi tonal 1200 dpi CCITI G4 compressed TIFF pdf2img b 1 d 1200 g4 input pdf output tif A compressed A4 black and white image with a resolution of 1200dpi will be about 1MB in size Note that using suc
31. rendering engine It is rather technical and it is not required to be understood in order to properly use the software The following steps are performed sequentially in the search of a font If a font is found the search is stopped otherwise the next step is performed 1 If the font is not embedded or ofp is set a If the font name appears in the Replace section in the configuration file fonts ini the name is replaced and looked up in the installed font collection b if it is a standard font it is replaced by the equivalent TrueType font name and it is looked up in the installed font collection c If the font name appears in the Fonts section in the configuration file fonts ini the name is replaced and looked up in the installed font collection d If the font has Italic or Bold in its name the font without these styles is looked up in the installed font collection 2 If a font name is looked up in the installed font collection then the name compare is performed as follows a PostScript name b TrueType name without blanks a missing style is interpreted as Regular or Normal c TrueType name without modifications 3 If the font is embedded it is converted to a Windows compatible font and temporarily installed If oe is used then the glyphs of the fonts are converted to either bitmaps or outlines If oo is used then the glyphs are converted to outlines only 4 If the font is not embedded and the Unicodes are available the
32. rsion of JPEG e g Photoshop 8 Z Compression ZIP ZIP is a lossless compression algorithm It is useful for the compression of large images with no loss in quality 5 4 pdf2pdfimg Specific Options ni Disable the copying of links Link annotations are not copied to the output document if this switch is used no Disable the copying of outlines Outlines Bookmarks are not copied to the output document if this switch is used nv Disable the copying of viewer preferences Viewer preferences are not copied to the output document if this switch is used 5 5 General Options v Verbose Mode This option turns on the verbose mode In the verbose mode the steps performed by pdf2img are described Example The command below pdf2img v input pdf will document the performed steps for example Rendering page 1 Rendering page 2 PDF Tools AG Premium PDF Technology Ik 3 Heights PDF to Image Converter Shell Version 4 5 Page 30 of 34 July 1 2015 Set License Key Pass a license key to the application at runtime instead of installing it on the system 5 6 Return Codes All return codes other than 0 indicate an error in the processing Table Return Codes VEILIG Description 0 1 2 3 4 Success PDF Input File could not be opened or invalid parameters PDF Output File could not be created Invalid option or option values were entered PDF Input File is encrypted and password is incorrect or not pro
33. shold are converted to white and all others to black The switch t can be used to set a custom threshold The allowed range is O all white to 255 all black The default value is 181 5 3 Compression Options Compression options can only be set for TIFF images For all other image types the compression is defined through the image format gif jpg etc Note that not all image viewer support all compression types for TIFF Compression CCITT Group 3 CCITT Group 3 is the predecessor to CCITT Group 4 it s a simpler algorithm that normally results in a weaker compression level Compression CCITT Group 4 CCITT Group 4 is the standard compression for bi level images i e facsimile Compression LZW LZW Lempel Ziv Welch compression is a lossless compression algorithm for images Please consult the copyright laws of your country prior to using this compression algorithm Compression JPEG TIFF allows images to be compressed with JPEG which is a lossy compression algorithm JPEG provides a high level compression of 8 and 24 bit images It is best PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 29 of 34 July 1 2015 suited for pictures but not for text images The image quality parameter is set to 75 per default j Compression JPEG 6 This is an older version of JPEG Certain older image software may support this compression but not the newer ve
34. sing option oq and set a suitable dithering algorithm option h Set the color management engine The transformation of colors from one color space to another is performed using a color management engine The default is the built in engine Icms Other choices are msicm which denotes the Windows CMS and neugebauer which is an algorithmic engine which doesn t work with profiles If this switch is set to none then the algorithms specified in the PDF reference are used Example The following command selects the neugebauer color management engine pdf2img cms neugebauer input pdf output jpg Center Mode Center the PDF This option is useful in combination with setting page dimensions PDF Tools AG Premium PDF Technology fax 3 Heights PDF to Image Converter Shell Version 4 5 Page 23 of 34 July 1 2015 Set the Color Space This options sets the color space Supported values are Table Color Space LE TIT Description 0 Grey scale 2 RGB 4 CMYK 7 Indexed 9 CMYK with K only Set the Resolution The default resolution is set to 150 dpi dots per inch This switch is redundant to the specialized switches dx and dy meaning the last switch set on the command takes precedence Example To set the resolution to a value to 100 dpi use the switch like this pdf2img d 100 input pdf Set the X Resolution Set the resolution only for the X axis The default resolution is set
35. size is equal as for 4 bits However the 3 bits per pixel image will compress better than the 4 bits per pixel image To create lossless JBIG2 and JPEG2000 images set the quality parameter to 100 For values 100 a lossy compression algorithm is applied PDF Tools AG Premium PDF Technology cms 3 Heights PDF to Image Converter Shell Version 4 5 Page 22 of 34 July 1 2015 5 2 Rendering Options Create one Image File per PDF Page The PDF to Image Converter creates multi page Tiffs by default For other formats that do not support multi paging it creates single page output files Example To generate one TIFF image for every page of the PDF input file the switch 1 can be used pdf2img 1 input pdf This will generate a series of one page Tiff images like this input 1 tif input 2 tif input 3 tif etc Example To specify the output name and directory use a command like this pdf2img 1 input pdf output d tiff The output files will then be named output l tiff output 2 tiff output 3 tiff etc Set the Bits per Pixel How many bits are used to represent one pixel The argument for this parameter depends on the image format see table Codecs For JPEG this option has two allowed values 8 for grey scale and 24 for true color Example The following command creates a grey scale JPEG image pdf2img b 8 input pdf output jpg When using 1 bit per pixel it is suggested to disable anti alia
36. st other image formats are single page formats General Settings pdf2img lk X XXXXX XXXXX XXXXX XXXXX XXXXX XXXXX input pdf output tif Pass a license key to the application at runtime instead of installing it on the system 4 3 Specify Image Type File Name and Output Folder The name and type of the output file can be specified using a second parameter Here is a list of supported extensions and the corresponding file type Table File Format Extension File Format tif tiff Tagged Image File Format Jpg jpe jpeg Joint Photographic Expert Group png Portable Network Graphics gif Graphics Interchange Format bmp Window Bitmap jb2 Joint Bi level Image Experts Group jp2 JPEG2000 jpx Extended JPEG2000 pbm pgm pnm ppm Portable Bitmap File Format eps Encapsulated PostScript Output only Example The following command creates a JPEG image in the current working folder pdf2img input pdf output jpg Example The output directory can simply be added in front of the output file name pdf2img input pdf myfolder output jpg or absolute pdf2img input pdf C myfolder output jpg PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 12 of 34 July 1 2015 Example Quotes must be used for paths or file names that contain blanks pdf2img My File pdf My Documents VMoutput jpg 4 4 Single Page or Multi Page Images By default the P
37. t Compression Type The 3 Heights PDF to Image Converter supports various image formats For most formats the compression is given For example a PNG image is always Flate compressed a JPEG image is always JPEG compressed However for TIFF the compression type is selectable Images formats that are supported by most Internet browsers are JPEG GIF and PNG There are two fundamentally different types of compression Lossless and lossy Lossless compression The transformation from the original to the compressed state of the image does not change the content Thus the transformation is reversible and the original image can be regained from the compression state Lossless compression is normally used for artificial images or scanned text It is applied to the following types of images GIF PNG BMP JPEG2000 if quality is set to 100 JBIG2 if quality is set to 100 and TIFF compressed with G3 G4 LZW or Flate Lossy compression The compression algorithm alters the content of the image in a way that it compresses better Thus a lossy compressed image cannot be reverted back to its original state It also means multiple applications of lossy compression to the same image alter the image every time and thereby reduce the quality every time How much the image may be altered to improve the compression rate is PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 15 of 34 July 1 2015
38. tch disables patterns Disable High Quality Rendering This switch disables anti aliasing Compatibility Note In previous versions the switch also disabled filtering which is no longer the case with the current version Use TrueType Fonts This swtich converts OpenType and Typel fonts to TrueType fonts Read an Encrypted PDF File When the input PDF file is encrypted and has a user password set the password to open the PDF the password can be provided with the switch p Example If the user password were userpwd then the command to read and process the encrypted PDF would look like this pdf2img p userpwd input pdf When a PDF is encrypted and the user password is not provided or is incorrect pdf2img cannot decrypt and read the file Instead it will generate the following error message Password wasn t correct Set Page Range With this switch the page range to be converted can be set Note that the output image format must support multi page TIFF and JBIG2 support multi page Example Convert only pages 1 through 3 pdf2img pg 1 3 input pdf output tif Set of Pages A set of pages can be defined using single pages ranges of pages and comma separated combinations thereof Example Convert pages 1 2 4 6 and 10 pdf2img pgs 1 2 4 6 10 input pdf output tif Set Image Quality of Lossy Compression This switch sets the image quality of images that are compressed using a lossy compression algorithm such as Jpe
39. vided PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 31 of 34 July 1 2015 Tips Ticks and Troubleshooting 6 1 General Pages Are Rotated Use the switch r to generate images with the same rotation as in the input PDF Generated Files Have a Large Size Read in the chapter User s Guide How to reduce the file size Images Are of too Low Quality Increase the DPI value to increase the resolution This is done with the switch d For lossy compression algorithms such as JPEG increase the quality parameter e g q 85 Image Does Not Contain the Whole Content This can happen when the switch s is used to set dimensions that have a different ratio than the original dimensions To automatically make the page fit the new dimensions use the switch Alternatively ensure the page dimensions of the image are large enough to hold the complete page Colors Are Gone The switch b allows you to set the bits per pixel For JPEG 8 bit is always grey scale since indexed colors are not supported for this format For TIFF and GIF the indexed colors need to be enabled if 8 bit is selected This is done with the switch i PDF Tools AG Premium PDF Technology 3 Heights PDF to Image Converter Shell Version 4 5 Page 32 of 34 July 1 2015 6 2 Text Font Replacement Strategy This section describes the exact behavior of font handling of the
40. which you would like to know the font name right click it select Properties installed font is the font family name of the installed font To retrieve this name find the font in the Windows font directory and open it by double clicking The first line in the property window displays the font family name this may vary depending on the operating system The font family name does not include font styles so an example of a font family name is Arial but not Arial Italic font style is an optional style that is added coma separated after the font family name The style is always one word Examples of font styles are Italic Bold BoldItalic Example fonts Ryumin Light MS Mincho GothicBBB Medium MS Gothic replace Ariallta Arial BoldItalic Other Ways to Deal with Text Issues The following list provides possible work arounds if text is printed incorrectly Options should be tried in ascending order 1 Using the option oe inhibits all embedded fonts from being used in the spool file and the printer hardware Instead the glyphs are converted to either bitmaps or outlines Using the option oo at the same time the conversion is restricted to outlines 2 Using the option ofp inhibits embedded fonts which have the same name as the corresponding installed font from being used 3 Pre render the page in a bitmap and use the pre rendered image ob 6 3 Transparency The 3 Heigths rendering engine
Download Pdf Manuals
Related Search