ARTS Split Pro 1.4 ARTS Split Pro Assistant Version 1.4 Page 1 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 1.0 Table of Contents 1.0 2.0 Table of Contents .................................................................................................. 2 Introduction............................................................................................................ 3 3.0 ARTS Split Pro Assistant Tools............................................................................. 4 3.1 Create a new coordinate file.............................................................................. 4 3.2 Open a coordinate file ....................................................................................... 4 3.3 Save a coordinate file........................................................................................ 5 3.4 Close a coordinate file....................................................................................... 5 3.5 View text as ARTS Split Pro does ..................................................................... 5 3.6 View text runs.................................................................................................... 6 3.7 Activate the rectangle tool ................................................................................. 6 4.0 Coordinate files ..................................................................................................... 7 4.1 Structure of commands ..................................................................................... 8 4.2 Rectangle commands........................................................................................ 9 4.3 Parameters...................................................................................................... 10 5.0 6.0 7.0 8.0 Frequently asked questions (FAQs).................................................................... 11 Troubleshooting................................................................................................... 12 Appendix A ­ Rectangle Commands .................................................................. 13 Appendix B ­ Split by Co-ordinate File Examples............................................... 17 Page 2 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 2.0 Introduction The ARTS Split Pro Assistant is a plug-in for adobe acrobat that assists the ARTS Split Pro user to create co-ordinate files of which are utilized when splitting PDFs with ARTS Split Pro. The ARTS Split Pro Assistant can be accessed via the ARTS Split Pro Assistant toolbar, or from the Adobe Acrobat plug-ins menu. Figure 1.8 - ARTS Split Pro toolbar Figure 1.9 - ARTS Split Pro menu Page 3 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 3.0 ARTS Split Pro Assistant Tools This section explains the tool buttons and menu items made available by the ARTS Split Pro Assistant plug-in. 3.1 Create a new coordinate file To create a coordinate file: 1. Click the 'Create a New CRD File' button ( ) on the ARTS Split Pro Assistant toolbar. You can alternatively go to 'Plug-ins > ARTS Split Pro Assistant > New' in the Adobe Acrobat plug-ins menu. 2. The Rectangle Tool ( ) is now automatically activated/selected enabling you to draw a rectangle on your PDF page. Drag a box over the area on the page that contains the text you wish to apply a command to. 3. The 'Rectangle Tool Properties' window will now appear. Select the command you wish to use for the rectangle you just created on your page. A short description for each command is can be found below the rectangle command drop-down list. Refer to Rectangle Commands. 4. Enter any parameter that is required for your command in the `parameters for command` text box. This is where you enter the text when you wish to see if a particular/literal string is present on the page. Refer to Parameters. 5. Click "OK". This command is now set to the rectangle currently selected. Note: for each rectangle only one rectangle command can be set. However, there is no limit to the number of rectangles that can exist within a coordinate file. Therefore if you wish to apply several commands to a particular piece of text then it is possible by creating another rectangle over the top of the existing one. 3.2 Open a coordinate file ) To open an existing coordinate file: 1. Select `Open' from the ARTS Split Pro menu or click on the open button ( located on the ARTS Split Pro toolbar. 2. Select the coordinate file to open. 3. Click "Open". Page 4 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 3.3 Save a coordinate file To save the active coordinate file: 1. Select `Save' from the ARTS Split Pro menu or click on the save button ( ) located on the ARTS Split Pro toolbar. 2. Enter a filename for your coordinate file and select the directory you wish to save to, ensuring that the file extension is of .crd type (it will be .crd by default). 3. Click "Save". 3.4 Close a coordinate file To close the active coordinate file, select `Close' from the ARTS Split Pro menu, or click on the close button ( ) located on the ARTS Split Pro toolbar. 3.5 View text as ARTS Split Pro does To view text as ARTS Split Pro does, select `Show Text' from the ARTS Split Pro menu, or click on the show text button ( ) located on the ARTS split pro toolbar. ARTS Split Pro recognizes text on pages differently to how the human eye does. This must be taken into consideration when using ARTS Split Pro Assistant as it could affect the accuracy of the users pdf splitting. It is recommended to use the `show text' tool when using the rectangle to ensure that the rectangle is positioned correctly around the text you wish to apply a command to. Figure 1.10 - how the human eye sees the text Figure 1.11 - how ARTS split pro sees the text (zoomed to 200%) Figure 1.10 and 1.11 show the difference between how the human eyes sees text on the page, and how ARTS split pro sees it. In figure 1.11, the red text is what ARTS Split Pro sees, and the text behind in and in figure 1.10 is how it appears to the user on the page. Page 5 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 3.6 View text runs ) located on the ARTS Split Pro toolbar. To view text runs, select `Show Run Start' from the ARTS Split Pro menu, or click on the close button ( ARTS Split Pro Assistant allows the user to see where the start of each text run starts on the page. A small red cross represents the start of each text run. This can be seen in the diagram below (displaying text runs in ARTS Split Pro Assistant). Figure 1.12 - displaying text runs in split pro assistant Within a PDF file, text is drawn by moving to a specific location on the page and drawing a line of text, which is formally known as a run of text. What appears to be one line of text can actually be made of a number of runs of text put together. In ARTS Split Pro, if a line of text begins inside a rectangle that you have created on your screen then the entire run of text is considered inside that rectangle. The rectangle that has been drawn in figure 1.12 contains two runs of text inside it, and as mentioned earlier the red crosses denote these runs of text. The text that ARTS Split Pro would recognize from this triangle and the two runs of text inside it are: · · R in the list o Down menu Note: if a line of text begins inside a rectangle, the entire run of text is considered "inside" that rectangle. The end of the rectangle in the figure 1.12 does not denote where ARTS Split Pro will stop reading the text, rather the end of the text runs that begin within the rectangle will. 3.7 Activate the rectangle tool To activate the rectangle tool, select `Activate Rectangle Tool' from the ARTS Split Pro ) located in the ARTS Split menu, or click on the `Activate the Rectangle Tool' button ( Pro toolbar. Following these same steps can also deactivate the rectangle tool. Page 6 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 4.0 Coordinate files A coordinate file is used by the ARTS Split Pro to split a pdf file based on the text on each page. The coordinate file uses the .crd extension, but it is a plain text file that can be edited with any text editor. Each line of the coordinate file starts with a command and is followed by the appropriate operands for the command. splitontextchange 507.406555 56.816055 535.184265 24.408707 addtofilename 507.406555 56.816055 535.184265 24.408707 "pageno " providefilename 504.628784 67.001236 543.517578 21.630936 An example of commands contained within a coordinate file (.crd) Editing the coordinate file with a text editor isn't required, as the ARTS Split Pro Assistant graphical user interface has been designed to allow the user to create coordinate files quickly and easily without the need to directly create or edit coordinate (text) files. Page 7 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 4.1 Structure of commands The structure for a complete rectangle command as it appears within the co-ordinate file is shown below: Command [space] left co-ordinate [space] top co-ordinate [space] bottom co-ordinate [space] right co-ordinate [space] "string" Example: splitiftextcontainedinbox 70.093918 736.859451 141.122421 703.214371 "arts" Where: Command = splitiftextcontainedinbox Left co-ordinate = 70.093918 Top co-ordinate = 736.859451 Bottom co-ordinate = 141.122421 Right co-ordinate = 703.214371 String parameter = arts Co-ordinates (left, top, bottom and top) are used to view the rectangle using ARTS Split Pro Assistant. It is the rectangle that is used to look at text in a PDF page used for the splitting of PDFs. Text within a rectangle area can be compared against the specified string parameter passed. Example: splitiftextcontainedinbox 70.093918 736.859451 141.122421 703.214371 "arts" The rectangle co-ordinates, 70.093918 736.859451 141.122421 703.214371, form a rectangle. The rectangle area is viewable on a PDF page using ARTS Split Pro Assistant. A rectangle can be viewed on each page of the PDF document. Depending on where the text run begins on the page, this rectangle may have text inside it. Using the splitIfTextContainedInBox command, if ARTS Split Pro finds that the "arts" string is found inside the rectangle area then the PDF will split at that page (i.e. PDF will split if the word "arts" is found within the text inside the rectangle). Page 8 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 4.2 Rectangle commands ARTS Split Pro allows the user to split PDF files based on the text that appears on the pages throughout a PDF document. The rectangle tool is used to select which text on the page will determine at which point/s the file is split, and this is where rectangle commands fit in. Each rectangle that is created on the pdf document using the rectangle tool in ARTS Split Pro Assistant has a user determined command/s related to it which will trigger when the pdf file is split, or also perform a number of other functions. How to set command/s for a rectangle: 1. Double click on a rectangle created by the rectangle tool in ARTS Split Pro. 2. The properties window should now appear and the drop down list of rectangle commands will be located near the top. The default command is `no command selected' which means there is no active command selected for this rectangle. Figure 1.13 - rectangle properties window 3. Select the command from the rectangle command drop down list. A short description will appear below the drop down list when you have selected a command. Page 9 of 21 ARTS Split Pro Assistant Documentation Copyright © 1998 ­ 2003 A Round Table Solution ARTS Split Pro 1.4 4.3 Parameters When creating co-ordinate files, particular rectangle commands may require a user specified text string to be entered in order to split PDFs the way the particular command is expected to. There is a text box in the rectangle tool properties window named `Parameters for command' where these text strings can be entered. An example for a parameter is when utilizing the `split if text contained in box' command when creating a co-ordinate file. This command checks if the parameter specified by the user within the parameter text box is present within the related ARTS Split Pro rectangle in the pdf file. If this string is present, then the file is split. Other commands that require a user specified text string are: · · · · · · · · · · · · · · · · · · · · SplitIfTextIsPresent SplitIfText ...