Perforce JViews Gantt Sample: Custom Rendering Effects

Description

This sample shows how to customize activity rendering using the advanced graphics features of the Java2 API.

How to Use the Sample

• The majority of the user interface is the same as that of the Gantt Sample on which it is based.
• Use the Graphics check box on the right side of the sample window to toggle anti-aliasing of the graphics in the Gantt sheet. Note, that anti-aliasing of text labels is handled independently.
• Use the Text check box on the right side of the sample window to toggle anti-aliasing of the text labels in the Gantt sheet.
• When you hover the mouse over each activity or constraint graphic, a hover highlight image operation can be applied. Use the Hover Highlighting combination box to select one of the predefined hover highlighting modes. Refer to the Hover Highlight code example in the JViews Framework for examples of custom hover highlighting image operations.
• Use the slider to change the opacity of the hover highlighting effect.
• Refer to the Detailed Description section for more information on the sample.

How to Run the Sample as an Application

This sample can be run as an application. The installation directory contains an executable JAR file, gantt-java2d.jar, that allows you to execute the sample with a double click from a file browser. Note that if you are using Internet Explorer, you can open the installation directory and execute the JAR file from the browser. This technique may not work in other Web browsers.

Alternatively, you can run the sample application from the command line. First check that the Ant utility is properly configured. If not, see the instructions on how to configure Ant for Perforce JViews.

Then, go to the installation directory of the sample and type:

ant run

Topics Covered

• Subclassing and customizing activity and constraint renderers
• Creating composite renderers that are constructed from simple renderers
• Using advanced graphic features of the Java2 API, such as gradient fills and line styles
• Installing custom renderers on a Gantt chart
• Anti-aliasing of graphics and text

Detailed Description

The user interface of the Java2D Gantt Sample is the same as that of the Gantt Sample on which it is based.
Note: This sample shows how to develop custom renderers using the SDK. Similar effects can be achieved using the CSS styling capabilities described in Developing with the SDK -> Styling -> Styling Gantt Chart and Schedule Chart Data -> Styling Activities, or by using the designer and styling your activities through the Gantt Designer.

Installation Directory

The Custom Rendering Effects sample is installed here.

Classes Involved

• ilog.views.gantt.IlvGanttChart
• ilog.views.gantt.graphic.IlvConstraintGraphic
• ilog.views.gantt.graphic.renderer.IlvActivityLabel
• ilog.views.gantt.graphic.renderer.IlvActivitySymbol
• ilog.views.graphic.IlvGeneralPath
• ilog.views.java2d.IlvLinearGradientPaint
• ilog.views.java2d.IlvRadialGradientPaint

Source Files

• java2d.Java2DGanttExample

  The main sample application is an extension of the GanttExample.

• java2d.Java2DConstraintGraphic

  An extension of IlvConstraintGraphic that renders a constraint using Java 2D stroke and style attributes.

• java2d.GradientActivityBar

  Renders an activity as a rectangular bar with a Java 2D gradient fill.

• java2d.LabeledGradientBar

  A composite renderer that combines a GradientActivityBar with anIlvActivityLabel.

• java2d.GradientSymbol

  An extension of IlvActivitySymbol that can render the start or end of an activity with a Java 2D gradient fill.

• java2d.GradientSummaryBar

  A composite renderer that combines a GradientActivityBar with two GradientSymbol pentagons that mark the beginning and end of the activity.