CapeSoft.Com
Clarion Accessories
Insight Graphing
Documentation
Template Guide
CapeSoft Logo

CapeSoft Insight Graphing 1
Template Guide Documentation

JumpStart FAQ History
Installed Version Latest Version

Introduction

Welcome to your complete guide to the Insight Graphing Template.

This help page contains detailed help for every significant window and tab in the Insight Graphing Template. To find the window or tab you need help on it is easiest to use the above Table of Contents. The indentation used in the table of contents indicates the path taken to get to a tab on a given window. There will be a section heading matching the name of the tab you are on.

Note that there are two main parts - the Global Template and the Control Template. The Global Template is used to set the global defaults which will be used by all graphs in your application. The Control Template is then used to set the properties for an individual graph. It can also be used to override the global defaults for that graph.

Tip: It is advisable to read the Background section in the Insight User Guide before continuing. If you have doubts as to what a data point, set or point name is, this is where these terms are explained.

Another Tip: Every section comes with a screenshot of the tab you are on. You can click on any of the Insight Graphing tabs on that screenshot to take you to the section on that tab. If there is a button taking you to a new window of the template on that screenshot, you will be able to click on that as well.

Global Template Settings

General Tab

Global basic tab screenshot

The main purpose of this tab is for you to choose the Template Level of your graphs.

Basic Tab

Global basic tab screenshot

This tab allows you to set some basic global defaults relating to line widths, 3D depths and shading.

Legend Tab (Intermediate and Advanced Template Levels)

global set window style tab screenshot

Use this tab to set the global defaults for the legend of your graphs. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Grid Tab (Intermediate and Advanced Template Levels)

global grid screenshot

This tab allows you to set all the Grid related properties. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Fonts Tab (Intermediate and Advanced Template Levels)



This Tab lets you set all the Font related properties. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced. There are 6 different fonts that you can set. These are:

Colors Tab (Intermediate and Advanced Template Levels)

gloabal colours tab screenshot

The colors set on this tab are the colors used by the data on the graph. For example, you would set the colors of the bars in a bar graph, or the colors of the lines in a line graph, here. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Advanced Tab (Advanced Template Level)

global advanced tab screenshot

The Global Advanced Tab contains some advanced options to set globally for your graphs. Note that this tab is only available when the Template Level on the global General Tab is set to Advanced.

Options for the Insight Graph Control Template

Graph Tab

graph tab screenshot

Properties Tab

properties tab screenshot

This is where you can set the general properties of your graph object. INSIGHT:FineDiagonal
INSIGHT:CoarseDiagonal
INSIGHT:CoarseVertical
INSIGHT:FineChecked
INSIGHT:CoarseChecked
INSIGHT:CoarseZigZag
INSIGHT:Cross
INSIGHT:Tiles
INSIGHT:CoarseHorizontal
INSIGHT:Kite
INSIGHT:CrossHatch
INSIGHT:Squares
INSIGHT:Ducks
INSIGHT:Smilies
INSIGHT:Stars
INSIGHT:Grey
INSIGHT:Waves
INSIGHT:Zigzag
INSIGHT:VeryThickZigZag
INSIGHT:Chainmail
INSIGHT:SmallVerticalZigZag
INSIGHT:Pebbles
INSIGHT:CoarsePebbles
INSIGHT:LargePebbles
INSIGHT:Mosiac
INSIGHT:LargeDots
INSIGHT:SmallDots
INSIGHT:InversedSmilies
INSIGHT:Circuits


INSIGHT:Empty

Data Tab

data tab screenshot



The Data Tab is where you enter all the files, queues, views and variables you will be plotting data on the graph from. Information regarding sorting, data labels and the style you want your data plotted in is also entered here.

Primary Source Tab

On this tab, you first make a selection from the Data From dropdown (see the point below), and then the remaining options change according to your selection.
primary source tab screenshot

When choosing File, your options are as follows:
queue primary sourc tab screenshot

When choosing Queue, your options are as follows: When choosing Variable, there are no options. Move on to the Sets Tab to specify the variable name. Note that when you choose this option, an extra X-Axis Tab will appear once you get to the Set Window.

view primary source tab screenshot

When choosing Hand-Coded View, your options are as follows:

Related File Tab

related file tab screenshot

This tab is only visible if the Primary Source is a File. It allows you to enter a file related to your primary file from which data will be graphed. The fields of this file can, just as with the primary file, be used on the Set Tab.

Sets Tab

data sets tab screenshot

This is the tab where you specify the actual fields being plotted on the graph. You're allowed to have multiple fields (or expressions) per File (or Queue). Click on the Properties button in the above screenshot to see the tab where this information is entered, or go to the section on the Set Tab below.

Set Window - X-Axis Tab

set window x-axis tab screenshot

This tab only appears in two cases. The first is if you are using a variable - in this case you would have chosen Variable from the Data From dropdown on the Primary Source Tab. The idea is, that since a variable is single-valued, we wont know for which x-axis point the value in that variable should be plotted. Hence, we enter these details here.

The second case where this tab will appear is if you have ticked Sets have own Point Name and Number Fields on the Main X-Axis Tab.

Set Window - Set Tab

set window set tab screenshot

This is where you enter all the details related to the set you want plotted. For example, you specify which field to plot, the graph type of this particular set and how the data should be plotted.

Set Window - Y-Axis Tab (For Intermediate and Advanced Level Graphs where"Use a Separate Y-Axis for each Set " is on)

set window y-axis tab screenshot

To use this window, the Template Level on the global General Tab should be set to Intermediate or Advanced, and "Use a Separate Y-Axis for each Set" on the main Y-Axis Tab should be ticked. Use this tab to specify the details for the y-axis to be used for this set.

Set Window - Colors Tab ( Intermediate and and Advanced Level Graphs)

set window colours tab screenshot

The Colors Tab is used to specify the colors used to draw the data points in this set, including the conditional coloring of data points. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Set Window - Style Tab ( Intermediate and and Advanced Level Graphs)

set window style tab screenshot

This Tab allows you to set the style used to draw your lines, scatter shapes, bars, etc. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Set Window - Advanced Tab (Advanced Level Graphs)

set window advanced tab screenshot

This tab contains a number of advanced options. Note that this tab is only available when the Template Level on the global General Tab is set to Advanced.

Hot Fields Tab (Intermediate and Advanced Level Graphs)

hot fields tab screenshot

This allows you to add additional fields to the view.Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

X-Axis Tab

x-axis tab screenshot

This tab lets you set all the options relating to the x-axis, including the axis name and labelling information.

Y-Axis Tab

y-axis tab screenshot
This tab lets you set all the options relating to the y-axis, including the axis name and labeling information.

Grid Tab (Intermediate and Advanced Level Graphs)

grid tab screenshot

Use this tab to set the grid properties for your graph. Refer also to the Grid Tab on the Global Extension, where you can set the global defaults for the grid. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Mouse Move Tab (Intermediate and Advanced Level Graphs)

mouse move tab screenshot

This tab is used to specify what should happen when the mouse is moved over the graph area. Typically, you would want the point names and values to be displayed on a tool tip or somewhere on the window. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced. Tip: Insight will not display these values for sets which do not have set names.

Mouse Click Tab (Intermediate and Advanced Level Graphs)

mouse click tab screenshot

The Mouse Click Tab lets you specify what should happen when the mouse is clicked in the graph region. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.
Tip: See the section on Setting Up a Drill Down/Back Up Sequence.
Tip: See the section on Setting Up a Drill Down/Back Up Sequence.

Legend Tab (Intermediate and Advanced Level Graphs)

legend tab screenshot

This tab is used to override the global settings for the legend specified on the Global Legend Tab. Note that this tab is only available when the Template Level on the global General Tab is set to Intermediate or Advanced.

Fonts Tab

fonts tab screenshot

Use this tab to specify the font details of all text appearing on your graph.

Advanced Tab (Advanced Level Graphs)

advanced tab screenshot

The Advanced Tab contain a medley of specialized options aimed at optimizing performance and allowing the advanced programmer greater flexibility. Note that this tab is only available when the Template Level on the global General Tab is set to Advanced.
  • Based on Class: This defaults to GlobalInsight, meaning that the base class specified in the Based On Class entry on the Global Advanced Tab will be used here. Changing this is truly for advanced users who have created their own class based on the Insight class, and want to use their class for this specific graph instance.
  • Object Name: Allows you to enter a developer-friendly name for the graph object.
  • Generate SetReportProperties(): Tick this on if you need to embed code in the SetReportProperties() method. For more discussions on why you'd want this method see the section Advanced: Manually Printing Screen Graphs.
  • Generate Draw(): Tick this on if you need to embed code in the Draw() method. An example of when you would need this is given in the Shipped School Example - go to the Advanced menu, and choose PreDrawn. It can, for example, be used to draw text or other objects in the graph area.
  • Generate SetLabelFonts(): Tick this if you want to edit the font properties of only one or two x-axis or y-axis labels to make them stand out. See the section on the LabelQ for more information on how to tackle this. Also see the SetLabelFonts() definition.
  • Reset Graph on Window Reset: If this is checked (which it is by default), the graph will be reset every time the window's Reset() method is called. Uncheck this if your graph is taking a very long time to load when the window opens. Note that switching this option off affects how often your graph is refreshed and it hence may have an impact on how promptly changes to your graphed data is reflected. You can force your graph to reset by calling the .Reset() method.
  • Enable window buffering mode: If this is checked (which it is by default), the line of code window{prop:buffer} = 1 will be called right after the graph's .Init() method. Uncheck this if you have problems, for example, with your flat buttons not being displayed as flat.