The Annotation and Graphing Toolkit

1 Annotation and Graphing Overview

---

This chapter presents an overview of the features and functionality of the Annotation and Graphing (AG) Kit.

This chapter discusses:

• Introduction
• Summary of Objects in the AG Kit

1.1 Introduction

The AVS/Express Annotation and Graphing (AG) Kit provides annotation and graphing capabilities in AVS/Express, including annotating 2D and 3D images produced by the Graphics Display Kit viewers.

The AG Kit includes objects that logically embed concepts such as viewport, worlds, graphs, contours, and text. This allows the AVS/Express user to create applications with complex 2D graphs, advanced contours, isoline plots, and presentation quality annotation.

You can create high resolution hardcopy of your graphs in PostScript or CGM using the PrintViewer. See the AVS/Express Visualization Techniques documentation for information on how to use the PrintViewer.

Key Features

The following list includes features provided by the AG Kit:

• Presentation quality annotation with any Image, 2D graphics, or 3D graphics
• Choice of several high quality fonts and symbols, including oil well symbols
• Support for X window scalable and variable spaced fonts
• Fixed height text, scalable text, and restricted text support
• Basic graphics such as lines, rectangles, and polygons for annotation
• Arrows to point to particular graph components
• Extensive color capabilities, including color specification by name or as RGB values
• Support for special colors like transparent, background, and antibackground
• Multiple viewports
• Multiple world coordinate systems within the same viewport
• Multiple axes
• Numeric axes, user-labeled axes, logarithmic axes, and power axes
• Advanced tickmarks and ticklines support
• Axes on an image or any other underlying 2D rectangular graphics
• Various type of graphs:
  • Curve graph
  • Scatter graph
  • Bar and barline graph
  • Stacked or clustered bars
  • Area graph
  • High-Low graph
  • Staircase curve
  • Pie chart
  • Polar graph
• A mixture of graph types into one graph
• Multiple overlaid graphs, each having equal or different world coordinate systems
• User selectable drawing order
• Multiple legends
• Comprehensive set of user controllable attributes for fine tuning and for overriding default values
• Object selection and transformation as with other objects in the viewers
• Interactive pick methods for all objects
• Highlighting selected objects in the viewers
• Connection to any hierarchy of data and group objects for transforming object groups
• 2D isolines with or without labels
• 2D filled contours with or without isolines and isoline labels
• 2D data mapped isolines with or without labels
• Support for uniform, rectilinear, and irregular data

1.2 Summary of Objects in the AG Kit

The AG Kit groups objects into four separate categories-Basic, Axes, Graphing, and Contouring.

Basic Objects

Table A-1

Object Name	Description
AGArc / AGArcObject	An elliptical arc.
AGArrow / AGArrowObj	An arrow.
AGCombineWorldInput	Combines two arrays or scalars of world input into one.
AGDataObject	A special version of the DataObject from the Graphics Display Kit.
AGEllipse / AGEllipseObj	Filled or unfilled ellipse outline with border.
AGLine / AGLineObj	Polyline (two or more points) with any line style, width, and color.
AGPieChart / AGPieChartObj	A pie chart.
AGPoints/ AGPointsObj	Points with common diameter and color.
AGPolarWorld	Polar world coordinate system within a Viewport.
AGPolygon / AGPolygonObj	Filled or unfilled polygon with border.
AGRectangle / AGRectangleObj	Filled or unfilled rectangle.
AGRestrictedText / AGRestrictedTextObj	Text bound to fit inside a box that is scaled and rotated if the transformation changes.
AGText / AGTextObj	Single or multiline text with or without a border. Transformations apply to position.
AGTransformableText / AGTransformableTextObj	Single or multiline text that can scale and rotate if the transformation changes.
AGViewport / AGViewportObj	Rectangular viewing area, with border and fill color.
AGWorld	World coordinate system within a Viewport.

Axes Objects

Table A-2

Object Name	Description
AG2DAxisField	A 2D axis system that matches an AVS/Express 2D field.
AGPolarRAxis	Radius axis that can attach to any polar World object.
AGPolarTAxis	Theta axis that can attach to any polar World object.
AGPolarRTicklines	Radius ticklines in a polar graph.
AGPolarTTicklines	Theta ticklines in a polar graph.
AGXAxis	X axis that can attach to any World object.
AGYAxis	Y axis that can attach to any World object.
AGXUserAxis	User-labeled X axis.
AGYUserAxis	User-labeled Y axis.
AGXTickLines	Vertical ticklines.
AGYTickLines	Horizontal ticklines.

Graphing Objects

Table A-3

Object Name	Description
AGCombineGraphWorldInput	Combines two arrays or scalars of GraphWorld input into one array.
AGGraph	Graph of type curve, scatter, bars, barlines, area, staircase, or stairarea.
AGGraphFieldObj	Makes multiple graphs from node data of an input field, including axes and legend.
AGGraphLegend / AGGraphLegendObj	Legend for a collection of graphs.
AGGraphViewport / AGGraphViewportObj	Derived Viewport with graphing attributes.
AGGraphWorld	Derived AGWorld with graphing attributes.
AGPolarGraph	A polar graph.
AGPolarGraphWorld	Derived AGPolarWorld with graphing attributes.

Contouring Objects

Object Name	Description
AGCombineContourWorldInput	Combines two arrays or scalars of ContourWorld input into one array.
AGContour / AGContourObj	A contour and/or isoline plot.
AGContourFieldObj	Makes contours from a scalar 2D structured field.
AGContourLegend / AGContourLegendObj	A legend for a contour plot.
AGContourViewport / AGContourViewportObj	A derived Viewport with contouring attributes.
AGContourWorld	A derived World with contouring attributes.