Their are two different kind of circles one with a constant screen size (Circle) and one with a constant real world size (CircleDist)
Circle
The circle VO is used to display a circle with a pixel dimensioned radius. The Circle has the following CLSID:
CLSID {00100000-2013-0004-B001-7EB3CCC039C4}
Attribute | Binding | Type | H/N | Default | Description |
type | No | string | Yes/Yes | must be the above CLSID | |
id | No | string | Yes/Yes | specifies the id of the VO | |
datasource | No | string | path to a data node | ||
pos | Yes | vector | Yes/Yes | anchor points of the VO | |
colorBorder | Yes | color | Yes/Yes | color of the border | |
radius | Yes | float | Yes/Yes | radius in pixel | |
tooltip | Yes | string | No/Yes | tooltip text of the VO | |
color | Yes | color | No/Yes | fill color of the circle | |
dothotScale | Yes | vector | Yes/Yes | 1;1;1 | x,y,z only x factor is used to scale the radius |
hotDeltaColor | Yes | string | No/Yes | relative or absolute color value that is applied to all color values when the VO is hot | |
fxsize | Yes | boolean | Yes/Yes | when set, the VO should not scale | |
fxdir | Yes | boolean | No/Yes | the VO does not rotate when the map is rotated. | |
slices | Yes | long | No/Yes | number of slices that should be used to create the circle. | |
DragSource | No | object | No/Yes | drag filter information | |
DropSource | No | object | No/Yes | drop filter information |
Events | H/N | Description |
Click | Yes/Yes | fired when the VO is clicked or there is a corresponding touch event on the VO |
ContextMenu | Yes/Yes | fired when there is a right click or a corresponding touch event on the VO |
HandleContextMenu | Yes/No | fired when there is a click or touch on a design handle |
Remarks:
When the circle is used in the native implementation of Visual Business it is important to specify the number of slices. When HTML rendering is active, the value for the slices is not used.
Sample:
…
{
"id": "Circle",
"type": "{00100000-2013-0004-B001-7EB3CCC039C4}",
"datasource": "Circles",
"pos.bind": "Circles.pos",
"colorBorder.bind": "Circles.ColorBorder",
"radius.bind": "Circles.Radius",
"tooltip.bind": "Circles.Name",
"color.bind": "Circles.Color",
"slices.bind": "Circles.Slices",
"fxsize.bind": "Circles.FxSize"
}
…
CircleDist
In contrast to the circle VO, the distance circle has a radius that is specified in meters. When used in a geographical scene, the shape of a distance circle can vary dependent on the used projection of the scene.
CLSID {00100000-2013-0004-B001-686F01B57873}
Attribute | Binding | Type | H/N | Default | Description |
type | No | string | Yes/Yes | must be the above CLSID | |
id | No | string | Yes/Yes | specifies the id of the VO | |
datasource | No | string | path to a data node | ||
pos | Yes | vector | Yes/Yes | anchor points of the VO | |
colorBorder | Yes | color | Yes/Yes | color of the border | |
radius | Yes | float | Yes/Yes | radius in meter | |
tooltip | Yes | string | No/Yes | tooltip text of the VO | |
color | Yes | color | No/Yes | fill color of the circle | |
dothotScale | Yes | vector | Yes/Yes | 1;1;1 | x,y,z only x factor is used to scale the radius |
hotDeltaColor | Yes | string | No/Yes | relative or absolute color value that is applied to all color values when the VO is hot | |
fxsize | Yes | boolean | Yes/Yes | when set, the VO should not scale | |
fxdir | Yes | boolean | No/Yes | the VO does not rotate when the map is rotated. | |
slices | Yes | long | No/Yes | number of slices that should be used to create the circle. | |
DragSource | No | object | No/Yes | drag filter information | |
DropSource | No | object | No/Yes | drop filter information |
Events | H/N | Description |
Click | Yes/Yes | fired when the VO is clicked or there is a corresponding touch event on the VO |
ContextMenu | Yes/Yes | fired when there is a right click or a corresponding touch event on the VO |
HandleContextMenu | Yes/No | fired when there is a click or touch on a design handle |
Remarks:
The CircleDist VO can be used only in geographical scenes. It is important that the slices property is specified. For performance reasons, the number of slices should be as small as possible.