100 likes | 327 Views
SplitPDF. Split PDF files by bookmarks Gino Scheppers. E-mail: gino.scheppers@telenet.be. SplitPDF. SplitPDF (SplitPDF.jar) is a ‘command-line driven’ Java-program, it splits a PDF-file on bookmarklevel into separated PDF’s. The bookmark is used as title for the newly created PDF’s.
E N D
SplitPDF Split PDF files by bookmarks Gino Scheppers E-mail: gino.scheppers@telenet.be
SplitPDF • SplitPDF (SplitPDF.jar) is a ‘command-line driven’ Java-program, it splits a PDF-file on bookmarklevel into separated PDF’s. • The bookmark is used as title for the newly created PDF’s. • Compression of the created PDF is possible. • The program is platform independent. Runs in Windows, Sun Solaris, Unix, Linux,… • SplitPDF is freeware. • Requisites: • Java JRE 1.5 or higher
SplitPDF • Running the program with the –Help option, will result in an overview of all the available parameters. • Cmd: java –jar <installdir>\splitPDF.jar -Help
SplitPDF Tips: • SplitPDF can also be used as merge-tool • How: use a combination of the parameters • -bLevel 0 (no splitting will happen) • -cFileAfter • -cFileBefore • SplitPDF splits all PDF files in a folder and subfolders. • How: only use ‘drive:\folder’ as –iFile argument • The tool will pickup all the PDF’s in the folder and subfolders.
SplitPDF More Tips: • Commands are case-sensitive, example • -afterCmd “d:\temp\aftercmd.cmd” = correct • -aftercmd “d:\temp\aftercmd.cmd” = wrong • Some commands requires an argument, example: -oFolder <arg> where <arg>=outputfolder • Minimum one command-line is required (-iFile). • Splitting all PDF’s in a folder is possible. Use the folder name as argument for –iFile. • Using UNC (universal naming convention) notation is possible. • Example: R:\datakoepel => \\adfs\funtioneel\datakoepel • The output-folder is automatically created if it doesn’t exist. • Using a datetime indication in the output-folder name is possible. • MM=month • yy= year • dd=day • HH=hour • mm= minutes • ss=seconds
SplitPDF More Tips: • Before splitting cleaning the destination folder is possible with the cmd: ‘-CleanOutputFolder’ • The default level is the highest bookmark level (use -1 to split all levels) • Merging (after the split-proces) the PDF-file with a PDF before and after is possible (-cFileAfter <arg>, -cFileBefore <arg>) • Running a cmd-file or program before & after the split-proces is possible (-afterCmd <arg>,-beforeCmd <arg>) • Use the wildcardMatch cmd-line-option to only create a PDF if a match is found in the bookmark, use the characters '?' and '*' to represent a single or multiple wildcard characters. • Use the UniqueSplitFilename cmd-line-option to create a unique filename (orginal-filename+level+continuous number) instead of the bookmark-title if your bookmark-titles are not unique! • Bookmarks in PDF version 1.3 are not recognized, use the cmd-line-option –FixVersion to save the file in version 1.4 before starting the split process.
SplitPDF More Tips: • Report bursting alternative? • Although ‘multi-pass & single pass’ report bursting is a very nice feature, it still can be very slow. • Because SplitPDF splits PDF files on a technical level, it is much faster compared with report bursting. • Compared with BO 6.5.3, BO XI creates larger PDF files. With SplitPDF it is possible to compress the final PDF, with a level range from 0 to 9 • Contact: gino.scheppers@telenet.be
SplitPDF Known issues: • Splitting large PDF files can result in an Java out-of-memory problem. ‘Exception in thread "main" java.lang.OutOfMemoryError: Java heap space’ • Solution: • If the split-proces needs a lot of memory (more than 128 MB by default). In this case the Java heap size default can be increased using the following runtime parameters: • java -Xms<initial heap size> -Xmx<maximum heap size> • default: java -Xms32m -Xmx128m • Or try the JRE server parameter (installation of JRE server edition requiered) • Example • <installDir> Java –server –jar <installDir>SplitPDF.jar • Or • <installDir> Java –Xms64m –Xmx256m –jar <installDir>SplitPDF.jar
SplitPDF Known issues: • The name of the bookmark in the PDF must be a valid filename. Use the correct naming conventions for file names! • Best Practices • Don’it use a subfolder of the input folder as output folder, especially in case of the use of the option to split all files in the iFolder in combination with the –CleanOutputFolder • Wrong : -bLevel 1 –iFile c:\pdfs –oFile c:\pdfs\output –CleanOutputFolder • Correct : -bLevel 1 –iFile c:\pdfs –oFile c:\output –CleanOutputFolder • Rename pdf-files with name ‘dummy.pdf’ in an other name before splitting.
SplitPDF Versions • SplitPDF V1.4.0 new features: new cmd-lines uniqueSplitFilename & FixVersion • SplitPDF V1.3.0 new feature: Creates PDF only if the bookmark matches the specified wildcard • SplitPDF V1.2.1 BUG FIX PDF extension check • SplitPDF V1.2.0 new feature: new cmd-line -compressLevel • SplitPDF V1.1.0 new feature: split all pdf-files in iFile-folder