Radscaper

Radscaper is a Java applet component and it can be embedded into any static or dynamic Web page such as HTML, ASP, JSP, PHP, etc. It also can be integrated with any PACS system that provides a Web interface. Target Dicom image files can be ZIP'ed or GZIP'ed. If you choose to use zip format, add only one DICOM file in each zip package. Only first file in a zip package will be read otherwise.

Compatibility

Platform	Server OS	Web Server	Client Browser and Java VM
Windows	Most Windows versions	Any Web Server including Apache and IIS	Any Web browser and Sun JRE 1.6 or later plus JAI Image I/O 1.0 or later
Linux	Most Linux versions	Any Web Server such as Apache	Any Web browser and Sun JRE 1.6 or later plus JAI Image I/O 1.0 or later
Mac OS	Not supported	Not supported	Any Web browser and Sun JRE 1.6 or later plus JAI Image I/O 1.0 or later

How to Increase Memory for Java Applet

To load a large number of images, 1 GB or more memory is recommended for the system on which images are displayed.

If you are encountering out-of-memory problem, you can increase memory from the Java Control Panel by clicking Start->Settings->Control Panel->Java. In Java Control Panel, select Java tab and click View button in Java Applet Runtime Settings. In Java Runtime Settings, type in -XmxNNNm in Java Runtime Parameters field, where NNN is the number of MB and must be a power of 2. For example, if your system has 1GB memory, you may want to set up 768 MB by entering -Xmx768m. In most cases, Firefox browser can use more memory than IE browser.

How to Write Applet Block in HTML

In HTML, the applet block includes parameters listed below.

Name	Value	Required	Description
Config	relative_path/config_xml_file	Yes	The configuration file must be deployed on the same Web server. config.xml is such an example.
DicomImgN	relative_path/dicom_image_file local_path/dicom_image_file URL	No	Zero or multiple entries. N starts from 1 in sequence. An image file can be an ordinary Dicom format, ZIP'ed or GZIP'ed Dicom image.
DcmImgLst	relative_path/image_list_file	No	Image list file is a text file in which each line contains an image file name with relative or local path or an URL.

A relative path is a path to the folder which is relative to the folder where the applet containing page (HTML file) resides. A local path is a full path to a folder which the server can access.

==== An example of applet block embedded in HTML ====
<HTML><BODY>
<APPLET archive=radscaper.jar codebase=./ code=com.divinev.radscaper.Main.class width=100% height=100%>
<PARAM NAME=Config VALUE=config.xml>
<PARAM NAME=DicomImg1 VALUE="relative_path1/image1.dcm.zip">
<PARAM NAME=DicomImg2 VALUE="http://third_party_hostname/path2/image2.dcm">
<PARAM NAME=DicomImg2 VALUE="https://third_party_hostname/path3/image3.dcm">
<PARAM NAME=DicomImg3 VALUE="C:\path4\image4.dcm">
<PARAM NAME=DicomImg4 VALUE="\\server_name\path5\image5.dcm">
<PARAM NAME=DcmImgLst VALUE="relative_path2/image_list_file">
</APPLET>
</BODY></HTML>
==== An example of applet block embedded in HTML ====

==== An example of image list file ====
relative_path1/image1.dcm.zip
http://localhost/path2/image2.dcm.gz
https://third_party_hostname/path3/image3.dcm
C:\path4\image4.dcm
\\server_name\path5\image5.dcm
==== An example of image list file ====

Where to Store Registration File - radscaper.bin (for registered licenses only)

Place the registration file at the place defined in the configuration file. Do NOT place your registration file in the place exposed to public by your web server because it will substantially cause the unlawful redistribution of your registration file, which is prohibited.

Give a read permission to everyone for this registration file from its security tab in properties page by right clicking on it for Windows. Linux user can do it by command "chmod 444 radscaper.bin".

Where to Store Data File - radscaper.dat

Leave data file radscaper.dat in the folder where APPLETHELPER stays.

Give a read and write permission to everyone for this data file from its security tab in properties page by right clicking on it for Windows. Linux user can do it by command "chmod 666 radscaper.dat".

How to Modify config.xml

For Linux server, you need to change the following line
<appletHelper>cgi-bin/AppletHelper.exe</appletHelper>
to
<appletHelper>cgi-bin/AppletHelper</appletHelper>.

Many parameters can be changed in this file according to your specific needs.

How to Configure CGI for Apache Web Server

Add the following lines into the end of the Apache's httpd.conf file and restart Apache server.

==== CGI setup for Apache web server ====
#
# ScriptAlias to run AppletHelper for Radscaper
#
ScriptAlias /radscaper/cgi-bin/ "C:/www/radscaper/cgi-bin/"
<Directory "C:/www/radscaper/cgi-bin/">
    AllowOverride None
    Options None
    Order allow,deny
    Allow from all
</Directory>
==== CGI setup for Apache web server ====

You may change the path as required. Place APPLETHELPER in folder cgi-bin and make it executable to everyone.

How to Configure CGI for Windows IIS Web Server

Add a folder cgi-bin into your web folder and place APPLETHELPER in it.
Make APPLETHELPER executable to everyone.
Open the IIS snap-in. From the Start menu, click Run, and type inetmgr in Run text box.
Find the folder cgi-bin under your website in left window. Right click cgi-bin and select Properties. Select Directory tab, choose Scripts and Executables in Execute Permissions text box to allow CGI application.
If you are using IIS on Windows 2003, make sure CGI has been allowed from Web Service Extensions.

How to Troubleshoot

Log messages from Java Applet Console and Web server provide helpful information for troubleshooting. They are always the first place for you to check.

Step	Test	Action	Expected Response	Possible Failure and Cause
1.	Java applet	http://your_host/your_path/radscaper.jar	radscaper.jar is to be downloaded	Web server is not set appropriately or file radscaper.jar doesn't have a read permission to everyone.
2.	AppletHelper compatibility	Run APPLETHELPER in a DOS command window or a Linux shell	AppletHelper x.x Copyright 200x Divinev. All rights reserved.	APPLETHELPER doesn't have execute permission or system library files missing.
3.	AppletHelper CGI setup	http://your_host/your_path/cgi-bin/APPLETHELPER	AppletHelper x.x	APPLETHELPER doesn't exist or doesn't have execute permission to everyone. CGI was not appropriately configured with your Web server.
4.	Data file radscaper.dat	http://your_host/your_path/cgi-bin/APPLETHELPER?cmd=dat	Success in accessing radscaper.dat	radscaper.dat doesn't exist or doesn't have a read and write permission to everyone.
5.	Configuration file	http://your_host/your_path/config.xml	An XML file	The configuration file doesn't exist or doesn't have read permission to everyone.

Where APPLETHELPER is AppletHelper.exe for Windows and AppletHelper for Linux.

Performance Optimization

Radscaper loads number of images into memory buffer on client machines for manipulation. The buffer size can be explicitly specified by user or automatically set by the software intelligence module according to configuration. Increasing memory for Java applet can greatly improve the performance of the software. If the client system cannot hold all images in memory, the buffer will be rotated to cache images predicted by the program. In such cases, same images may be reloaded more than once. To reduce network traffic and latency, Radscaaper supports local cache facilitated by JRE on client disk. However, JRE only supports caching static network files that Java applet can load. It's recommended to put images on the same web server where radscaper.jar comes from such as in the folders that are the subfolders of the one containing radscaper.jar. The images loaded from these locations can be cached on client machines if cache is enabled in configuration file. Following are the thumb rules for setting image names in <APPLET> or image list file.

Absolution path to the image file, e.g., C:\radscaper_folder\myfolder\myimage or /radscaper_folder/myfolder/myimage.
URL path to the image file, e.g., http://myserver/myfolder/myimage.
Path to the image file relative to the folder containing radscaper.jar, e.g., myfolder/myimage.

To increase the cache space, you can open Java Control Panel by clicking Start->Settings->Control Panel->Java. In Java Control Panel, click Settings from General tab. Follow the instruction and set enough disk space for cache.

Enable Status Bar for Internet Explorer 7

The status bar is disable by Internet Explorer 7 in default. In order to display image information, it can be enabled by following "Start->Control Panel->Internet Options->Security->Customer Level->Scripting->Allow status bar updates via script->Enable".