Factory:org.bzdev.anim2d.GraphViewFactory
Parameter Types
(optional keytype)
(value type)
Range RV Mode Add/Set
initialAngle
Initial Angle
double [-∞, ∞] false set
The initial angle in degrees
The value of this parameter is the initial angle in graph coordinate space, measured in degrees. Positive values are counterclockwise in graph coordinate space.
initialX
Initial X Coordinate
double [-∞, ∞] false set
The initial X coordinate
The value of this parameter is the initial X coordinate in graph coordinate space units.
initialY
Initial Y Coordinate
double [-∞, ∞] false set
The initial Y coordinate
The value of this parameter is the initial Y coordinate in graph coordinate space units.
scaleX
X Scale Factor
double (0.0, ∞] false set
for the X direction, a unit distance in user space divided by a unit distance in graph coordinate space
This parameter's value is the scale factor for the X direction (the amount by which to multiple a distance in graph coordinate space along the X axis to get the corresponding distance in user space).
scaleY
Y Scale Factor
double (0.0, ∞] false set
for the Y direction, a unit distance in user space divided by a unit distance in graph coordinate space
This parameter's value is the scale factor for the X direction (the amount by which to multiple a distance in graph coordinate space along the Y axis to get the corresponding distance in user space).
timeline
Timeline
int N/A false add
Timeline entries (use only to clear)
This is an integer-keyed set of values that define changes in an object's configuration. Subclasses may provide additional timeline parameters.
timeline.acceleration
Acceleration
int
java.lang.Double
[-∞, ∞] false set
The acceleration of an object while the object has a path
This parameter's value is the acceleration of an object (unit distance per second squared) while the object has a path.
timeline.angle
Angle
int
java.lang.Double
[-∞, ∞] false set
The angle in degrees, measured counterclockwise from the positive x axis
timeline.angleFunction
Angle Function
int
org.bzdev.devqsim.SimFunction
N/A false set
the angle as a function of time while the object has a path
the angle as a function of time while the object has a path To remove an angle function, set it to animation.nullFunction() where animation is the animation associated with this factory. The argument for this function is the time measured from the time set by the value of the parameter timeline.time0. When an angle function is provided, the parameters providing a angular velocity and acceleration are ignored, and the object's angular velocity and position are updated based on the derivatives of the function (if not provided, a value is set to Double.NaN).
timeline.angleRelative
Angle Relative
int
java.lang.Boolean
N/A false set
The angle-relative flag.
When this parameter's value is true, the path angle is assumed to be the angle relative to the path (i.e., measured with respect to a tangent vector for the path). When this parameter's value is false, the angle is measured relative to the X axis in graph coordinate space.
timeline.angularAcceleration
Angular Acceleration
int
java.lang.Double
[-∞, ∞] false set
The angular Acceleration while the object has a path
This parameter's value provides the angular acceleration in degrees per second squared while the object has a path.
timeline.angularVelocity
Angular Velocity
int
java.lang.Double
[-∞, ∞] false set
The angular velocity while the object has a path
This parameter's value provides the angular velocity in degrees/second while the object has a path.
timeline.distanceFunction
Distance Function
int
org.bzdev.devqsim.SimFunction
N/A false set
The distance along the path as a function of time
This parameter provides a function that determines the distance along the path as a function of time. To remove a distance function, set it to animation.nullFunction() where animation is the animation associated with this factory. The argument for this function is the time measured from the time set by the value of the parameter timeline.time0. When a distance function is provided, the parameters providing a velocity and acceleration are ignored, and the object's velocity and position are updated based on the derivatives of the function (if not provided, a value is set to Double.NaN).
timeline.path
Path
int
org.bzdev.anim2d.AnimationPath2D
N/A false set
The path to follow
This parameter's value provides the path an object will follow. To indicate that no path is to be used, set this parameter to amimation.nullPath(), where animation is the instance of org.bzdev.anim2d.Animation2D associated with this factory. The path is a parametrized path with the path parameter usually being denoted by the variable u.
timeline.pathAngle
Angle
int
java.lang.Double
[-∞, ∞] false set
The angle of the object while the object has a path
This parameter provides the angle for an object in units of degrees. The interpretation of the angle is set by the value of timeline.angleRelative.
timeline.t0
int
double
[-∞, ∞] false set
the interval to wait before motion on the path starts
This parameter's value is the time to wait from the time for this timeline entry (the value of the parameter timeline.time) before motion along a path starts.
timeline.time
Time
int
java.lang.Double
[-∞, ∞] false set
The time for a timeline entry
This parameter must be provided if a timeline entry exists. The units are those used by the double-precession time unit for the simulation (for animations, this is generally seconds).
timeline.traceSetMode
TraceSet Mode
int
org.bzdev.devqsim.TraceSetMode
N/A false set
The trace-set mode for a timeline entry
This parameter indicates how the trace sets associated with a timeline entry should be interpreted. The values are an enumeration whose type is org.bzdev.devqsim.TraceSetMode and are used as follows:
  • KEEP - keep the existing trace sets, adding additional ones specified by the parameter timeline.traceSets.
  • REMOVE - remove the trace sets specified by the parameter timeline.traceSets.
  • REPLACE - remove all existing trace sets and replace those with the ones specified by the timeline.traceSets parameter.
timeline.traceSets
Trace Sets
int
org.bzdev.devqsim.TraceSet
N/A false add
The trace sets for a timeline entry
This parameter represents a set of TraceSet objects (the three-argument add method is used to add entries). How the entries are interpreted depends on the trace set mode for this timeline entry.
timeline.u0
Initial Parameter Value
int
double
[-∞, ∞] false set
the initial value of the path's parameter
This parameter's value is the initial value of the path's path parameter.
timeline.velocity
Velocity
int
java.lang.Double
[-∞, ∞] false set
The velocity of an object while the object has a path
This parameter's value is the velocity of an object (unit distance per second) while the object has a path.
timeline.visible
Visibility
int
java.lang.Boolean
N/A false set
The visibility for a timeline entry
This parameter's value determines the visibility of an object. When false the object is invisible and when true the object is visible.
timeline.x
X Coordinate
int
java.lang.Double
[-∞, ∞] false set
The x coordinate for a timeline entry
timeline.y
Y Coordinate
int
java.lang.Double
[-∞, ∞] false set
The y coordinate for a timeline entry
timeline.zoom
Zoom Value
int
double
(0.0, ∞] false set
The zoom value indicating the magnification
This parameter's value is the zoom value indicating the magnification, and is valid when the timeline.zoomMode parameter's value is SET_VALUE.
timeline.zoomInterval
Zoom Interval
int
double
[0.0, ∞] false set
The interval for the zoom to change to the zoomTarget value
This parameter's value is the interval for the zoom to change to the value specified by the zoomTarget parameter. This interval is measured in simulation/animation ticks and is valid when the zoomMode parameter has the value SET_TARGET.
timeline.zoomMode
Zoom Mode
int
org.bzdev.anim2d.GraphView.ZoomMode
N/A false set
Enumeration constant to indicate which zoom parameters are valid
This parameter's value is an enumeration constant, defined by org.bzdev.anim2d.GraphView.ZoomMode:
  • SET_VALUE. Set the value explicitly.
  • SET_RATE. Set the logarithmic zoom rate.
  • SET_TARGET. Set a target value to be reached after a specified interval using a logarithmic zoom rate.
The enumeration also has a constant named KEEP that is the default value used to indicate that no changes are wanted and this default is in effect when a zoom mode is not specified.
timeline.zoomRate
Zoom Rate
int
double
[-∞, ∞] false set
The zoom factor will change as exp(zoomRate t)
This parameter's value is the logarithmic zoom rate, indicating a rate of change for the magnification, and is valid when the timeline.zoomMode parameter's value is SET_RATE. If t is the time, measured from the current time, and r is the logarithmic zoom rate, the zoom factor will be multiplied by exp(rt) to obtain the value after an interval t.
timeline.zoomTarget
Zoom Target Value
int
double
(0.0, ∞] false set
The final zoom value
This parameter's value is the magnification one desires at the end of an interval specified by the value of the zoomInterval parameter. In effect an appropriate zoom rate is computed and used over the specified interval.
traceSets
Trace Sets
org.bzdev.devqsim.TraceSet N/A false add
A set of TraceSet objects, used for tracing
This parameter provides a set of TraceSets a SimObject will use for tracing. One should use the add and remove factory methods as this parameter refers to a set of values.
visible
Visibility
boolean N/A false set
The visibility flag - objects with this set to false are invisible.
xFrameFraction
X Frame Fraction
double [-∞, ∞] false set
the fraction of frame in the X direction corresponding to the x coordinate giving the view's position.
This parameter's value is the fractional distance from the graph's left offset to its right offset at which the point specifying the X coordinate of a GraphView's location appears. This point's graph coordinate space coordinates are (x,y), where x is the value of the initialX parameter and y is the value of the initialY parameter. The graph is the org.bzdev.graphs.Graph used by org.bzdev.anim2d.Animation2D to display an animation.
yFrameFraction
Y Frame Fraction
double [-∞, ∞] false set
the fraction of frame in the X direction corresponding to the x coordinate giving the view's position.
This parameter's value is the fractional distance from the graph's lower offset to its upper offset at which the point specifying the Y coordinate of the graph's location appears. This point's graph coordinate space coordinates are (x,y), where x is the value of the initialX parameter and y is the value of the initialY parameter. The graph is the org.bzdev.graphs.Graph used by org.bzdev.anim2d.Animation2D to display an animation.
zoom
Zoom Factor
double (0.0, ∞] false set
the initial zoom value (the default is 1.0)