arts-pdf split pro 2.0 User Manual

Page of 58
 
ARTS PDF Split Pro™ Guide 
 
Assistant 
 
Rectangle coordinates  
 
Rectangle coordinates (left, top, bottom and right) are used to view the rectangle using 
ARTS PDF Split Pro™ Assistant.  The rectangle is used to look at text on a PDF page 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 coordinates, 70.093918 736.859451 141.122421 703.214371, form a rectangle.  
The rectangle area is viewable on a PDF page using ARTS PDF 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 PDF 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.  
 
 
String parameter  
 
When creating coordinate 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 coordinate file. This command checks if the parameter specified by the 
user within the parameter text box is present within the related ARTS PDF Split Pro™ 
rectangle in the PDF file. If this string is present, then the file is split.  
  
Commands that do not require a specified text string are:  
•  SplitOnTextChange  
•  SkipHeader  
•  provideFilename  
•  provideFilenameFromFirstWord  
•  addToFilenameTextInBox  
•  excludeIfNoTextContainedInBox  
•  extractText  
 
Note: Version 2 users will find that coordinate files created by ARTS PDF Split Pro™  
Assistant have numeric values instead of a text string as the last parameter. This is to support 
Unicode.  Version 2 is backwards compatible and can still support string parameters if coordinate 
files have been created or edited manually.