Properties

DebugLogMode (from version 4.1)

Indicates the level of detail of debug information that is logged during runtime of the website to the trace, a logfile, a database etc. The possible values are:

Enabled

Possible values are 'True' or 'False'. If the value is 'False', then the object can not be used within the application.

IsPublic

Possible values are 'True' or 'False'. If the value is 'False', then the object can only be used within the document where it is created. If the value is 'True', then also from other Futurama documents can be referred to this object. This means that changes in the object also affect the document in which is referred to this object. If the value is 'True' and you attempt to move or delete the object, a warning will be given. To limit these warnings to a minimum it is recommended to set IsPublic to 'True' only when necessary.

ToolTip

In the property Tooltip a text can be entered that is shown in the application when a cursor is moved across the GraphConverter. In this way information about the usage of the GraphConverter can be given to the user. From Futurama version 18.02 it is also possible to define the texts within a ResourceDocument. See the page Text management and Multi-language.

Visible

Possible values are 'True' or 'False'. If the value is 'True', the object will be rendered and therefore displayed in your application. If the value is 'False', the object will not be rendered.

(Name)

The name of the object.

Comment

Here a comment can be entered. For example a short description of the object.

ID

The unique identification number of the object. This number is automatically generated by Futurama on the moment of creation. This number can be used when searching for a certain object in the Find Window.

Series

In this property you can add multiple data series that should be displayed in the graph. After clicking the edit-box, a popup will appear in which series can be added, deleted and organised. For each series an array of input data is required, which represent the Y-values of that specific series. Each array should hold as much elements as the table that is entered in the XValues properties.

Each series has a number of properties of its own, to configure the representation of it. These properties are explained at the bottom of this page.

Annotations  (Futurama 17.09+)

Here you can add and configure an Annotation to a DataPoint. Each annotation contains the following of subproperties:

• AbsolutePositioning: this property determines if this Annotation is linked to a specific datapoint, or if you want to position it based on the X and Y value. When this property is set to True, AnchorAlignment, OffSetX and OffSetY are not available.
• AnchorAlignment: this property determines how the Annotation is anchored to the datapoint.
• AnnotationType: the type of Annotation that you want to use. Some properties are only available for specific AnnotationTypes
• BackColor: the color of the background of the annotation
• BorderColor: the color of the border and the lines of the annotation
• CallOutStyle: the type of CallOut you want to use. Only available for the AnnotationType CallOut
• EnableSmartLabels: this property is currently not in use
• ForeColor: the color of the texts of the annotation
• HideOverlapped: this property is currently not in use
• ImageFileName: the relative path (relative to the Futurama document that is opened) of the image file that is used in AnnotationStyle Image
• OffSetX: the percentage of the graph width to offset the position in horizontal direction. Negative offset means annotation goes up.
• OffSetY: the percentage of the graph height to offset the position in vertical direction. Negative offset means annotation goes to the left.
• Height: the height of a line. Only applicable for AnnotationStyle: Line, VerticalLine or HorizontalLine
• LineDashStyle: the line dash style of the line. Only applicable for AnnotationStyle: Line, VerticalLine or HorizontalLine
• LineEnd. The type of picture to use for the end of the line. Only applicable for AnnotationStyle: Line, VerticalLine or HorizontalLine
• LineStart: The type of start picture to use for the start of the line. Only applicable for AnnotationStyle: Line, VerticalLine or HorizontalLine
• LineStart: The width of the line. Only applicable for AnnotationStyle: Line, VerticalLine or HorizontalLine

AntiAliasing

AntiAliasing is the process of making the edges in your graph smoother. This applies to the series in the graph as well as the characters displayed in e.g. the axes or legenda. Possible values are 'Text', 'Graphics', 'All' and 'None'. Pay attention, if the value ‘Text’ or ‘All’ is selected, the background color can’t be transparent. You can only use these values with a solid background color.

BackColor

Here you can enter the background color of the graph. With this color you can also use a level of transparency. To use the transparency, you have to add the level of transparency in front of the color. This way an Argb color code is used, where the A stands for the level of transparency. The value of A is an integer between 0 and 255, where 255 is the default with no transparency and 0 means the color is fully transparent. If only the rgb color code is supplied, the default A value of 255 will be used.

BackGradientEndColor

This property only applies when the BackGradientType property (below) is not set to 'None'. In the BackGradientEndColor property you can then specify a second color to create a gradient background.

BackGradientType

In the BackGradientType property you can configure your graph to have a gradient background. If the value 'None' is selected, the background color is equal to the color set in the BackColor property. If one of the other values is chosen, the background will have a gradient that transits from the BackColor to the BackGradientEndColor, in the direction specified by the chosen BackGradientType.

BackHatchStyle

This property enables you to add effects to the background of the graph, such as a grid.

BackImage

Here you can enter a background image for the graph.

CssClass

Here the CssClass can be entered. In the stylesheet you can define the style elements that belong to this class.

EnableMap

Possible values are 'True' or 'False'. If the property is set to 'True', then within the series the property MapAreaAttributes can be used.

Font

Here you can configure the font that is used in the graph.

ForeColor

Here you can configure the color of the font that is used in the graph.

Height

The height of the graph. Because Futurama renders an image it is not possible to set the height in a stylesheet.

JPEGCompression

Possible values are integers between 0 and 100. A value of 0 means no compression is applied. A value of 100 means maximum compression is applied. Using more compression means that the size of the image (in kB) will decrease but also that the quality of the image will diminish. So there is a trade-of between the size and the quality.

Label

The labels that are displayed at the X- and Y-axis of the graph are by default determined by resp. the XValues property for the X-axis, and the height of the series for the Y-axis. Within the properties XAxis and YAxis you can configure yourself how these labels should be displayed.
In the Label property, however, you can further configure the labels at the X-axis, which enables you to e.g. display symbols at the axes. Therefore the following subproperties should be filled:

• Labels: Here you should enter a table with the string-elements that should be displayed in your graph. You can also insert symbols e.g. to represent a time event at the X-axis. The table should have the same length as the table in de propertie Values, below.
• UseCustomLabels: Possible values are 'True' or 'False'. If the value is 'True', then the labels above will be displayed in the graph. Note that currently UseCustomLabels only work when the Type of Values (below) is Date.
• Values: Here you enter the table with the values of the X-axis that locate the places where the corresponding labels out of the Labels property should be displayed. This table can be the same as the one entered in the XValues property, but that is not needed. There are a couple of requirements:
  • The table does have to be of the same Type as the XValues table.
  • The minimum and maximum values have to be within the range of the XValues table.
  • The table has to have the same length as the Label property table.

Legend

In the property Legend you can configure whether and how a legend of the graph should be displayed. The property is divided into the following subproperties:

• Alignment: Indicates where the legend should be displayed with reference to the graph. Possible values are 'Near', 'Center' or 'Far'. The outcome depends on the Docking property.
• BackColor: The background color of the legend.
• Docking: Here you enter whether the legend should be placed at the top, right, bottom or left of the graph.
• FontColor: The color of the font of the legend. The Font itself is set in the properties of the Graphconverter itself.
• InsideChart: Possible values are 'True' or 'False'. This property indicates whether the legend should be placed inside ('True') or outside ('False') the graph.
• Reversed: Possible values are 'True' or 'False'. This property indicates whether the legend should be in the same order as the series are entered, or in reverse order.
• Style: Here you can enter if the legend should be displayed as a row, table or column.
• TextWrapTreshold: Here you enter the number of characters after which the next word of the series name should be displayed at a new line.
• Visible: Indicates whether the legend should be displayed or not.

Resolution

Here you can enter the resolution in which the graph will be displayed. The default is 96 dpi, which is sufficient for on a screen. The GraphConverter can be used to display a graph on screen, but it can also generate a graph for a document. For the latter use, the resolution should be increased to create a sharp image. This can be achieved by using an Actionobject to change the Resolution property on the moment of creating the document. Note that a second Action is necessary then to revert the Resolution property of the graph to it's original value. Otherwise the altered Resolution will also be used when displaying the Graph on screen from then on which may lead to improper results.

Width

The width of the graph. Because Futurama renders an image it is not possible to set the width in a stylesheet.

XAxis and YAxis

Here you can configure the X-axis and the Y-axis. Both properties contain the same list of subproperties:

• Caption: Here you can enter the title of the axis. From Futurama version 18.02 it is also possible to define the texts within a ResourceDocument. See the page Text management and Multi-language.
• Font: Here you can enter the font for the title and values of the axis.
• Format: Here you can enter the format of the values of the axis.
• GridLineColor: Here you can enter the color of the gridline displayed in the graph.
• IntervalInfo: This property is divided into subproperties itself. You can use these subproperties to configure the places where the values of the axis should be displayed:
  • Interval: The interval of the axis in terms of the type set in IntervalType. 0 means auto.
  • IntervalType: The type of interval e.g. number, years, days, hours etc. It indicates how the value at the Interval property should be processed.
  • IntervalOffset: The offset at which the interval of the axis starts in terms of the type set in IntervalOffsetType. 0 means auto. It indicates the distance between the start of the graph and the first label.
  • IntervalOffsetType: The type of IntervalOffSet e.g. number, years, days, hours etc. It indicates how the input at the IntervalOffset property should be processed.
  • ShowTickMark: Indicates whether tickmarks at the axis should be displayed or not.
• LineColor: The color of the axis of the graph.
• Maximum: Here you can enter a maximum for the scale of the Y-axis. If this property is set, the marking of the Y-axis will be consistent. This option can be used when you want to compare different scenarios.
• Scale: Possible values are 'Normative' and 'Linear'. Default is 'Automatic'.
• ShowMargin: Possible values are 'True' or 'False'. If the value is 'True', then the graph will have a small indent.

XValues

Here you have to enter a vector-type object ( e.g. a one-column table, range or formula) that represents the division of the X-axis. The x value has to have the same length as the data property the series of the graph. The values in the XValues determine where the corresponding values of the series are divided horizontally, but are not necessarily the ones which are actually being displayed. In the property Label the values can be stated that are to be displayed. XValues does not apply to pie charts.