A
RTS Split Pro
Assistant
Version 1.4
ARTS Split Pro 1.4
ARTS Split Pro Assistant Documentation
Page 1 of 21 Copyright © 1998 – 2003 A Round Table Solution
ARTS Split Pro 1.4
1.0 Table of Contents
1.0 Table of Contents .................................................................................................. 2
2.0 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 Frequently asked questions (FAQs)....................................................................11
6.0 Troubleshooting................................................................................................... 12
7.0 Appendix A – Rectangle Commands ..................................................................13
8.0 Appendix B – Split by Co-ordinate File Examples...............................................17
ARTS Split Pro Assistant Documentation
Page 2 of 21 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
ARTS Split Pro Assistant Documentation
Page 3 of 21 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 (
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.
.
.
) on the ARTS Split Pro Assistant
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”.
ARTS Split Pro Assistant Documentation
Page 4 of 21 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.
ARTS Split Pro Assistant Documentation
Page 5 of 21 Copyright © 1998 – 2003 A Round Table Solution
ARTS Split Pro 1.4
3.6 View text runs
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).
) located on the ARTS Split Pro toolbar.
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
menu, or click on the ‘Activate the Rectangle Tool’ button (
Pro toolbar. Following these same steps can also deactivate the rectangle tool.
ARTS Split Pro Assistant Documentation
Page 6 of 21 Copyright © 1998 – 2003 A Round Table Solution
) located in the ARTS Split
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.
ARTS Split Pro Assistant Documentation
Page 7 of 21 Copyright © 1998 – 2003 A Round Table Solution
Loading...