***DRAFT - 05Sep2018*** //was ***DRAFT - 24Apr2015*** //was ***DRAFT - 07Jan2012*** //was ***DRAFT - 01May2008*** ***NOTICE - THIS VERSION SHOULD BE USED ONLY WITH iText-2.1.7.jar*** README File for UPDF_GUI, _v3u Introduction UPDF_GUI, _v3u, is a Java-iText program for untiling multi-page PDFs similar to those created with ScaleAndTile3, _v3u & _v3v. It is distributed as an executable JAR file, requiring only a compatible Java Runtime Environment (JRE) and a copy of the iText library, iText-2.1.7.jar, in order for the program to be run on any Windows (95 to 10), Mac OS X, or Linux computer. While the program produces PDF files as output, it does not use any Adobe libraries or APIs, nor is any Adobe product required to use it. How to Install and Run UPDF_GUI, _v3u, Initial Setup 1. No installation at all is needed, if you already have Java Runtime Environment (JRE) on your computer. To see if JRE is present, execute "java -version" from a terminal window. If JRE is present, skip to step 3. 2. If you do not have the Java and iText required JRE on your computer, you must first download and install the required JRE from http://www.sun.com. 3. Copy the file UPDF_GUI_v3u.jar into the working directory you wish to use. 4. For Windows users, you can now create a Shortcut for launching the program. Move the Shortcut to your Desktop for easy launching of the program. 5. Copy the iText JAR file, iText-2.1.7.jar, and put it in the same working directory as in step 3 above. 6. Place any multi-page tiled PDF that you'd like to untile into the same working directory as in step 3 above. 7. From a terminal window, navigate to the working folder above and execute the command java -jar UPDF_GUI_v3u.jar so you can see the messages that are sent to the terminal window when you run the GUI application. 8. Please read the current license conditions that ensue when you run the program in step 7 above. 9. If you're using Windows, you should be able to launch the program by simply double-clicking on the icon for UPDF_GUI_v3u.jar. 10. Please report any problems via email. Running the Program 1. For Windows users, double-click on the UPDF_GUI_v3u.jar file icon or on the shortcut icon, to launch the program. Other users, launch the program from a terminal window by typing "java -jar UPDF_GUI_v3u.jar" at the command prompt. In either case, the UPDF_GUI, _v3u, Graphic User Interface (GUI) will appear on your Desktop. 2. The GUI has several more input fields/options than previous versions as follows: a. Input (PDF) - Enter the filename of a multi-page tiled PDF file. The filename extension .pdf/.PDF is mandatory. b. dimX and dimY - Enter the page width and height of the pages of the input PDF that you wish to untile. c. arrayX and arrayY - Enter the number of tiles per row & the number of rows in the array of tiles in the input PDF. d. gapX and gapY - Enter the sizes of the gaps between tiles in a row & the gaps between the rows in the array of tiles in the input PDF. e. Output (PDF) - Enter the filename that you wish to be used for the single-page, untiled PDF. A filename extension of .pdf is not required, as the extension ".pdf" is added automatically by the program, so any filename associations of your operating system will be able to associate the output file with your PDF Viewer. f. Do it! Button - Click on the Do it! button to run the program for the data which you have entered. The output file will appear in the working directory. Notes 1. Files named in the above fields must not duplicate the names of any files that are in use. Users should be aware that Acrobat/Adobe Reader puts a file lock on displayed PDFs, so PDFs may not be simultaneously viewed and modified by the program. 2. UPDF_GUI, _v3u, like the iText library, respects password protection incorporated in PDFs. Users should not expect the program to be able to untile such PDF files. Gifts Several Users have offered to pay for the use of UPDF. I have, so far, resisted the temptation to seek profit from UPDF, preferring instead to maintain the "free" model of distribution for as long as possible. For anyone who feels like showing their appreciation for the program via a charitable contribution, I would be glad to accept checks payable to "The Rotary Foundation" with the "For" line marked "EREY - William A. Segraves", which will be promptly turned over to The Rotary Foundation through the responsible committee chairman of the Rotary Club of Sarasota for transmittal to Rotary Headquarters. Please go to http://www.rotary.com to see the humanitarian uses to which your gifts will be applied. Thanks in advance for your generosity. Mailing address: William A. Segraves 5143 Sandy Beach Avenue Sarasota, FL 34242-1535 Email: wasegraves@bellsouth.net Telephone: 941-349-8227 License Terms and Conditions The copyright notice and license terms and conditions are embedded in the software. ************************************************ UPDF_GUI_v3u - a Java iText class for untiling a tiling tiled PDFs Copyright 2008-2015 - William A. Segraves - All Rights Reserved Free for personal non-commercial use only and may not be re-distributed or included in any other software Extra resources needed: JRE and iText-2.1.7.jar Usage (Windows): java -jar UPDF_GUI_v3u.jar (or double-click on the icon) Usage (Unix, Linux, Mac OSX): java -jar UPDF_GUI_v3u.jar In addition to the above, notice is hereby given that: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.