Time Chart

This chart supports the display of tasks that have a defined starting and ending value.
The X values may be specified using date expressions, time unit expressions, or numeric values. See Date/Time Values for details concerning the use of date time values.

This chart displays one or more datasets, each consisting of one or more tasks. A given data set is displayed as a horizontal line of boxes, where each box spans a range of X values from the starting value to the ending value. Each dataset can be assigned a color, that will be used as the color for each task in that data set or each task can be assigned an arbitrary color representing, for example, the status of that specific task. Furthermore, each task can be assigned an optional label to distinguish one task from another.

When the axis scrolling and zooming capability is utilized, the Time Chart can be used to show a wide range of projects over a wide range of time.

 

DataSets

	DataSets = ("Name1", Color1, Border1, Width1, Image1),...;

Defines a list of datasets with the given name and color.

If a color is not specified in the vector, then the previously specified color will be used. If the color is specified as "null", then a default color will be chosen from the color table. (See the ColorTable parameter.)

The Color, Border, Width and Image attributes define the default display attributes for each task box in the data set. See Region Parameters for more details.

Name1 Name of this horizontal task set. This name is used as the set label
Color1 Default color for this set.
Border1 Border for this set.
Width1 Vertical width for this set.
Image1 Background image for this set.
ImageFormat Specifies how the image will be displayed in the region, with the following types supported: 
TILE   - (default) tiles or clips the image if not
         the same size as the region.
SIZE   - scales the image to the size of the region.
CENTER - image is centered in the region

In all cases, the image is displayed AFTER the region has been filled with the specified color, allowing the region color to show through any transparent parts of the image.

BorderColor Border color for this set.

 

DataAxis

	DataAxis = (XAxis1, YAxis1), (XAxis2, YAxis2), ...;

The XAxis and YAxis attributes define the specific axis to be used when mapping the X and Y values respectively for each data set defined. The XAxis attribute may be set to BOTTOM or TOP, while the YAxis may be set to LEFT or RIGHT.

 

DataSet[1-50]

   DataSet[1-50] = (start1, end1, color1, "label1", labelColor1,
                   fontname1, fontsize1, fontangle1),...;

Defines a list of tasks for the given data set. Each task is drawn as a box extending from the given start date/time to the end date/time.

If the color value is defined for a given task, it will override the default color assigned to the given dataset in the DataSets parameter.

 
start1 Task start time.
end1 Task end time.
color1 Task color.
"label1" Text to overlay on task.
labelColor1 Text color.
fontname1 Text font.
fontsize1 Text font size.
fontangle1 Text font angle.

 

TaskColorTable[1-50]

	TaskColorTableN = color1, color2, ...;

Defines a set of colors for dataset N that overrides all other color specifications for that set. The parameters used for specifying the color of tasks in a chart are (in ascending order of precedence) ColorTable, DataSets and and TaskColorTable. TaskColorTableN is used most frequently to color some specific task. For example: 

		  	TaskColorTable2 = ,,blue;
will change the third task in the second series to blue, while all other tasks in the chart continue to be colored by one of the other color related parameters.

 

TaskHeight

	TaskHeight = value;

This parameter gives users the ability to set the height of a task bar in a timechart.

example: TaskHeight = 10; where value is an integer specifying the height of a task bar in pixels.

 

UniqueTaskColors

	UniqueTaskColors = ON|OFF;

If set to ON, then a unique color will be chosen from the color table for each task in a taskbar. (See the ColorTable parameter.) The default is OFF which uses the previously specified taskbar color.

See Date/Time Values for details concerning the use of date/time values.

See Axis Parameters for details concerning the scrolling and zooming of axis values over a given range.