***DRAFT - 12Dec2009)*** ***NOTICE - THIS VERSION SHOULD BE USED ONLY WITH iText-2.1.7.jar*** README File for ScaleAndTile4d ScaleAndTile4d Introduction ScaleAndTile4d is a Java-iText program for scaling and tiling images and PDFs. 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 Vista), 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. Improvements Among the improvements are a wide selection of popular tile sizes, a custom tile size capability, and tile alignment marks, borders, and sequence numbers, which may be optionally turned off for photo-realistic tiles. The new version has the same style of user interface as the original, making it possible for users with little or no computer experience to produce their own scaled plans, 3-views, photographs, etc., for printing on their own home computer printers. How to Install and Run ScaleAndTile4d 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 SATIP_GUI_v4d.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. Download a copy of the iText JAR file, iText-2.1.7.jar, from www.lowagie.com/iText and put it in the same working directory as in step 3 above. 6. Place any PDF or image files you'd like to scale and tile 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 SATIP_GUI_v4d.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 SATIP_GUI_v4d.jar. 10. Please report any problems via email. Running the Program 1. For Windows users, double-click on the SATIP_GUI_v4d.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 SATIP_GUI_v4d.jar" at the command prompt. In either case, the ScaleAndTile4d, 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 (img/PDF) - Enter the filename of an image file or a PDF file. The filename extension, .bmp, .gif, .jpg, .jp2, or .tif for image files, or .pdf for PDF files, is mandatory. b. PageNo - Enter the page number of the input PDF that you wish to scale and tile. c. ScaleFactorX and ScaleFactorY - Enter the scale factors that you wish to be applied to the input file, e.g., "1" makes output PDFs with the same size image as that of the input, while "2" doubles the size of the input image/PDF. Warning! Do not enter the scale factor in units of percent (If you do, the program will try to generate an output file that has about 10,000 times as many pages as necessary). The default values for the input fields are ScaleFactorX = 1 and ScaleFactorY = 1, so the values need not be entered if the default scale factors are desired. In addition, ScaleFactorY defaults to the value of ScaleFactorX, so ScaleFactorY need not be entered if equal scale factors are desired. d. Output (PDF) - Enter the filename that you wish to be used for the single-page, scaled PDF of the input image/PDF. A filename extension of .pdf is not required, as the extension "_p.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. e. Tile Size - Select the name of the tile size you wish to be used from the pull-down menu. Built-in names are NONE, LETTER, LETTERL, A4, A4L, LEGAL, LEGALL, 11x17, 11x17L (all rendered 1/2" smaller in each dimension, so they'll produce a 1/4" border when printed); 3x5, 3x5L, 4x6, 4x6L, 5x7, 5x7L, 8x10, 8x10L (all rendered actual size for printing on photo printers that are capable of producing borderless prints); 8V (8x80 vertical slice), 8H (80x8 horizontal slice), WALLPAPER (12.5x120 vertical slice for wallpaper). A CUSTOM command is available for producing tile sizes that are not in the built-in library, e.g., 13x39CUSTOM produces 13x39 (actual size) tiles, while 8.5x11CUSTOM produces letter-size (actual size) tiles. The letter "L" on the end of some library sizes produces landscape orientation of the corresponding size tiles. Any error/typo in the specification of a Tile Size results in the selection of the default LETTER Tile Size. Finally, NOBORDERS, NOMARKS, NOSEQNOS commands (in this order only) may be appended to the TileSize via selected CheckBoxes, which turns off the default borders, (alignment) marks, and sequence numbers, respectively, so photo-realistic scaled images can be produced without the aforementioned borders, marks, and sequence numbers. f. Output (PDF, Tiled) (Hidden) - The program automatically generates the filename for the PDF file containing the tiles of the scaled PDF from the filename of the single-page scaled PDF of the input image/PDF. A filename extension of "_p_tiled.pdf" is automatically provided, so any filename associations of your operating system will be able to associate the output file with your PDF Viewer. g. Do it! Button - Click on the Do it! button to run the program for the data which you have entered. The output files will appear in the working directory. h. Tile Size & Style (Hidden by default. Pull down the bottom edge of the GUI to reveal addional field/options.) - Enter a custom tile size if none of the built-in tile sizes suits your requirements. Grids, borders, (alignment) marks, and sequence numbers are "On" by default. Any of them may be turned "Off" by selecting the corresponding CheckBox. i. Crop Single-Page Output PDF Before Tiling - Enter the amounts by which you wish to crop each of the edges of the single-page output PDF before tiling. 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. ScaleAndTile4, _v1, like the iText library, respects password protection incorporated in PDFs. Users should not expect ScaleAndTile4, _v1, to be able to scale and tile such PDF files. Gifts Several Users have offered to pay for the use of ScaleAndTile. I have, so far, resisted the temptation to seek profit from ScaleAndTile, 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 my local Rotary Club 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 Ave 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 and are printed to the standard output (STD) each time the program is run. These messages are not normally seen by, e.g., a Windows user who launches the program by double-clicking on the program's icon, or by using a shortcut. A typical output is repeated here, for the convenience of all users. ************************************************ SATIP_GUI_v4d - a GUI version of ScaleAndTile - a Java iText class for scaling a nd tiling images and PDFs Copyright 2009 - 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 SATIP_GUI_v4d.jar (or double-click on the icon) Usage (Unix, Linux, Mac OSX): java -jar SATIP_GUI_v4d.jar ************************************************ You entered infile = Skyote_3_View.jpg You entered pagenumber = 1 You entered scalefactorx = 6.93 You entered scalefactory = 6.93 You entered outfile1 = ss30_p1.pdf You entered tilesize = LETTER You entered outfile2 = ss30_p1_tiled.pdf Success! ScaleAndTile3, _v4d, was run with the above params. ************************************************ 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.