IGX

Interactive GraphiX


[contact addresses][Tips & Tricks][events][homepage]


Description

Interactive GraphiX (IGX) is a Windows graphics package specifically designed for the new GAUSS version 3.5; it is also backward compatible with GAUSS 3.2. IGX provides a high degree of control over a graphic environment while the graph is displayed, either interactively through menus using the mouse and keyboard, or through the use of GAUSS commands.

IGX allows you to:

IGX is designed to be run from GAUSS in a number of different modes:

  1. Command Script. A file containing a set of Gauss commands, in the same way as PQG.
  2. Chart Mode. A previously defined chart (a template) is used with a new set of data, or as a starting point within a GAUSS command file.
  3. Interactive Mouse Mode. A graph is started, and then customized by right clicking items on the graph to select their property, or by using the menu or toolbar.
  4. Interactive Command Mode. A graph is started, and then customized by executing IGX commands from GAUSS - as each command is typed, the graph is updated.

These methods can be mixed and matched, and thus provide a very high degree of flexibility.

Requirements

Windows 95, 98, NT 4 or 2000
GAUSS 3.2 or 3.5 for Windows


Chart Types

IGX supports the following chart types:

Most of these can be displayed in either a 2D or 3D format. Thus, for example, a line chart in 2D becomes a ribbon in 3D. Different chart types can be mixed in a single figure.


Chart Objects

An IGX graphic consists of a number of elements, each of which has properties that can be changed, either interactively and/or using GAUSS commands. The following elements are defined:

all series

Refers to all the vectors in the current graphic.

annotation bar

Refers to the annotation bar of the graphic window.

arc

Refers to a previously created arc object.

arrow

Refers to a previously created arrow object.

axis

x-axis y-axis y2-axis z-axis

Refers to the axes. y2-axis refers to the secondary y axis.

axis label

xlabel ylabel y2label

Refers to labels on the axes.

axis title

xtitle ytitle y2title

Refers to the axes legends of the graphic.

balloon

Refers to a previously created balloon object.

border

Refers to the borders (such as an area border) associated with a given series.

chart

chart chart2d chart3d

Refers to the entire graphic. chart2d and chart3d refers to 2D and 3D graphics respectively.

circle

Refers to a previously created circle object.

constant line

Refers to a constant line in the current graphic.

frame

Refers to the area outside of the axes.

grid

xgrid ygrid xminorgrid yminorgrid

Refers to the major and minor grids associated with each axis.

legend box

Refers to the legend box, which contains the x-axis labels when no x-axis exists (such as in a pie chart).

marker

Refers to the set of point markers associated with a given series.

menubar

Refers to the menubar of the graphic window.

picture

Refers to a previously created picture object. Pictures can be used as elements or backdrops.

point

Refers to an individual point, by observation and series.

point label

Refers to the set of point labels associated with a given series.

real time marker

Refers to the vertical position line in real time graphs.

rectangle

Refers to a previously created rectangle object.

series

Refers to an individual series or vector in the current graphic.

series legend box

Refers to the the series legend box, which contains the names of the current series.

stripe

Refers to a constant band (stripe) in the current graphic.

textbox

Refers to a previously created textbox object.

tick

xtick ytick xminortick yminortick

Refers to the major and minor tick marks associated with each axis. 

title

Refers to the main title of the graphic.

toolbar

Refers to the toolbar of the graphic window.

x-series

Refers to the vector specifying the values used on the x-axis. If no values are specified, a categorical axis is used.

y-ini series

Refers to an individual initial value series in the current graphic. This is used in Gantt plots.


Chart Properties

Each element (or object) of an IGX graphic has properties which can be changed, either interactively and/or using GAUSS commands. The following properties are defined:

Property Description
3D Object 3D properties
Attach Attachment mode - fixed or elastice
Back color Back color or fill color of object
Clear Destroy object
Color Color of object
Docked Placement of object - fixed, float or docked
Font Text object font - any current window font
Line style Object line style - solid, dots, etc
Line width Object line width
Pattern Object fill pattern
Position Object position in logical or absolute units
Show Show/hide object
Size Object size in logical or absolute units
Step Object frequency
Style Object styles
Stylex Extended object styles
Text Text string for object
Text align Text alignment
Text angle Text orientation
Value Data values

Chart Actions

An IGX graphic consists of a number of objects, each of which has properties which can be changed. In addition, there are a number of actions that can be undertaken on the graphic itself - such as importing a previously created chart or template, printing, selecting a color scheme, etc. The following actions are available, either interactively and/or programmatically

Description

Enable 2D / 3D
Close current graphic window
Close all graphic windows
Enable / disable cluster
Copy graphic to clipboard
Position graphic on output page
Export graphic 
Get / set current graphic ID
Help
Hide / show graphic
Open graphic or template
Print graphic
Enable / disable real time
Repaint graphic
Set depth, perspective and rotation
Save graphic or template
Enable / disable scrolling
Set options for printing
Set paint mode
Select color palette
Select pattern
Printer setup
Set real time options
Set scroll options
Set units
Graphic image processing
Enable / disable stacking
Updates graphic
Restore graphic window
Size and position window
Enable / disable zooming


Export Formats

IGX can save (export) the graphic file in a number of different formats:

Extension File Type
bmp Bitmap File
eps Encapsulated Postscript
emf Enhanced Metafile
gif Graphics Interchange Format
jpg JPEG File Interchange Format
pcx PC Paintbrush
png Portable Network Graphics
tga Targa
tif Tag Image Format
bif Windows Binary Image File

Depending on the format, the image can be saved at different resolutions, and either compressed or not compressed.

File resolution:

0 - Gray Scale (8 bit) 
1 - Black and White (1 bit)
8 - 256 color (8 bit)
24 - True color (24 bit)


Interactive Tools

An IGX graphic can be edited either interactively or programmatically. This item describes how to invoke the interactive means of editing a graphic.

There are six ways of interactively editing an IGX graphic:

  1. Select an item from the menubar
  2. Select an item from the toolbar
  3. Select an item from the annotation bar
  4. Right click a chart object on the graphic to display its properties -- a tooltip box will identify the object when the mouse is  positioned on the object.
  5. Right click the margin of an annotation object to display its properties -- the cursor changes to the move cursor when the mouse is positioned on the object.
  6. Right click the background of the IGX figure to display the popup menu, shown on the left below. Clicking the Properties item displays the tabbed dialog shown on the right.

Templates

A template is a chart with a restricted amount of information - in a sense it is a style sheet for a graphic. Typically, one might wish to save the format of a graphic, but not the data or axes size, so that the same format can be used in subsequent jobs. When a template is saves, all the relevant information (colors, chart types and styles) excluding the data is available for use in a future chart.


Printing

IGX permits two modes of printing. In the first, a single figure is positioned on the output page by setting the margins, either interactively using the mouse, or programmatically. IGX will automatically scale the graphic to fit the page.

A second printing method, using GAUSS commands, allows a number of figures to be placed on the output page. Each figure can be printed with or without the background, and as overlapping figures, or as inserts.


Image Processing

The current graphic is exported to IGXTools, where image processing can occur. Image contrast, grayscale, brightness and other characteristics can be altered at this stage. Such alterations are often required before posting an image on the net, or for tweaking an image prior to printing. The image can be saved in any of the supported formats.


GAUSS Commands

Each IGX command starts with gx_ followed by the name of the command. 

Command Description
gx Specify series and display graphic.
gx_3d Sets 3D properties.
gx_3dview Enables 2D / 3D view.
gx_anotebar Displays annotation bar.
gx_arc Creates an arc object.
gx_arrow Creates an arrow object.
gx_attach Sets attachment property for an object.
gx_axis Sets the range of an axis.
gx_axislabel Creates labels for an axis.
gx_axistitle Creates titles for an axis.
gx_backcolor Sets backcolor or fill color for an object.
gx_balloon Creates a balloon object.
gx_border Displays a series border.
gx_circle Creates a circle object.
gx_clear Deletes the specified object.
gx_close Closes the current graphic.
gx_closeall Closes all graphics.
gx_cluster Enables cluster mode.
gx_color Sets color property for an object.
gx_constant Creates constant lines.
gx_copy Copy graphic to the clipboard.
gx_docked Specifies window placement style.
gx_draw Draws item to output page, prior to print.
gx_export Exports current graphic to a file.
gx_font Sets the text font of an object.
gx_gallery Sets the chart type for a chart or series.
gx_getwindow Gets window ID of current graphic.
gx_grid Creates grids.
gx_help Displays the IGX help file.
gx_hide Minimizes the current graphic.
gx_legendbox Enables the legend box.
gx_linestyle Sets the line style of an object.
gx_linewidth Sets the linewidth of an object.
gx_marker Creates series markers.
gx_menubar Displays menu bar.
gx_open Imports an IGX file or template.
gx_pattern Sets the fill pattern for an object.
gx_picture Creates a picture object.
gx_position Sets the screen position for an object.
gx_print Prints the current graphic or output page.
gx_realtime Enables realtime mode
gx_rectangle Creates a rectangle object.
gx_repaint Repaints the current graphic.
gx_save Saves a  graphic or template to a file.
gx_scroll Enables scrollable property.
gx_series Specify y series and display graphic.
gx_serlegbox Displays the series legend box.
gx_serlegend Creates series legends.
gx_setpage Page setup for printing.
gx_setpaintmode Enables bit-blt paint mode.
gx_setpalette Specifies predefined color palette.
gx_setpattern Specifies color pattern scheme.
gx_setprinter Enable printer setup dialog.
gx_setrealtime Specifies settings for realtime mode.
gx_setscroll Specifies settings for scrollable mode.
gx_setunits Sets units of measurement.
gx_setwindow Sets the current IGX graphic window.
gx_show Sets the visibility property of an object.
gx_size Sets the screen size for an object.
gx_stack Enables stacking mode.
gx_step Sets step property for an object.
gx_stripe Create stripes.
gx_style Sets style properties for an object.
gx_stylex Sets the extended style  for an object.
gx_text Sets the text for an object.
gx_textalign Sets the text alignment for an object.
gx_textangle Sets the text orientation for an object.
gx_textbox Creates a textbox object.
gx_tick Creates ticks.
gx_title Creates the main title for a graphic.
gx_toolbar Displays the tool bar.
gx_tools Exports current graphic to IGXTools for image processing.
gx_update Updates the current graphic.
gx_value Replaces data values for the specified series.
gx_view Restores the current window to default size.
gx_window Specifies the size and position of a window.
gx_xseries Specify x series.
gx_yini Specify initial y series for gantt charts.
gx_zoom Zooms a graphic.

A number of  utility commands are included in the IGX library:

Command Description
palcolor Returns a color from a palette.
rgb Returns a color.
syscolor Returns a Windows system color.
timer A GAUSS timer control.

Documentation

Hardcopy 160 page manual with table of contents, examples, reference, and index.

igx.chm A compiled HTML help file, covering both interactive commands and GAUSS programming commands. Includes table of contents, index, and search.

igxtools.chm A compiled HTML help file for the image processing application.

igx.pdf This is a PDF version of the printed manual.


Trial Version

Thank you for your interest in Interactive GraphiX. This is a fully functional version of IGX, and includes on-line help, as well as the manual in pdf format. The trial version is for evaluation purposes only, and your license to use it will expire after 14 days. Either GAUSS 3.2 for Windows or GAUSS 3.5 for Windows is required.


Send EMailScientific Web HomepageInternetadressliste HomepageMy Homepage
Stefan Steinhaus, webmaster@steinhaus-net.de