A particle is a 2D drawing element that displays a simple geometrical shape (a rectangle or an ellipse), at given coordinates of the parent drawing or plotting panel. The shape is drawn relative (see the Position property) to the given coordinates with the size specified in each direction. The element can also be applied a rotation and a scale factor for each coordinate.
Particles respond to user interaction on their position coordinates (changing their position), invoking up to five different actions.
Position and Size |
Name | Description | Values accepted | Default |
Pos X | The X coordinate for the element. | A constant or variable of type double or int. | |
Pos Y | The Y coordinate for the element. | A constant or variable of type double or int. | |
Position Array | The array with the coordinates of the element. | A double array. | |
Size X | The size of the element in the X direction. | A constant or variable of type double or int. | |
Size Y | The size of the element in the Y direction. | A constant or variable of type double or int. | |
Size Array | The array with the size of the element in each coordinate. | A double array. | |
Pixel Size | Whether the size of the element is given in pixels. By default (i.e. false) the size of the element is relative to its parent panel coordinate system. | A boolean variable or one of the constants true or false. | |
Scale X | The scale factor for the element in the X direction. | A constant or variable of type double or int. | |
Scale Y | The scale factor for the element in the Y direction. | A constant or variable of type double or int. | |
Visibility and Interaction |
Name | Description | Values accepted | Default |
Visible | The visibility of the element. | A boolean variable or one of the constants true or false. | |
Measured | Whether the element affects its parent panel’s autoscaling. | A boolean variable or one of the constants true or false. | |
Draggable | Whether the element can be dragged. | A boolean variable or one of the constants true or false. | |
Sensitivity | The size of the hot spot (in pixels). | A constant or variable of type int, 0 makes the full particle the hot spot. | |
On Press | The action to invoke when the element is pressed. | The Java code to invoke for the action. | |
On Drag | The action to invoke when the element is dragged. | The Java code to invoke for the action. | |
On Release | The action to invoke when the element is released. | The Java code to invoke for the action. | |
On Enter | The action to invoke when the mouse enters the element. | The Java code to invoke for the action. | |
On Exit | The action to invoke when the mouse leaves the element. | The Java code to invoke for the action. | |
Graphical Aspect |
Name | Description | Values accepted | Default |
Style | The drawing style for the element. | Use the editor provided or read about particle styles. | |
Offset | The exact drawing position relative to the element's coordinates. | Use the editor provided or read about positions. | |
Rotate | The (counter-clockwise) rotation angle to apply to the element. | A constant or variable of type double for an angle in radians, or a constant or variable of type int for an angle in degrees. | |
Line Color | The color used for the lines of the element. | Use the editor provided or read about colors. | |
Fill Color | The color used to fill the element. | Use the editor provided or read about colors. The special value null draws a hollow element. | |
Stroke | The thickness and line style for the lines of the element. | A constant or variable of type double or int indicates the thickness. For more sophisticated strokes, read about strokes. | 1 |