|
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()
VaryingValueReturns 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
VaryingValueAdds 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 VaryingValuecontrolPoint - Control point to add to the sequence of control
points.
NullPointerException - The given control point is null.
IllegalArgumentExceptionpublic int countControlPoints()
VaryingValueReturns 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
VaryingValueRetrieves 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 VaryingValueindex - 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
VaryingValueThis 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 VaryingValueindex - 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
VaryingValueReturns 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 VaryingValueinputValue - 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()
VaryingValueReturns 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 VaryingValueVaryingValue.getInterpolatedValue(Rational),
InterpolationConstantpublic boolean equals(Object o)
MAJCommonTests 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 MAJCommonequals in class Parametero - Object to test for equality with.
Object.equals(Object)public int hashCode()
MAJCommonReturns a hash code value for this interchange object.
hashCode in interface MAJCommonhashCode in class ParameterObject.hashCode()public VaryingValue clone()
MAJCommonCreates 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 MAJCommonclone in class ParameterObject.clone()public void appendXMLChildren(Node parent)
XMLSerializableAppend 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 XMLSerializableappendXMLChildren in class Parameterparent - 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 | |||||||