hep.graphics.heprep1.adapter
Class HepRepAdapter

java.lang.Object
  hep.graphics.heprep1.adapter.HepRepAdapter

All Implemented Interfaces:

HepRep

public class HepRepAdapter

extends Object

implements HepRep

Version:

$Id: HepRepAdapter.java,v 1.3 2004/08/30 23:14:01 duns Exp $

Author:

Mark Donszelmann

Source Code:

HepRepAdapter.java

Constructor Summary

HepRepAdapter(HepRep heprep1)

Method Summary

void	addInstanceTree(HepRepInstanceTree instanceTree) Adds an instancetree to this heprep.
void	addLayer(String layer) Add a layer to the list of layers in this heprep.
void	addTypeTree(HepRepTypeTree typeTree) Add a typetree to this heprep.
String	checkForException() Returns last exception thrown and clears it.
HepRep	copy() Returns a deep copy of the heprep, with all its attached trees, where instances are filtered using a HepRepSelectFilter.
HepRep	copy(HepRepSelectFilter filter) Returns a deep copy of the heprep, with all its attached trees, where instances are filtered using a HepRepSelectFilter.
HepRepInstanceTree	getInstances(String name, String version, String[] typeNames) Returns a named and versioned instancetree for a list of typenames.
HepRepInstanceTree	getInstancesAfterAction(String name, String version, String[] typeNames, HepRepAction[] actions, boolean getPoints, boolean getDrawAtts, boolean getNonDrawAtts, String[] invertAtts) Returns a named and versioned instancetree for a list of typenames after executing some action and for specific filters.
List	getInstanceTreeList() Returns a collection of instancetrees.
Set	getInstanceTrees() Returns a collection of instancetrees.
HepRepInstanceTree	getInstanceTreeTop(String name, String version) Returns a named and versioned instancetree.
List	getLayerOrder() Returns the list of layers.
HepRepTypeTree	getTypeTree(String name, String version) Returns a named and versioned typetree.
List	getTypeTreeList() Returns the collection of all typetrees of this heprep.
Set	getTypeTrees() Returns the collection of all typetrees of this heprep.
void	overlayInstanceTree(HepRepInstanceTree instanceTree) Overlays an instancetree to this heprep, overriding attributes and adding children.
void	removeInstanceTree(HepRepInstanceTree instanceTree) Remove an instanectree from this heprep.
void	removeTypeTree(HepRepTypeTree typeTree) Remove a typetree from this heprep.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HepRepAdapter

public HepRepAdapter(HepRep heprep1)

Method Detail

addLayer

public void addLayer(String layer)

Description copied from interface: HepRep

Add a layer to the list of layers in this heprep. The layer is added to the back of the list.

Specified by:

addLayer in interface HepRep

Parameters:

layer - name of layer to be added to the back of the list.

getLayerOrder

public List getLayerOrder()

Description copied from interface: HepRep

Returns the list of layers.

Specified by:

getLayerOrder in interface HepRep

Returns:

the known layer names, in the order back-to-front.

addTypeTree

public void addTypeTree(HepRepTypeTree typeTree)

Description copied from interface: HepRep

Add a typetree to this heprep.

Specified by:

addTypeTree in interface HepRep

Parameters:

typeTree - to be added.

removeTypeTree

public void removeTypeTree(HepRepTypeTree typeTree)

Description copied from interface: HepRep

Remove a typetree from this heprep.

Specified by:

removeTypeTree in interface HepRep

Parameters:

typeTree - to be removed.

getTypeTrees

public Set getTypeTrees()

Description copied from interface: HepRep

Returns the collection of all typetrees of this heprep.

Specified by:

getTypeTrees in interface HepRep

Returns:

collection of HepRepTypeTrees.

getTypeTreeList

public List getTypeTreeList()

Description copied from interface: HepRep

Returns the collection of all typetrees of this heprep.

Specified by:

getTypeTreeList in interface HepRep

Returns:

collection of HepRepTypeTrees.

getTypeTree

public HepRepTypeTree getTypeTree(String name,
                                  String version)

Description copied from interface: HepRep

Returns a named and versioned typetree.

Specified by:

getTypeTree in interface HepRep

Parameters:

name - name of the typetree.

version - version of the typetree.

Returns:

named and versioned HepRepTypeTree.

addInstanceTree

public void addInstanceTree(HepRepInstanceTree instanceTree)

Description copied from interface: HepRep

Adds an instancetree to this heprep.

Specified by:

addInstanceTree in interface HepRep

overlayInstanceTree

public void overlayInstanceTree(HepRepInstanceTree instanceTree)

Description copied from interface: HepRep

Overlays an instancetree to this heprep, overriding attributes and adding children.

Specified by:

overlayInstanceTree in interface HepRep

Parameters:

instanceTree - to be overlaid.

removeInstanceTree

public void removeInstanceTree(HepRepInstanceTree instanceTree)

Description copied from interface: HepRep

Remove an instanectree from this heprep.

Specified by:

removeInstanceTree in interface HepRep

Parameters:

instanceTree - to be removed.

getInstanceTrees

public Set getInstanceTrees()

Description copied from interface: HepRep

Returns a collection of instancetrees.

Specified by:

getInstanceTrees in interface HepRep

Returns:

collection of HepRepInstanceTrees.

getInstanceTreeList

public List getInstanceTreeList()

Description copied from interface: HepRep

Returns a collection of instancetrees.

Specified by:

getInstanceTreeList in interface HepRep

Returns:

collection of HepRepInstanceTrees.

getInstanceTreeTop

public HepRepInstanceTree getInstanceTreeTop(String name,
                                             String version)

Description copied from interface: HepRep

Returns a named and versioned instancetree. FIXME: doc is incorrect here, should only return TOP of the tree. Filling in should be done by getInstances calls.

This tree needs to be added to the heprep afterwards.

Specified by:

getInstanceTreeTop in interface HepRep

Parameters:

name - name of the instancetree.

version - version of the instancetree.

Returns:

HepRepIntanceTree

getInstances

public HepRepInstanceTree getInstances(String name,
                                       String version,
                                       String[] typeNames)

Description copied from interface: HepRep

Returns a named and versioned instancetree for a list of typenames.

This tree needs to be added to the heprep afterwards.

Specified by:

getInstances in interface HepRep

Parameters:

name - name of the instancetree.

version - version of the instancetree.

typeNames - a list of typenames for which we need instancetrees.

Returns:

HepRepIntanceTree

getInstancesAfterAction

public HepRepInstanceTree getInstancesAfterAction(String name,
                                                  String version,
                                                  String[] typeNames,
                                                  HepRepAction[] actions,
                                                  boolean getPoints,
                                                  boolean getDrawAtts,
                                                  boolean getNonDrawAtts,
                                                  String[] invertAtts)

Description copied from interface: HepRep

Returns a named and versioned instancetree for a list of typenames after executing some action and for specific filters. This tree needs to be added to the heprep afterwards.

The inversion effect of invertAtts depends on the values of GetDrawAtts and GetNonDrawAtts as follows:

• GetDrawAtts GetNonDrawAtts effect of InvertAtts
• FALSE FALSE all Attributes specified will be downloaded
• TRUE FALSE Draw Attributes specified will be omitted, NonDraw Attributes specified will be included
• FALSE TRUE Draw Attributes specified will be included, NonDraw Attributes specified will be omitted
• TRUE TRUE all Attributes specified will be omitted

Specified by:

getInstancesAfterAction in interface HepRep

Parameters:

name - name of the instancetree.

version - version of the instancetree.

typeNames - a list of typenames for which we need instancetrees.

actions - execute this list of actions before returning.

getPoints - include the HepRepPoints in the instance tree.

getDrawAtts - include the Draw attributes in the instance tree.

getNonDrawAtts - include the Non-Draw attributes in the instance tree.

invertAtts - list of attributes to be included or not depending on getDrawAtts and getNonDrawAtts.

Returns:

HepRepIntanceTree

checkForException

public String checkForException()

Description copied from interface: HepRep

Returns last exception thrown and clears it. Useful for implementations without exception handling.

Specified by:

checkForException in interface HepRep

Returns:

last exception and clears it.

copy

public HepRep copy()
            throws CloneNotSupportedException

Description copied from interface: HepRep

Returns a deep copy of the heprep, with all its attached trees, where instances are filtered using a HepRepSelectFilter.

Specified by:

copy in interface HepRep

Returns:

copy of heprep.

Throws:

CloneNotSupportedException - in case copy is not possible

copy

public HepRep copy(HepRepSelectFilter filter)
            throws CloneNotSupportedException

Description copied from interface: HepRep

Returns a deep copy of the heprep, with all its attached trees, where instances are filtered using a HepRepSelectFilter.

Specified by:

copy in interface HepRep

Parameters:

filter - to be used for filtering instances.

Returns:

copy of heprep.

Throws:

CloneNotSupportedException - in case copy is not possible