|
Media Authoring with Java API |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objecttv.amwa.maj.entity.InterchangeObject
tv.amwa.maj.entity.Parameter
tv.amwa.maj.entity.VaryingValue
@AAFClass(uuid1=218169601, uuid2=257, uuid3=15872, uuid4={6,14,43,52,2,6,1,1}, definedName="VaryingValue", description="The VaryingValue class specifies a changing data value for an effect control value.") public class VaryingValue
Implements a changing data value for an effect control value.
THE COMMENTS FOR THIS CLASS ARE INCOMPLETE.
Nested Class Summary | |
---|---|
static class |
VaryingValue.PointListXMLHandler
|
static class |
VaryingValue.XMLHandler
|
Nested classes/interfaces inherited from class tv.amwa.maj.entity.Parameter |
---|
Parameter.ParameterXMLHandler |
Nested classes/interfaces inherited from class tv.amwa.maj.entity.InterchangeObject |
---|
InterchangeObject.InterchangeObjectXMLHandler |
Constructor Summary | |
---|---|
VaryingValue(ParameterDefinition parameterDefinition,
InterpolationDefinition interpolation)
Creates and initializes a new varying value object, which specifies a changing data value for an effect control value. |
Method Summary | |
---|---|
void |
addControlPoint(ControlPoint controlPoint)
Adds a control point to the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. |
void |
appendXMLChildren(Node parent)
Append child elements to the given parent node to serialize the value of an object to an XML fragment. |
VaryingValue |
clone()
Creates a cloned copy of this entity. |
int |
countControlPoints()
Returns the number of control points in the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. |
boolean |
equals(Object o)
Tests to see if the given object is equal to this interchange object. |
ControlPoint |
getControlPointAt(int index)
Retrieves the input control point at the given index in the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. |
List<ControlPoint> |
getControlPoints()
Returns the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. |
Object |
getInterpolatedValue(Rational inputValue)
Returns the interpolated value of the varying value at a given time position, which should be a value between 0 and 1 inclusive. |
InterpolationDefinition |
getInterpolationDefinition()
Returns the interpolation property of this varying value, which specifies the kind of interpolation to be used to find the value between control points. |
int |
hashCode()
Returns a hash code value for this interchange object. |
void |
removeControlPointAt(int index)
This function removes the input control point at the given index in the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. |
void |
setPropertiesFromInterface(VaryingValue castFrom)
|
Methods inherited from class tv.amwa.maj.entity.Parameter |
---|
getDefinitionValue, getId, getParameterDefinition, getTypeDefinition, setId, setParameterDefinition, setPropertiesFromInterface |
Methods inherited from class tv.amwa.maj.entity.InterchangeObject |
---|
castFromInterface, countProperties, createOptionalPropertyValue, disableGenerationTracking, enableGenerationTracking, getDefinition, getGeneration, getGenerationAUID, getProperties, getPropertyValue, isGenerationTracked, isPropertyPresent, omitOpionalProperty, registerImplementation, setPropertiesFromInterface, setPropertyValue, toString |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface tv.amwa.maj.iface.Parameter |
---|
getParameterDefinition, getTypeDefinition |
Methods inherited from interface tv.amwa.maj.iface.InterchangeObject |
---|
countProperties, createOptionalPropertyValue, disableGenerationTracking, enableGenerationTracking, getDefinition, getGeneration, getGenerationAUID, getProperties, getPropertyValue, isGenerationTracked, isPropertyPresent, omitOpionalProperty, setPropertyValue |
Methods inherited from interface tv.amwa.maj.entity.MAJCommon |
---|
toString |
Constructor Detail |
---|
public VaryingValue(ParameterDefinition parameterDefinition, InterpolationDefinition interpolation) throws NullPointerException
Creates and initializes a new varying value object, which specifies a
changing data value for an effect control value. The value is identified with the
given the given parameter definition
, and requires an
interpolation definition
. Although the list of
control points should not be empty, varying values are used to create control point.
The process of setting up a varying value is as follows:
addControlPoint(ControlPoint)
.
parameterDefinition
- Parameter definition for the varying value, which
determines the type of the varying value.interpolation
- Specifies the kind of interpolation to be used to
find the value between control points.
NullPointerException
- One or more of the arguments is null
and
all are required.Method Detail |
---|
public final void setPropertiesFromInterface(VaryingValue castFrom)
InterchangeObject.setPropertiesFromInterface(tv.amwa.maj.iface.InterchangeObject)
@AAFProperty(uuid1=100729092, uuid2=1542, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="PointList", typeName="StrongReferenceVector of ControlPoint", optional=false, uniqueIdentifier=false, pid=19970) public List<ControlPoint> getControlPoints()
VaryingValue
Returns the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined.
getControlPoints
in interface VaryingValue
public void addControlPoint(ControlPoint controlPoint) throws NullPointerException, IllegalArgumentException
VaryingValue
Adds a control point to the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. The point will be sorted by time order, not the order that the points were added in.
addControlPoint
in interface VaryingValue
controlPoint
- Control point to add to the sequence of control
points.
NullPointerException
- The given control point is null
.
IllegalArgumentException
public int countControlPoints()
VaryingValue
Returns the number of control points in the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined.
countControlPoints
in interface VaryingValue
public ControlPoint getControlPointAt(int index) throws IndexOutOfBoundsException
VaryingValue
Retrieves the input control point at the given index in the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined.
getControlPointAt
in interface VaryingValue
index
- 0-based index of the control point to retrieve.
IndexOutOfBoundsException
- The given index is outside the
acceptable range for the current sequence of control points of this
varying value.public void removeControlPointAt(int index) throws IndexOutOfBoundsException
VaryingValue
This function removes the input control point at the given index in the sequence of control points of this varying value, each of which specifies a value and a time point at which the value is defined. Control points already existing at indices higher than the given index will be moved to the next lower index to accommodate.
removeControlPointAt
in interface VaryingValue
index
- Index of control point to remove from the sequence.
IndexOutOfBoundsException
- The index is outside acceptable
range for the current sequence of control points of this varying
value.public Object getInterpolatedValue(Rational inputValue) throws NullPointerException
VaryingValue
Returns the interpolated value of the varying value at a given time position, which should be a value between 0 and 1 inclusive. The data type of the value contained in the value returned will be the same as the data type of the parameter this varying value provides a value for, which is the same as the data type of all of the control points.
getInterpolatedValue
in interface VaryingValue
inputValue
- Time position along the operation group to find the
interpolated value for.
NullPointerException
- The given input value is null
.VaryingValue.getInterpolationDefinition()
,
InterpolationConstant
,
Parameter.getTypeDefinition()
,
ControlPoint.getTypeDefinition()
,
TypeDefinition.createValue(Object)
,
PropertyValue.getValue()
@AAFProperty(uuid1=100729092, uuid2=261, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="Interpolation", typeName="WeakReference to InterpolationDefinition", optional=false, uniqueIdentifier=false, pid=19969) public InterpolationDefinition getInterpolationDefinition()
VaryingValue
Returns the interpolation property of this varying value, which specifies the kind of interpolation to be used to find the value between control points.
getInterpolationDefinition
in interface VaryingValue
VaryingValue.getInterpolatedValue(Rational)
,
InterpolationConstant
public boolean equals(Object o)
MAJCommon
Tests to see if the given object is equal to this interchange object. To be equal, the given value must be not null, share the same interface to its value and each of the properties of the value must each be equal.
equals
in interface MAJCommon
equals
in class Parameter
o
- Object to test for equality with.
Object.equals(Object)
public int hashCode()
MAJCommon
Returns a hash code value for this interchange object.
hashCode
in interface MAJCommon
hashCode
in class Parameter
Object.hashCode()
public VaryingValue clone()
MAJCommon
Creates a cloned copy of this entity. The clone will be initialized to have the same value as this value but exists independently from then on. Changes to this value will not effect the clone and changes to the clone will not effect this. MAJ API clones are true deep clones with no shared references to areas of memory within the original.
This method does not throw a CloneNotSupportedException
as all
entity values must implement the Cloneable
interface. If a cloning
error does occur, a null
value will be returned but this is very unlikely
to happen.
clone
in interface MAJCommon
clone
in class Parameter
Object.clone()
public void appendXMLChildren(Node parent)
XMLSerializable
Append child elements to the given parent node to serialize the value of an object
to an XML fragment. Methods of the XMLBuilder
class are provided to help with this
process.
appendXMLChildren
in interface XMLSerializable
appendXMLChildren
in class Parameter
parent
- XML parent element to append child nodes to.
|
Media Authoring with Java API |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |