svgaddgroup
svgaddgroup |
Purpose
Synopsis
procedure svgaddgroup(gid: string, desc: text, color: text)
procedure svgaddgroup(gid: string, desc: text)
Arguments
|
gid
|
Object group ID (must be unique within a graph).
|
|
desc
|
A text that will appear in the legend.
|
|
color
|
A color specification obtained using
svgcolor or one of the predefined constants (see list in section
SVG styling).
|
Example
The following adds two groups 'g1' and 'g2' to the user graph:
svgaddgroup("g1", "sine", SVG_RED) ! User-specified group color
svgaddgroup("g2", "random numbers") ! Automatically selected color
Further information
1. A group is identified by its ID whereas the 'desc' serves as text for the legend of the graphic. A group contains any number of individual objects (points, lines, arrows, texts
etc.) which were added to it.
2. An empty string for the 'desc' attribute indicates that the group is not to be included in the legend.
3. If no color is specified at the creation of a group it will be assigned a default color from a built-in list. This setting can be overwritten for individual objects within the group. Note that any style settings that are common to a large number of objects within a group should preferrably be specified for the group rather than for the individual objects.
Related topics