com.hdcookbook.grin.features
Class SEFade

java.lang.Object
  extended by com.hdcookbook.grin.Feature
      extended by com.hdcookbook.grin.features.Modifier
          extended by com.hdcookbook.grin.features.Fade
              extended by com.hdcookbook.grin.features.SEFade
All Implemented Interfaces:
Node, SENode, SEScalableNode

public class SEFade
extends Fade
implements SENode, SEScalableNode


Field Summary
 
Fields inherited from class com.hdcookbook.grin.features.Fade
endCommands, keyAlphas, keyframes, loopCount, repeatFrame, srcOver
 
Fields inherited from class com.hdcookbook.grin.features.Modifier
activated, part
 
Fields inherited from class com.hdcookbook.grin.Feature
name, show
 
Constructor Summary
SEFade(SEShow show)
           
SEFade(SEShow show, java.lang.String name, boolean srcOver, int[] keyframes, int[] keyAlphas, int repeatFrame, int loopCount, Command[] endCommands)
           
 
Method Summary
 void accept(SEShowVisitor visitor)
          Calls the visit method corresponding to this node type.
 void changeFeatureReference(Feature from, Feature to)
          Change a feature reference from one feature to a new one.
 Command[] getEndCommands()
          Internal use only
 int[] getKeyAlphas()
           
 void getKeyAlphas(int[] keyAlphas)
           
 int[] getKeyframes()
           
 void getKeyframes(int[] keys)
           
 int getLoopCount()
          Internal use only
 int getRepeatFrame()
          Internal use only
 java.lang.String getRuntimeClassName()
          Returns the class that should be constructed at Show runtime to represent this SENode.
 boolean getSrcOver()
          Internal use only
 void getSrcOver(boolean srcOver)
          Internal use only
 void postProcess(ShowBuilder builder)
          Do any needed post-processing in this show.
 void scaleBy(int xScale, int yScale, int xOffset, int yOffset)
          Scale this node by the given scale factor, and apply the given offset.
 void setEndCommands(Command[] endCommands)
          Internal use only
 void setRepeatFrame(int repeatFrame)
          Internal use only
 java.lang.String toString()
          
 void writeInstanceData(GrinDataOutputStream out)
          Record this node information to the binary file format.
 
Methods inherited from class com.hdcookbook.grin.features.Fade
addDisplayAreas, createClone, initialize, initializeClone, nextFrame, paintFrame, readInstanceData, setActivateMode, setAlpha
 
Methods inherited from class com.hdcookbook.grin.features.Modifier
addSubgraph, destroy, getPart, getX, getY, markDisplayAreasChanged, needsMoreSetup, setChildChanged, setSetupMode, setup
 
Methods inherited from class com.hdcookbook.grin.Feature
activate, cloneCommands, clonedReference, cloneSubgraph, deactivate, destroyClonedSubgraph, getName, isSetup, makeNewClone, resetFeature, sendFeatureSetup, setName, setup, unsetup
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

SEFade

public SEFade(SEShow show)

SEFade

public SEFade(SEShow show,
              java.lang.String name,
              boolean srcOver,
              int[] keyframes,
              int[] keyAlphas,
              int repeatFrame,
              int loopCount,
              Command[] endCommands)
Method Detail

getKeyframes

public int[] getKeyframes()

getKeyAlphas

public int[] getKeyAlphas()

getSrcOver

public boolean getSrcOver()
Internal use only


getLoopCount

public int getLoopCount()
Internal use only


getEndCommands

public Command[] getEndCommands()
Internal use only


getRepeatFrame

public int getRepeatFrame()
Internal use only


getKeyframes

public void getKeyframes(int[] keys)

getKeyAlphas

public void getKeyAlphas(int[] keyAlphas)

getSrcOver

public void getSrcOver(boolean srcOver)
Internal use only


setEndCommands

public void setEndCommands(Command[] endCommands)
Internal use only


setRepeatFrame

public void setRepeatFrame(int repeatFrame)
Internal use only


writeInstanceData

public void writeInstanceData(GrinDataOutputStream out)
                       throws java.io.IOException
Description copied from interface: SENode
Record this node information to the binary file format. An implementation of this method is recommended to call out.writeSuperClassData(this) as the first line of the method to write out data defined in the base class of this Node type.

Specified by:
writeInstanceData in interface SENode
Parameters:
out - The stream to write out.
Throws:
java.io.IOException - if error occurs.
See Also:
GrinDataOutputStream.writeSuperClassData(Feature), GrinDataOutputStream.writeSuperClassData(RCHandler), GrinDataOutputStream.writeSuperClassData(Segment), GrinDataOutputStream.writeSuperClassData(Command)

getRuntimeClassName

public java.lang.String getRuntimeClassName()
Description copied from interface: SENode
Returns the class that should be constructed at Show runtime to represent this SENode.

Specified by:
getRuntimeClassName in interface SENode
Returns:
String A fully qualified classname of a Node at xlet runtime.

accept

public void accept(SEShowVisitor visitor)
Description copied from interface: SENode
Calls the visit method corresponding to this node type.

If you are defining a user-defined feature, there are some restrictions that you'll want to follow. If your extension is a feature that has children, then you should make it a subclass of one of the built-in feature types, Assembly, Modifer or Group. That's because the GRIN compiler defines visitors that need to visit every node in the tree, but these built-in visitors don't know about your extension types. By making your extension type a subclass of one of the standard ones, and by making your accept() method call either visitAssembly(), visitGroup() or visitUserDefinedModifier(), as appropriate, you'll ensure that all the children get visited.

Specified by:
accept in interface SENode
Parameters:
visitor - SEShowVisitor object.
See Also:
SEShowVisitor

postProcess

public void postProcess(ShowBuilder builder)
                 throws java.io.IOException
Do any needed post-processing in this show. The grin compiler works as follows:

During the post-process phase, a node can add new features to the show, by calling ShowBuilder.addSyntheticFeature(), and it can insert a new feature as the parent of a given feature, by calling ShowBuilder.injectParent(). It can also add segments and handlers by calling the appropriate builder methods.

When a parent is injected, the ShowBuilder calls postProcess() on all nodes automatically, including nodes that are created during the execution of postProcess() in another node.

Specified by:
postProcess in interface SENode
Parameters:
builder - The builder that holds state for the show
Throws:
java.io.IOException - if an error is encountered
See Also:
ShowBuilder.addSyntheticFeature(Feature), ShowBuilder.injectParent(Feature, Feature)

changeFeatureReference

public void changeFeatureReference(Feature from,
                                   Feature to)
                            throws java.io.IOException
Change a feature reference from one feature to a new one. If your node has a reference to the feature from, it should be changed to refer to to. This is called for every node in an SEShow when SENode.injectParent is used.

The ShowBuilder calls changeFeatureReference() on all nodes automatically, including nodes that are created during the execution of postProcess().

Specified by:
changeFeatureReference in interface SENode
Throws:
java.io.IOException - If the operation can't be completed
See Also:
SENode.changeFeatureReference(Feature, Feature)

scaleBy

public void scaleBy(int xScale,
                    int yScale,
                    int xOffset,
                    int yOffset)
Scale this node by the given scale factor, and apply the given offset. This will change the size of the features and RC handlers within the show at compile time, so no special scaling action is required at runtime.

Specified by:
scaleBy in interface SEScalableNode
Parameters:
xScale - x scale factor in mills
yScale - y scale factor in mills
xOffset - x offset in pixels
yOffset - y offset in pixels

toString

public java.lang.String toString()

Overrides:
toString in class Feature
Returns:
a developer-friendly description of this feature, for debugging