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 agent
 If selected, the bulk conveyor belt is also visible on the upper agent 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 absolute Zcoordinate of the level where the bulk conveyor belt is located or from level's Z.
... from level's Z  [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 absolute Zcoordinate of the level where this bulk conveyor belt is located.
Level – Level to which this element belongs to.
X  Xcoordinate of the bulk conveyor belt's start point.
Y  Ycoordinate 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)] Zcoordinate 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 Zlevel where the bulk conveyor stands will be drawn from. 
void setStandsLevel(double standsLevel) 
Sets the base Zlevel 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 
Level getLevel() 
Returns the
level
on which this bulk conveyor is located. 
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. 