public class Sprite extends Object implements Element
Sprite objects allow to add data representations in a graphic display of a graph. A sprite is a graphical representation that can double anywhere in the graph drawing surface, or be "attached" to nodes or edges. When attached to an edge, a sprite can be positioned easily at any point along the edge, or perpendicular to it with one or two coordinates. When attached to a node, a sprite "orbits" around the node at any given radius and angle around it.
Sprites can have many shapes. Most of the CSS nodes shapes are available for sprites, but more are possible. Some shapes follow the form of the element (node or edge) they are attached to.
Sprites can be moved and animated easily along edges, around nodes, or anywhere on the graph surface. Their shape can change. Some sprites allows to draw pie charts or statistics, or images.
Sprites are not part of a graph so to speak. Furthermore they make sense only
when a graph is displayed with a viewer that supports sprites. Therefore they
are handled by a SpriteManager
which is always associated to a graph
and is in charge of handling the whole set of sprites, creating them,
enumerating them, and destroying them.
Implementation note: sprites do not exist ! In fact the sprite class only handles a set of attributes that are stored in the graph (the one associated with the sprite manager that created the sprite). These special attributes are handled for you by the sprite class. This technique allows to pass sprites informations through the I/O system of GraphStream. Indeed sprites appearing in a graph can therefore be stored in files and retrieved if the graph file format supports attributes. If this is a dynamic graph format, like DGS, the whole sprite history is remembered: when it moved, when it changed, etc.
Second implementation node : often you will need to extend the sprite class.
This is easily possible, but you must remember that you cannot create sprites
yourself, you must use the SpriteManager
. In order to create a sprite
of a special kind, you can either use a SpriteFactory
with the
SpriteManager or the special SpriteManager.addSprite(String, Class)
method of the SpriteManager. In both cases, the
init(String, SpriteManager, Values)
method of the sprite will be
called. Override this method to initialise your sprite.
SpriteManager
,
SpriteFactory
Modifier and Type | Method and Description |
---|---|
void |
addAttribute(String attribute,
Object... values)
Add or replace the value of an attribute.
|
void |
addAttributes(Map<String,Object> attributes)
Add or replace each attribute found in attributes.
|
boolean |
attached()
True if attached to an edge or node.
|
void |
attachToEdge(String id)
Attach the sprite to an edge with the given identifier.
|
void |
attachToNode(String id)
Attach the sprite to a node with the given identifier.
|
void |
changeAttribute(String attribute,
Object... values)
Like
Element.addAttribute(String, Object...) but for consistency. |
void |
clearAttributes()
Remove all registered attributes.
|
void |
detach()
Detach the sprite from the element it is attached to (if any).
|
Object[] |
getArray(String key)
Get the array of objects bound to key.
|
Element |
getAttachment()
The element the sprite is attached to or null if the sprite is not
attached.
|
<T> T |
getAttribute(String key)
Get the attribute object bound to the given key.
|
<T> T |
getAttribute(String key,
Class<T> clazz)
Get the attribute object bound to the given key if it is an instance of
the given class.
|
int |
getAttributeCount()
Quite expensive operation !.
|
Iterator<String> |
getAttributeKeyIterator()
Iterator on all attributes keys.
|
Collection<String> |
getAttributeKeySet()
An unmodifiable view on the set of attribute keys.
|
Map<String,Object> |
getAttributeMap() |
Iterable<String> |
getEachAttributeKey()
An iterable view on the set of attribute keys usable within a for-each
loop.
|
<T> T |
getFirstAttributeOf(Class<T> clazz,
String... keys)
Like
Element.getAttribute(String, Class) , but returns the first existing
attribute in a list of keys, instead of only one key. |
<T> T |
getFirstAttributeOf(String... keys)
Like
Element.getAttribute(String) , but returns the first existing
attribute in a list of keys, instead of only one key. |
HashMap<?,?> |
getHash(String key)
Get the hash bound to key.
|
String |
getId()
Unique identifier of this element.
|
int |
getIndex()
The current index of this element
|
CharSequence |
getLabel(String key)
Get the label string bound to the given key key.
|
double |
getNumber(String key)
Get the number bound to key.
|
StyleConstants.Units |
getUnits() |
ArrayList<? extends Number> |
getVector(String key)
Get the vector of number bound to key.
|
double |
getX()
X position.
|
double |
getY()
Y position.
|
double |
getZ()
Z position.
|
boolean |
hasArray(String key)
Does this element store an array value for the given key?
|
boolean |
hasAttribute(String key)
Does this element store a value for the given attribute key?
|
boolean |
hasAttribute(String key,
Class<?> clazz)
Does this element store a value for the given attribute key and this
value is an instance of the given class?
|
boolean |
hasHash(String key)
Does this element store a hash value for the given key?
|
boolean |
hasLabel(String key)
Does this element store a label value for the given key?
|
boolean |
hasNumber(String key)
Does this element store a number for the given key?
|
boolean |
hasVector(String key)
Does this element store a vector value for the given key?
|
void |
removeAttribute(String attribute)
Remove an attribute.
|
void |
setAttribute(String attribute,
Object... values)
Like
Element.addAttribute(String, Object...) but for consistency. |
void |
setPosition(double percent) |
void |
setPosition(double x,
double y,
double z) |
void |
setPosition(StyleConstants.Units units,
double x,
double y,
double z) |
public Element getAttachment()
public boolean attached()
public double getX()
public double getY()
public double getZ()
public StyleConstants.Units getUnits()
public void attachToNode(String id)
id
- Identifier of the node to attach to.public void attachToEdge(String id)
id
- Identifier of the edge to attach to.public void detach()
public void setPosition(double percent)
public void setPosition(double x, double y, double z)
public void setPosition(StyleConstants.Units units, double x, double y, double z)
public String getId()
Element
public CharSequence getLabel(String key)
Element
public <T> T getAttribute(String key)
Element
getAttribute
in interface Element
key
- Name of the attribute to search.public <T> T getAttribute(String key, Class<T> clazz)
Element
getAttribute
in interface Element
key
- The attribute name to search.clazz
- The expected attribute class.public int getAttributeCount()
getAttributeCount
in interface Element
public Iterator<String> getAttributeKeyIterator()
Element
getAttributeKeyIterator
in interface Element
public Iterable<String> getEachAttributeKey()
Element
getEachAttributeKey
in interface Element
public Collection<String> getAttributeKeySet()
Element
getAttributeKeySet
in interface Element
public <T> T getFirstAttributeOf(String... keys)
Element
Element.getAttribute(String)
, but returns the first existing
attribute in a list of keys, instead of only one key. The key list order
matters.getFirstAttributeOf
in interface Element
keys
- Several strings naming attributes.public <T> T getFirstAttributeOf(Class<T> clazz, String... keys)
Element
Element.getAttribute(String, Class)
, but returns the first existing
attribute in a list of keys, instead of only one key. The key list order
matters.getFirstAttributeOf
in interface Element
clazz
- The class the attribute must be instance of.keys
- Several string naming attributes.public Object[] getArray(String key)
Element
public HashMap<?,?> getHash(String key)
Element
CompoundAttribute
interface are considered like hashes since they
can be transformed to a hash. If an attribute with the same name exists
but is not a hash, null is returned. We cannot enforce the type of the
key. It is considered a string and you should use "Object.toString()" to
get it.public double getNumber(String key)
Element
public ArrayList<? extends Number> getVector(String key)
Element
public boolean hasAttribute(String key)
Element
hasAttribute
in interface Element
key
- The name of the attribute to search.public boolean hasArray(String key)
Element
public boolean hasAttribute(String key, Class<?> clazz)
Element
hasAttribute
in interface Element
key
- The name of the attribute to search.clazz
- The expected class of the attribute value.public boolean hasHash(String key)
Element
CompoundAttribute
class.public boolean hasLabel(String key)
Element
public boolean hasNumber(String key)
Element
public boolean hasVector(String key)
Element
public void addAttribute(String attribute, Object... values)
Element
addAttribute
in interface Element
attribute
- The attribute name.values
- The attribute value or set of values.public void addAttributes(Map<String,Object> attributes)
Element
addAttributes
in interface Element
attributes
- A set of (key,value) pairs.public void setAttribute(String attribute, Object... values)
Element
Element.addAttribute(String, Object...)
but for consistency.setAttribute
in interface Element
attribute
- The attribute name.values
- The attribute value or array of values.Element.addAttribute(String, Object...)
public void changeAttribute(String attribute, Object... values)
Element
Element.addAttribute(String, Object...)
but for consistency.changeAttribute
in interface Element
attribute
- The attribute name.values
- The attribute value or array of values.Element.addAttribute(String, Object...)
public void clearAttributes()
Element
clearAttributes
in interface Element
public void removeAttribute(String attribute)
Element
removeAttribute
in interface Element
attribute
- Name of the attribute to remove.Copyright © 2015. All rights reserved.