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()
Elementpublic CharSequence getLabel(String key)
Elementpublic <T> T getAttribute(String key)
ElementgetAttribute in interface Elementkey - Name of the attribute to search.public <T> T getAttribute(String key, Class<T> clazz)
ElementgetAttribute in interface Elementkey - The attribute name to search.clazz - The expected attribute class.public int getAttributeCount()
getAttributeCount in interface Elementpublic Iterator<String> getAttributeKeyIterator()
ElementgetAttributeKeyIterator in interface Elementpublic Iterable<String> getEachAttributeKey()
ElementgetEachAttributeKey in interface Elementpublic Collection<String> getAttributeKeySet()
ElementgetAttributeKeySet in interface Elementpublic <T> T getFirstAttributeOf(String... keys)
ElementElement.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 Elementkeys - Several strings naming attributes.public <T> T getFirstAttributeOf(Class<T> clazz, String... keys)
ElementElement.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 Elementclazz - The class the attribute must be instance of.keys - Several string naming attributes.public Object[] getArray(String key)
Elementpublic HashMap<?,?> getHash(String key)
ElementCompoundAttribute 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)
Elementpublic ArrayList<? extends Number> getVector(String key)
Elementpublic boolean hasAttribute(String key)
ElementhasAttribute in interface Elementkey - The name of the attribute to search.public boolean hasArray(String key)
Elementpublic boolean hasAttribute(String key, Class<?> clazz)
ElementhasAttribute in interface Elementkey - The name of the attribute to search.clazz - The expected class of the attribute value.public boolean hasHash(String key)
ElementCompoundAttribute class.public boolean hasLabel(String key)
Elementpublic boolean hasNumber(String key)
Elementpublic boolean hasVector(String key)
Elementpublic void addAttribute(String attribute, Object... values)
ElementaddAttribute in interface Elementattribute - The attribute name.values - The attribute value or set of values.public void addAttributes(Map<String,Object> attributes)
ElementaddAttributes in interface Elementattributes - A set of (key,value) pairs.public void setAttribute(String attribute, Object... values)
ElementElement.addAttribute(String, Object...) but for consistency.setAttribute in interface Elementattribute - The attribute name.values - The attribute value or array of values.Element.addAttribute(String, Object...)public void changeAttribute(String attribute, Object... values)
ElementElement.addAttribute(String, Object...) but for consistency.changeAttribute in interface Elementattribute - The attribute name.values - The attribute value or array of values.Element.addAttribute(String, Object...)public void clearAttributes()
ElementclearAttributes in interface Elementpublic void removeAttribute(String attribute)
ElementremoveAttribute in interface Elementattribute - Name of the attribute to remove.Copyright © 2015. All rights reserved.