Bulk Conveyor Belt is the animation shape for a bulk conveyor defined logically with Fluid Library block BulkConveyor. BulkConveyor block defines the logical parameters of the bulk conveyor (its length, speed, maximum input rate at the specified speed, color of batches flowing through the conveyor, etc.).
Bulk conveyor belt in the graphical editor
Bulk conveyor belt is displayed both in 2D and 3D animation (to see the bulk conveyor belt in 3D, add 3D window in your model).
Bulk conveyor belt at model runtime, in 3D animation
The bulk conveyor belt has start point and end point, and therefore has direction. The bulk matter will always flow from the conveyor's start point to its end point.
Demo model: BulkConveyor
To draw a bulk conveyor belt
Name - The name of the bulk conveyor belt. The name is used to refer to the bulk conveyor belt from the BulkConveyor block properties.
Ignore - If selected, the bulk conveyor belt is excluded from the model.
Visible on
upper level - If selected, the bulk conveyor belt is also
visible on the
upper level
where
this agent lives.
Lock -
If selected,
the conveyor shape is locked.
Locked shapes do not react to mouse clicks - it is impossible to select
them in the graphical editor until you unlock them.
Visible - Here you specify whether the shape is visible on animation at model runtime, or not. Using the control, choose yes or no.
Color - Here you can set the conveyor color.
Width - Here you can set the conveyor width, in pixels.
Draw stands - If selected, the stands of bulk conveyor belt will be drawn in 3D mode. Stands are drawn to the bulk conveyor belt from the ground level or from Z level.
... from Z level - [Visible and applies only if the Draw stands property is selected] Defines the Z level from which the stands will be drawn, where 0 is the ground level.
X - X-coordinate of the bulk conveyor belt's start point.
Y - Y-coordinate of the bulk conveyor belt's start point.
Z - [Enabled if the shape is visible in 3D (advanced property Show in is set to 2D and 3D or 3D only)] Z-coordinate of the bulk conveyor belt's start point.
The table located in the Points properties section enables users to view and adjust coordinates of the bulk conveyor belt turning points. It is the place where you can adjust the Z coordinates for some bulk conveyor belt points.
Here you define
relative coordinates, not the absolute
ones. The first point always has coordinates (0, 0,
0)
that can not be
changed.
Other rows of the table
define relative coordinates of the successive points.
Coordinates of
each point are
actually offsets of the corresponding point from the start
point along X, Y
(and optionally Z) axes correspondingly.
Show in - Here you can choose whether you want the bulk conveyor belt to be shown both in 2D and 3D animation, or in 2D only, or in 3D only.
Show name - If selected, the bulk conveyor belt's name is displayed on the graphical diagram.
The bulk conveyor belt has direction. The bulk matter will always flow from the conveyor's start point to its end point. So it is important when you draw a bulk conveyor belt, where you put the conveyor's start point. However, you can always change the conveyor direction (see below).
To know the direction of the bulk conveyor belt
To change the direction of the bulk conveyor belt
To continue drawing an existing bulk conveyor belt by adding more segments
To add a turning point
To remove a turning point
To
change a
curved segment into linear
To change a linear segment into curved
You may want to split a bulk conveyor belt into several bulk conveyor belts.
To split one bulk conveyor belt into two conveyors
Function |
Description |
double getLineWidth() |
Returns the width of the bulk conveyor belt (in pixels). |
double length() |
Returns the length of the bulk conveyor belt (in pixels). |
double length(LengthUnits units) |
Returns the length of the bulk conveyor belt in the specified length measurement units. Parameter: |
void setLineWidth(double width) |
Sets the width of the bulk conveyor belt. Parameter: width - the new width of the bulk conveyor (in pixels). |
Function |
Description |
double getStandsLevel() |
Returns the base Z-level where the bulk conveyor stands
will be drawn from. |
void setStandsLevel(double standsLevel) |
Sets the base Z-level to draw conveyor stands from. If the conveyor has sloped areas, it will be drawn with stands of different height - starting from the same base level. Parameter: |
boolean isDrawStands() |
Returns true, if the bulk conveyor is drawn with stands. Otherwise, returns false. |
void setDrawStands(boolean drawStands) |
Enables drawing the bulk conveyor with stands in 3D mode. Parameter: |
Function |
Description |
Point getStartPoint() |
Returns the Point object with coordinates of the bulk conveyor's starting point. |
Point getStartPoint(Point out) |
Returns the Point object with coordinates of the bulk conveyor's starting point. Parameter: |
Point getEndPoint() |
Returns the Point object with coordinates of the bulk conveyor's ending point. |
Point getEndPoint(Point out) |
Returns the Point object with coordinates of the bulk conveyor's ending point. Parameter: |
Position getStartPosition() |
Returns the Position object with coordinates and orientation of the bulk conveyor's starting point. |
Position getStartPosition(Position
out) |
Returns the Position object with coordinates and orientation of the bulk conveyor's starting point. Parameter: |
Position getEndPosition() |
Returns the Position object with coordinates and orientation of the bulk conveyor's ending point. |
Position getEndPosition(Position out) |
Returns the Position object with coordinates and orientation of the bulk conveyor's ending point. Parameter: |
Point getPointAtOffset(double offset, Point out) |
Returns the Point object with coordinates and orientation of the point that is located at the given offset distance (in pixels) from the bulk conveyor's starting point. Parameters: |
Point getPointAtOffset(double offset, |
Returns the Point object with coordinates and orientation of the point that is located at the given offset distance from the bulk conveyor's starting point. Parameters: |
Position
getPositionAtOffset(double offset, Position out) |
Returns the Position object with coordinates and orientation of the point that is located at the given offset distance (in pixels) from the bulk conveyor's starting point. Parameters: |
Position
getPositionAtOffset(double offset, |
Returns the Position object with coordinates and orientation of the point that is located at the given offset distance from the bulk conveyor's starting point. Parameters: |
boolean contains(double px, double py) |
Returns true if the bulk conveyor contains the point with the given coordinates. Parameters: |
boolean contains(double px, double
py, |
Returns true if the bulk conveyor contains the point with the given coordinates using the given distance tolerance; returns false otherwise. Parameters: |
boolean containsSq(double px,
double py, |
Returns true if the bulk conveyor contains the point with the given coordinates using the given square distance tolerance; returns false otherwise. Parameters: |
Function |
Description |
int getSegmentCount() |
Returns the number of the bulk conveyor's segments. |
MarkupSegment getSegment(int index) |
Returns the segment by the provided index. Parameter: |
Function |
Description |
Color getColor() |
Returns the color of the markup element, or null if markup element has no color or has textured (in this case use getTexture() to get the shape's texture). |
void setColor(Color color) |
Sets the color of the bulk conveyor shape. Parameter: |
void setColor(Paint color) |
Sets the color of the bulk conveyor shape. Parameter: |
Texture getTexture() |
Returns the texture of the bulk conveyor element if it has texture. |
Function |
Description |
boolean isVisible() |
Returns true is the bulk conveyor shape is visible; returns false otherwise. |
void setVisible(boolean v) |
Sets the visibility of the bulk conveyor shape. Parameter: |
Function |
Description |
void remove() |
Removes the bulk conveyor belt from the presentation. If
this element is not
a part of presentation, the function does nothing. |