TIFFY ViewEdition 3.3 for Java™Table of contents:
IntroductionTIFFY View Java Edition is a modern, platform-independent application to view and print images of the following formats: TIFF, BMP, GIF, JPG, PNG. It can be used on any system for that a Java Virtual Machine (also called Java Runtime Environment) is available, e.g. all 32 Bit Windows versions, MacOS, OS/2, Sun Solaris, LINUX. Using new speed optimized Virtual Machines with JIT-compilation, TIFFY View Java Edition catches up with the high speed image processors like TIFFY Pro (available for DOS since many years) and many other native code applications due to its speed optimized code. The new version now runs as a 32 Bit Windows-application, taking advantage of its modern graphic subsystem and printer drivers. Usable as applet and as standalone application conform to the "100% pure Java concept", TIFFY gives you best safety for your investment in a modern information infrastructure. The program can extend any Java capable web browser with a powerful component for electronic document management based on standard Internet/Intranet technology. TIFFY View can be run with VMs conform to the Java 1.1 standard with nearly full functionality. Some particular functions like the creation of thumbnail previews and screen optimized web presentations are available, if the underlying Java runtime environment implements Java 1.2 or higher. Links to recommended VMs you will find in the installation instructions. If you would like to extend your own Java applet/application with a viewer based on the powerful Java classes of TIFFY you can get the TIFFY Java Toolkit. For details please refer to the homepage http://www.tiffy.de. InstallationInstallation as standalone application for users of Windows 95, 98, ME, NT, 2000, XP etc.: Tiffy View is available as MSI package for
automatic installation with the Microsoft Windows Installer (MSI 2.0 or higher).
If you use at least Windows 2000 SP3 or newer versions,
MSI 2.0 is already preinstalled. For earlier Windows versions
you can download it at the Microsft web site. In order to install
Tiffy View, simply open (execute) the MSI package and follow the
instructions to select the path for installation. If you
want to deinstall the software, you can use the software control
of the Windows control panel. Installation as standalone application for users of other operating systems: Unpack TIFFY View from the ZIP archive to
a directory of your choice.To run the program as
standalone application a Java virtual machine (VM) is
required. Below you find a list of sources for Java
runtime environments for several operating systems. Installation on a web server for use as a Java applet in the Internet/Intranet: TIFFY View can be run as "Applet" from an HTML-page. Based on Internet/Intranet-technology a powerful information infrastructure can be set up including file formats like TIFF. All you need is a Java capable web browser on client side like Netscape Navigator (version 3.0 or higher), Microsoft Internet Explorer (version 3.02 or higher). This is an example, how to include an Applet-Tag into an HTML-page (for details please refer to the section command line options): <applet code=Tiffy.class archive="Tiffy.jar,TiffyJAI.jar" id=Tiffy width=560 height=120 > <param name="cabbase" value="TiffyApplets.cab"> <param name=Filename value="[image filename or URL]"> <param name=options value="[options]"> Sorry, your browser is not capable of running java applets. </applet> Note 1: Note 2: Note 3: <param name="useslibrary" value="Tiffy"> Latest versions of Java virtual machines are available from:
Starting the Program, Command Line OptionsUsing as standalone application with Windows 95, 98, ME, NT or 2000, XP etc.: If you installed TIFFY View using the MSI package for the Microsoft installer, an entry in Windows startmenu will be generated automatically. TIFFY can also be started directly as 32 Bit Windows application either from the command line or from the Windows Explorer: jTiffy [optional parameters] You may also drag and drop image files to the jTiffy program. The default virtual machine used by jTiffy is javaw.exe. To use an alternative VM, you can define the pathname in jTiffy.ini using a standard text editor. jTiffy tries to detect all necessary CLASSPATH settings automatically. If starting jTiffy fails, you may have to add the path of your standard Java class library (classes.zip or rt.jar) to your CLASSPATH environment variable (e.g. set CLASSPATH=c:\jdk1.1.8\lib\classes.zip). Alternatively you can start TIFFY
java -cp Tiffy.jar Tiffy [optional parameters]or jre -cp Tiffy.jar Tiffy [optional parameters]Sun's Java Runtime Environment provides further commandline options, e.g. to make more memory available to the Java application. This can be usefull if you work with very large image files. To provide for example 512MB heap memory: java -cp Tiffy.jar -Xmx512M Tiffy [optional parameters] Hint: Associating TIFFY as default application to display TIFF-files in Windows: In the file type (view-)options of your Windows Explorer (where you
can maintain applications related to file extensions) you should add
(or modify) an entry for files registered to type "TIFF" or
"TIF Image Document". The content (MIME) type should be set
to image/tiff and the default extensions Using TIFFY as standalone application with other operating systems: Depending on the Java VM installed on your operating system TIFFY is started by prepending it with the name of the VM's executable (e.g. Sun's 'java' from the JDK): java Tiffy [optional parameters] It is recommended to start the application from it's own directory (where you find the file Tiffy.class). If you use older VMs (before version 1.1), you may have to add the path of your TIFFY directory to the environment 'CLASSPATH'. Using TIFFY as applet in the Internet/Intranet: Please read the installation instructions in the section 'installation'. Simply open the HTML-Page that contains the applet-tag in your browser. Note:
If the write protection was not set, Netscape will remove the entry from the 'prefs.js' file. Note: Optional startup parameters: The following commandline parameters can be used when TIFFY is started:
You can also pass along parameters for an applet using the 'param'-tag on your web page (see the example in the section 'installation'). File and Printing FunctionsIn the file menu you will find functions to open, print and close images. TIFFY provides two open dialogs. You can use either the standard open dialog of your operating systems or a special preview open dialog with simple file manager options. You may either open the new image in a seperate window or replace the currently viewed image. Optionally you can use a thumbnail catalog preview . If you have installed a JDK 1.2 (or higher) compatible Java VM and if you have write permission in an image directory, the thumbnails will be stored in a subdirectory "thumbnails" in JPG format in order to speed up future access to the catalog. When TIFFY is executed using a Java VM version 1.1 or higher, printing is availabe. You may either print the whole image or the currently viewed area or print 1:1 with original measurement. In a print preview dialog you can control the paper settings, size, orientation and printable area. The paper settings are permanently saved when TIFFY is run as standalone application. The preview dialog is followed by the standard printer settings dialog of your operating system. We experienced different printing qualities depending on the Java Virtual Machine (JVM). At the time of this writing, many applets provide printing with Microsofts JVM (JView and MS Internet Explorer) only at approx. 72 dpi regardless the resolution of the image and the printer's physical resolution. Since version 2.0.1 TIFFY allows to print at resolutions higher than 72 dpi even with Microsofts JVM. The resolution (e.g. 300 dpi) can be selected in TIFFY's print dialog. Be careful with high values as this consumes a lot of system memory during printing due to an inefficient printing implementation in Microsoft's JVM . Sun's JDK 1.1.x printed at full resolution but crashed with huge images. With Java 2 (Sun's JDK/JRE/Plugin since rel. 1.2) TIFFY uses the new Java 2 classes for printing which allow tiling an image across several sheets as well but which consume more memory especially when printing multiple pages in one go. Best printing results with standalone applications were achieved with IBM's JDK 1.1.8 ( http://www.ibm.com/java) and Sun's JDK/JRE/Plugin since version 1.3 and TIFFY Version 2.5.1. If you run out of memory during large print jobs you should either use optional parameter /lightprint or increase heap memory settings (e.g JDK/JRE parameter -mx768M for Java 1 and -Xmx768M for JDK/JRE 1.2 and higher). If you still run out of memory, you can force JDK 1.1 compatible printing even with Java 2 and higher by enabling that option in TIFFY's print dialog. For applets running in a web browser you have the option to install a Java Plugin from Sun (use at least release 1.3 because 1.2.2 also has a limited printing quality; http://java.sun.com/products/plugin/index.html). Early versions of the Java Plugin required a modification in the HTML-code of the displayed page in order to be displayed in MS INternet Explorer. Sun provides a "HTML-Converter" tool for that purpose. Please see also example SwingTiffy.html. Meanwhile the Java Plugin integrates seemless into the Internet Explorer so that no modified version of the HTML pages are required. To use the open and print functions also when the program was started as an applet in a web browser, it must be digitally signed. TIFFY is signed with a class 3 certificate issued by Thawte.
Slideshows / Web PresentationsIn the file menu you will find additional functions to open, edit and save slideshows. After selecting the slideshow edit function you will see a preview dialog that provides a list of already selected files. You can switch to the thumbnail catalog here and in this case multiple selection is available as well. Controls allow to chose delay and optimized scaling. If no duration is specified the slide will last until a key is pressed or the mouse is clicked. Auto repeat can be switched on and off for the whole show. To pause a running show when duration was specified simply press the 'P'-key. Any key pressed afterwards will continue with the show. To leave the fullscreen show finally just hit the 'Esc'-key. After editing the show can be safed as slide list in the file menu. To start the show please use the function 'fullscreen / slideshow' in the view menu. Launching the slideshow directly from the commandline is possible by prepending the filename with an '@' character. Alternatively you can create a HTML based web presentation from the file menu. Tiffy will create some additional files (e.g. index.html and images in medium resolution). From this HTML page you are able to see an overwiev in medium resolution (max. 800 pixel width, max.600 pixel height) and you can call the images as selection in the Tiffy viewer. Additionally you can start slideshows in two different resolutions from here. Hints:
View FunctionsThe view menu provides functions that control the position and scaling of the image and the display quality. Additional functions are availabe as keyboard commands:
Smooth scaling improves the display quality
significantly when line drawings or scanned text
documents are scaled down. In relation to the image size
you may consider some delay until the result is visible.
This option is only available on Java VMs of version 1.1
or higher. With "Fullscreen / Slideshow" you can display the current
image in fullscreen mode or - if a slideshow was loaded/edited - you
can the slide show in fullscreen mode. The information function will show you some details about your picture like the resolution in pixels per inch, color depth and more. AnnotationsTiffy supports the display and as of version 3.0 also interactive editing of annotations ("redlining"). Displaying and editing can be enabled and disabled with the annoation button from the toolbar. If enabled, you se an additional annotation toolbar at the bottom of the display window. The annotations are saved in a separate file so the original image file remains unchanged. As there are several formats in the market for document management systems but no standard, we decided to implement our own format with focus on easy conversion from other formats. Tiffy uses an XML-based format. An example (provided together with image 'images/00441.tif') shall give you an impression how it looks like: <ANNOTATIONS>
<PAGE>
<TEXT X=0.0415 Y=0.2255 TEXTCOLOR=blue
FONT=SansSerif.bolditalic SIZE=0.05>Annotations!</TEXT>
<RECTANGLE X=0.3005 Y=0.2859 WIDTH=0.1407 HEIGHT=0.0287
OUTLINECOLOR=none FILLCOLOR=yellow MODE=XOR></RECTANGLE>
<POLYGON OUTLINECOLOR=blue FILLCOLOR=orange>0.7158 0.2200
0.6804 0.2200 0.6620 0.2356 0.6620 0.2623 0.7134 0.2623
0.7164 0.2603 0.7193 0.2574 0.7203 0.2538 0.7198 0.2497
0.7187 0.2482 0.7158 0.2455 0.7121 0.2428 0.7087 0.2392
0.7074 0.2347 0.7071 0.2302 0.7082 0.2263 0.7095 0.2243
0.7108 0.2225 0.7126 0.2216 0.7158 0.2200</POLYGON>
<TEXT X=0.66 Y=0.2715 TEXTCOLOR=blue FONT=SansSerif SIZE=0.018>Polygon +
Freehand</TEXT>
<MEMO X=0.64 Y=0.02 WIDTH=0.11 HEIGHT=0.09 OUTLINECOLOR=black
FILLCOLOR=yellow TEXTCOLOR=black FONT=Serif.bold
SIZE=0.024>Memo
(remo-
vable ;-)</MEMO>
<ELLIPSE X=0.6275 Y=0.1420 WIDTH=0.0476 HEIGHT=0.0341
OUTLINECOLOR=red FILLCOLOR=none></ELLIPSE>
<ELLIPSE X=0.395 Y=0.465 WIDTH=0.04 HEIGHT=0.035
OUTLINECOLOR=none FILLCOLOR=magenta MODE=XOR></ELLIPSE>
<IMAGE X=0.2994 Y=0.0080 WIDTH=0.2116
HEIGHT=0.0782>images/approved.gif</IMAGE>
</PAGE>
Here is a list of supported XML-tags:
(The syntax has changed slightly from version 2.x, e.g. the tags <rect> and <fillrect> are replaced now with <rectangle>. Annotation files created for earlier version are still display correctly to keep backward compatibility) Coordinates are normalized floating values between 0 and 1, where 0 is the left or upper border and 1 is the right or lower boarder of the image. This results in the ability to store annotations independent of the images resoltion. Text is located so that the upper left edge of the bounding box meets the x,y-position given for the text. The following color attributes are available: Platform independent (logical) font names are: Creating and editing of annotations The editor allows you to save the annoations as a XML file in
your file system. By default the path and name will be the same as for
the current image but with replaced filename extension ".xml". If you
want to embed Tiffy View in a client/server based document management
application you will have to implement a mechanism to update the
annotations on server side automatically. For details please consult
the author of this software. TransformationsCurrently an inversion function and 90, 180 and 270 degree rotations are available. Additionally you can mirror the image horizontally or vertically. Getting HelpIn the help menu you can get some information about using this program and how to register it. If you received a license key you can enter it here to make your trial version to a fully licensed version. Saving the registration information requires disk access, so this is only possible when you run the program as standalone application. Additioally a summary with keyboard shortcuts is available from the help menu and the button panel. Art&Computer Hackbarth
|