Interactive.ViewElements.Drawables

Drawable elements

Information

Drawables package

Drawables package contains visual elements for building animated schematic representations of the system.

These elements include some basic geometric shapes such as sphere, arrow, cone, cylinder, half pipe, cube, regular polygon and plane. The geometric and visual properties of these objects (e.g., spatial position, rotation, size, texture and color) can be linked to the model variables, changing during the simulation according to the time-evolution of these variables.

Objects of Drawables classes must be placed inside containers that provide a coordinate system (i.e., containers of DrawingPanel and PlottingPanel classes).

Package Content

Name	Description
PlanarGrid	Draws a polygon
Sphere	Draws an oval
Text	Displays a string
Arrow	Draws an arrow
Cone
Cylinder
HalfPipe
ScalarBar
Cube
Trail
RegularPolygon
Disk
File3DSImporter
Plane
Polygon
TextReal	Displays a string + real number
TrailNPoints
Line

Interactive.ViewElements.Drawables.PlanarGrid

Draws a polygon

Information

Objects of the PlanarGrid class represent 3D regular structures, with variable spacing in the three coordinate directions x-y-z. The structure in defined by specifying the length and the number of cells in each direction. Additionally, each cell can contain data attributes (scalars, tensors and vectors) that can be used for visualization. For instance, scalar fields can be represented using colors, vectorial fields using vectors, etc.

Extends from Interactive.src.ViewElements.Drawables.PlanarGrid (Planar grid de size LengthX*LengthY*LengthZ with nCells. Var. linked to the model: color[nCells], Position[3], Origin[3], Degrees[3], LengthX, LengthY, LengthZ, scalars[nCells], posGrid[3]).

Parameters

Connectors

Interactive.ViewElements.Drawables.Sphere

Draws an oval

Information

Sphere class draws a sphere.The position of the sphere center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable) and its radius (Radius[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Sphere (Sphere. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3] and Radius).

Parameters

Connectors

Interactive.ViewElements.Drawables.Text

Displays a string

Information

Text class displays a string. The position of the string center (Position[:] variable), the point about which rotation take place (Origin[:] variable) and the rotation degrees in axes x, y and z (Degrees[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Text (Displays a string. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3].).

Parameters

Connectors

Interactive.ViewElements.Drawables.Arrow

Draws an arrow

Information

Arrow class displays a vector. The position of its center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable) and the arrow scale factor (scale[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Arrow (Arrow. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], scale).

Parameters

Connectors

Interactive.ViewElements.Drawables.Cone

Information

Cone class displays a cone. The position of its center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable), its radius (Radius[:] variable) and height (Height[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Cone (Cone. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], Radius, Height).

Parameters

Connectors

Interactive.ViewElements.Drawables.Cylinder

Information

Cyinder class displays a cylinder. The position of its center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable), its radius (Radius[:] variable) and height (Height[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Cylinder (Cylinder. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], Radius, Height).

Parameters

Connectors

Interactive.ViewElements.Drawables.HalfPipe

Information

HalfPipe class displays the transversal section of a pipe. The position of its center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable), its inner radius (RadiusMin[:] variable), its outer radius (RadiusMax[:] variable) and length (Length[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.HalfPipe (Longitudinal section of a pipe. The length is in the x direction. The radius is in the y direction. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], RadiusMin, RadiusMax, Length).

Parameters

Connectors

Interactive.ViewElements.Drawables.ScalarBar

Information

ScalarBar class generates a legend showing the correspondence between a colorbar and a range of numeric values. The corresponding numeric values are shown above the colorbar. The objects of this class can be easily configured: the virtual-lab developer only has to set the data value range, the color range and the type of mapping between the data and the colors (i.e., linear or logarithm ramp).

Extends from Interactive.src.ViewElements.Drawables.ScalarBar (Scalar bar. Var. linked to the model: none).

Parameters

Connectors

Interactive.ViewElements.Drawables.Cube

Information

Cube class draws a cube. The position of the cube center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable) and its length in axis x, y and z (Length[3] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Cube (Cube. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], Length[3]).

Parameters

Connectors

Interactive.ViewElements.Drawables.Trail

Information

Creates a drawing element that displays a sequence of points at given coordinates of the hosting container. The point position (point[2] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Trail (Trail. Var. linked to the model: point[2]).

Parameters

Connectors

Interactive.ViewElements.Drawables.RegularPolygon

Information

RegularPolygon class draws a polygon inscribed in a circle. The position of the center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable), the normal to the polygon surface (Normal[3] variable) and the radius of the circle inscribing the polygon (Radius variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.RegularPolygon (Regular polygon inscribed in a circle. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], Normal[3], Radius).

Parameters

Connectors

Interactive.ViewElements.Drawables.Disk

Information

Disk class draws a disk. The position of the cube center (Position[:] variable), the point about which rotation take place (Origin[:] variable), the rotation degrees in axes x, y and z (Degrees[:] variable), its inner radius (RadiusMin[:] variable), its outer radius (RadiusMax[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Disk (Disk. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3], InnerRadius, OuterRadius).

Parameters

Connectors

Interactive.ViewElements.Drawables.File3DSImporter

Information

File3DSImporter class allow inserting objects in 3D Studio format. The position of the object center (Position[:] variable), the point about which rotation take place (Origin[:] variable) and the rotation degrees in axes x, y and z (Degrees[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.File3DSImporter (Imports 3D Studio files. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3]).

Parameters

Connectors

Interactive.ViewElements.Drawables.Plane

Information

Plane class draws a plane. The plane is set by specifying 3 points: OriginPoint[3] (i.e., point defining the origin of the plane), Point1[3] (i.e., point defining the first axis of the plane) and Point2[3] (i.e., point defining the second axis of the plane). The position of its center (Position[:] variable), the point about which rotation take place (Origin[:] variable) and the rotation degrees in axes x, y and z (Degrees[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Plane (Plane. Var. linked to the model: color[11], Position[3], Origin[3], Degrees[3]).

Parameters

Connectors

Interactive.ViewElements.Drawables.Polygon

Information

Polygon class draws a polygon giving the vertexes coordinates. The position of the vertexes (PosVertexes[:] variable), the polygon's center (Position[:] variable),the point about which rotation take place (Origin[:] variable),the rotation degrees in axes x, y and z (Degrees[:] variable) and the vertexes coordinates (posVertexes[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.Polygon (Polygon. Var. linked to the model: colors[11], Position[3], Origin[3], Degrees[3]).

Parameters

Connectors

Interactive.ViewElements.Drawables.TextReal

Displays a string + real number

Information

Text class displays a string and a numeric value after the string.
The numeric value (var variable), the position of the string center (Position[:] variable), the point about which rotation take place (Origin[:] variable) and the rotation degrees in axes x, y and z (Degrees[:] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.TextReal (Displays a string + real number. Var. linked to the model: var, colors[11], Position[3], Origin[3], Degrees[3]).

Parameters

Connectors

Interactive.ViewElements.Drawables.TrailNPoints

Information

Creates N drawing elements. Each drawing element displays a sequence of points at given coordinates of the hosting container. The point position (point[2] variable) can be linked to the model variables.

Extends from Interactive.src.ViewElements.Drawables.TrailNPoints (Draws nPoints trails. Var. linked to the model: x[nPoins], y[nPoints]).

Parameters

Connectors

Interactive.ViewElements.Drawables.Line

Information

Extends from Interactive.src.ViewElements.Drawables.Line (Polygonal line or polygon with a number of points equals to nPoints. Var. linked to the model: PointPosition[nPoints], colors[11], Origin[3], Degrees[3], Center[3]).

Parameters

Connectors