Generating Static Graphics

Developing Web Presentations with the JAVAIMG and ACTXIMG Devices

You can use the JAVAIMG and ACTXIMG devices to create Web presentations that include snapshots of graphs that are generated with the JAVA and ACTIVEX devices, but without the interactivity that JAVA and ACTIVEX graphs provide. You can also add data tips and drill-down links to your graphs.

About the JAVAIMG and the ACTXIMG Devices

The JAVAIMG and ACTXIMG devices enable you to generate Web presentations that display a snapshot of one or more graphs in the PNG format. The ACTXIMG device works on PC hosts only. On all other hosts, the ACTXIMG device defaults to using the JAVAIMG device.

When you run a program that specifies the ACTXIMG device, the SAS/GRAPH ActiveX Control runs in the background to generate the PNG files. This means that you must install the SAS/GRAPH ActiveX Control on your computer before you can use the ACTXIMG device. For information on installing the ActiveX control, see Installing the SAS/GRAPH ActiveX Control. SAS/GRAPH procedures that can be used with the ACTXIMG device are the same as those that can be used with the SAS/GRAPH ActiveX Control, as listed in Procedures and Statements that Generate Output for the SAS/GRAPH ActiveX Control. The procedures that can be used with the JAVAIMG device are listed in Graph, Map, Tilechart, and Contour Applets.

The resulting PNG files can be viewed in any supported browser that supports the PNG format--neither Java nor ActiveX is required to view them.

The PNG files are identical in appearance to the graphs created with the DEVICE=JAVA or DEVICE=ACTIVEX graphics option as they are initially displayed in a browser. However, unlike these latter graphs, which are interactive and can be manipulated by a user viewing them in a browser, the PNG files are static and their appearance cannot be changed after they are created.

Note: With the JAVAIMG and ACTXIMG devices, the titles and footnotes are always stored in the HTML file and not in the graphics output files regardless of whether the GTITLE and GFOOTNOTE options are set. See Controlling Titles and Footnotes with Java and ActiveX Devices in HTML Output. [cautionend]

When to Use the JAVAIMG or ACTXIMG Device

If you do not need interactivity such as changing the chart type or style, the JAVAIMG and ACTXIMG devices provide several advantages over the interactive presentations that are generated with the JAVA and ACTIVEX devices. Because PNG image files are generated, the Web clients are not required to access the Java run-time environment or install the SAS/GRAPH ActiveX Control to display the graphs. Also, Web performance improves because the PNG image files are smaller in size than the HTML files that are required to run an applet or an ActiveX control.

Note: The ACTXIMG device cannot be used with the ODS PDF, PCL, PS, or PRINTER destinations on 64-bit computers. The SAS/GRAPH software uses the JAVAIMG device instead. [cautionend]

Some of the SAS/GRAPH procedures, such as the GKPI and GEAREABAR procedures, support only the JAVA, JAVAIMG, ACTIVEX, and ACTXIMG devices. For these procedures, you must use the JAVAIMG or the ACTXIMG device if you need a static image.

Finally, in some cases such as plots generated with the G3D procedure, the ACTXIMG and JAVAIMG devices provide a better static image than the other devices.

Note: When SAS is installed on a server, the ACTXIMG and JAVAIMG devices are limited by the display capabilities of the server on which they run--for example, the number of colors that the server is capable of. Consequently, the ACTXIMG or JAVAIMG PNG snapshot might not look as good as what you get from the JAVA and ACTIVEX devices. Therefore, it is better to use the JAVA or ACTIVEX device if the server's display settings are less than optimal. [cautionend]

Using JAVAIMG in the z/OS Environment

If you are running SAS in the z/OS operating environment with the DEVICE=JAVAIMG graphics option, then you must specify FILESYSTEM=HFS because HFS file space is needed to write the graphics output files. You might also need to increase the amount of memory that is allotted for your session so that SAS can run Java in the background. The suggested region size is 400 megabytes. For a batch job, add either REGION=400M or REGION=409600K to the JOB card. For a TSO session, specify SIZE(409600). For more information, refer to your JCL reference manual.

Generating an HTML Output File Using the JAVAIMG or the ACTXIMG Device

The procedure for generating an HTML output file for viewing JAVAIMG or ACTXIMG device output is similar to the procedure for generating an HTML output file for the GIF, PNG, SVG, or JPEG devices. See Generating an HTML Output File Using the GIF, PNG, SVG, or JPEG Device.

For an example, see Using the ACTXIMG Device.

Top of Page