|
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.ControlPoint
@AAFClass(uuid1=218169601,
uuid2=257,
uuid3=6400,
uuid4={6,14,43,52,2,6,1,1},
definedName="ControlPoint",
description="The ControlPoint class specifies a value and a time point and is used to specify an effect control value.")
public class ControlPoint
Implements a value and a time point (position) that is used to specify an effect control value. Control points must be added to a varying value that is then added to the operation group describing the effect.
THE COMMENTS FOR THIS CLASS ARE INCOMPLETE.
| Nested Class Summary | |
|---|---|
static class |
ControlPoint.XMLHandler
|
| Nested classes/interfaces inherited from class tv.amwa.maj.entity.InterchangeObject |
|---|
InterchangeObject.InterchangeObjectXMLHandler |
| Constructor Summary | |
|---|---|
ControlPoint(VaryingValue varyingValue,
Rational time,
Object value)
Creates and initializes a new control point object, which specifies a value and a time point and is used to specify an effect control value. |
|
| Method Summary | |
|---|---|
void |
appendXMLChildren(Node parent)
Append child elements to the given parent node to serialize the value of an object to an XML fragment. |
ControlPoint |
clone()
Creates a cloned copy of this entity. |
boolean |
equals(Object o)
Tests to see if the given object is equal to this interchange object. |
EditHintType |
getEditHint()
Returns the edit hint of the control point, which describes how to alter the position (time) of the operation group is made longer or shorter. |
Rational |
getTime()
Returns the time property of this control point, which specifies the time within the varying value segment for which the value is defined. |
TypeDefinition |
getTypeDefinition()
Returns the type definition of the value of this control point. |
Object |
getValue()
Returns the control point value at the control point's postition (time), which is a value of the data type returned by ControlPoint.getTypeDefinition(). |
int |
hashCode()
Returns a hash code value for this interchange object. |
void |
setEditHint(EditHintType editHint)
Sets the control point edit hint value, which describes how to alter the position (time) if the operation group is made longer or shorter. |
void |
setPropertiesFromInterface(ControlPoint castFrom)
|
void |
setTime(Rational time)
Sets the position of the control point within an operation group, which specifies the time within the varying value segment for which the value is defined. |
void |
setValue(Object value)
Set the data value describing this control point at the control point's postition (time), which is a value of the data type returned by ControlPoint.getTypeDefinition().. |
| 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, wait, wait, wait |
| 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 ControlPoint(VaryingValue varyingValue,
Rational time,
Object value)
throws NullPointerException,
RationalRangeException
Creates and initializes a new control point object, which specifies a value and a time point and is used to specify an effect control value.
varyingValue - A varying value. This determines the type of this control point through the
parameter definition.time - Specifies the time within the VaryingValue segment for which the value is defined,
with a value between 0 and 1.value - Control point value.
NullPointerException - One or more of the arguments is null and all values
are required.
RationalRangeException - Rational time value is outside the inclusive range 0.0 to 1.0.
ClassCastException - Cannot cast the given Java value to the given AAF type definition.| Method Detail |
|---|
public final void setPropertiesFromInterface(ControlPoint castFrom)
InterchangeObject.setPropertiesFromInterface(tv.amwa.maj.iface.InterchangeObject)
@AAFProperty(uuid1=87033096,
uuid2=0,
uuid3=0,
uuid4={6,14,43,52,1,1,1,2},
definedName="EditHint",
typeName="EditHintType",
optional=true,
uniqueIdentifier=false,
pid=6660)
public EditHintType getEditHint()
throws PropertyNotPresentException
ControlPointReturns the edit hint of the control point, which describes how to alter the position (time) of the operation group is made longer or shorter. This is an optional property.
getEditHint in interface ControlPointPropertyNotPresentException - The optional edit hint property is not present
for this control point.public void setEditHint(EditHintType editHint)
ControlPointSets the control point edit hint value, which describes how to alter the
position (time) if the operation group is made longer or shorter.
Set this optional property to null to omit it.
setEditHint in interface ControlPointeditHint - Specifies a hint to be used if the effect starting time or
length is changed during editing.
@AAFProperty(uuid1=117571843,
uuid2=4098,
uuid3=256,
uuid4={6,14,43,52,1,1,1,2},
definedName="Time",
typeName="Rational",
optional=false,
uniqueIdentifier=false,
pid=6659)
public Rational getTime()
ControlPointReturns the time property of this control point, which specifies the time within the varying value segment for which the value is defined. The value of the time property should be between&nbps;0 and 1 inclusive.
getTime in interface ControlPoint
public void setTime(Rational time)
throws RationalRangeException,
NullPointerException
ControlPointSets the position of the control point within an operation group, which specifies the time within the varying value segment for which the value is defined. The value is expressed as a rational value between from 0 to 1.
setTime in interface ControlPointtime - Control point time.
RationalRangeException - The rational value is outside the range 0 to 1.
NullPointerException - The given time value is null.public TypeDefinition getTypeDefinition()
ControlPointReturns the type definition of the value of this control point.
getTypeDefinition in interface ControlPointTypeDefinitionIndirect
@AAFProperty(uuid1=87033101,
uuid2=0,
uuid3=0,
uuid4={6,14,43,52,1,1,1,2},
definedName="Value",
typeName="Indirect",
optional=false,
uniqueIdentifier=false,
pid=6658)
public Object getValue()
ControlPointReturns the control point value at the control point's postition (time), which
is a value of the data type returned by ControlPoint.getTypeDefinition().
getValue in interface ControlPointTypeDefinitionIndirect,
ControlPoint.getTypeDefinition()
public void setValue(Object value)
throws NullPointerException,
ClassCastException
ControlPointSet the data value describing this control point at the control point's postition (time), which
is a value of the data type returned by ControlPoint.getTypeDefinition()..
setValue in interface ControlPointvalue - The value of this control point at its position (time).
NullPointerException - The given control point value is null.
ClassCastException - Cannot cast the given value to the defined type
for this control point.TypeDefinition.createValue(Object),
PropertyValue.getValue()public 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 Objecto - 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 ObjectObject.hashCode()public ControlPoint 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 ObjectObject.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 InterchangeObjectparent - 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 | |||||||