|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A Graphic is a "graphical symbol" with an inherent shape, color(s), and possibly size.
A "graphic" can very informally be defined as "a little picture" and can be
of either a raster or vector graphic source type. The term graphic is used
since the term "symbol" is similar to "symbolizer" which is used in a
difference context in SLD. The graphical symbol to display can be provided
either as an external graphical resource or as a Mark.
Multiple external URLs and marks can be referenced with the proviso that
they all provide equivalent graphics in different formats. The 'hot spot'
to use for positioning the rendering at a point must either be inherent
from the external format or be defined to be the "central point" of the
graphic.
The details of this object are taken from the OGC Styled-Layer Descriptor Report (OGC 02-070) version 1.0.0.:
<xsd:element name="Graphic">
<xsd:annotation>
<xsd:documentation>
A "Graphic" specifies or refers to a "graphic symbol" with inherent
shape, size, and coloring.
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:choice minOccurs="0" maxOccurs="unbounded">
<xsd:element ref="sld:ExternalGraphic"/>
<xsd:element ref="sld:Mark"/>
</xsd:choice>
<xsd:sequence>
<xsd:element ref="sld:Opacity" minOccurs="0"/>
<xsd:element ref="sld:Size" minOccurs="0"/>
<xsd:element ref="sld:Rotation" minOccurs="0"/>
</xsd:sequence>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Renderers can ue this information when displaying styled features, though it must be remembered that not all renderers will be able to fully represent strokes as set out by this interface. For example, opacity may not be supported.
Notes:
Field Summary | |
static Graphic |
DEFAULT
A default Graphic instance. |
static Graphic |
NULL
Indicates an absense of graphic. |
Method Summary | |
void |
accept(StyleVisitor visitor)
accepts a StyleVisitor - used by xmlencoder and other packages which need to walk the style tree |
void |
addExternalGraphic(ExternalGraphic externalGraphic)
|
void |
addMark(Mark mark)
|
void |
addSymbol(Symbol symbol)
|
Displacement |
getDisplacement()
|
ExternalGraphic[] |
getExternalGraphics()
Provides a list of external graphics which can be used to represent this graphic. |
java.lang.String |
getGeometryPropertyName()
Getter for property geometryPropertyName. |
Mark[] |
getMarks()
Provides a list of suitable marks which can be used to represent this graphic. |
Expression |
getOpacity()
This specifies the level of translucency to use when rendering the graphic. |
Expression |
getRotation()
This parameter defines the rotation of a graphic in the clockwise direction about its centre point in decimal degrees. |
Expression |
getSize()
This paramteter gives the absolute size of the graphic in pixels encoded as a floating point number. |
Symbol[] |
getSymbols()
Provides a list of all the symbols which can be used to represent this graphic. |
void |
setDisplacement(Displacement offset)
|
void |
setExternalGraphics(ExternalGraphic[] externalGraphics)
|
void |
setGeometryPropertyName(java.lang.String geometryPropertyName)
Setter for property geometryPropertyName. |
void |
setMarks(Mark[] marks)
|
void |
setOpacity(Expression opacity)
|
void |
setRotation(Expression rotation)
|
void |
setSize(Expression size)
|
void |
setSymbols(Symbol[] symbols)
|
Methods inherited from interface org.geotools.event.GTComponent |
changed, getNote, getParent, removed, setNote |
Field Detail |
public static final Graphic DEFAULT
For some attributes the standard does not define a default, so a reasonable value is supplied.
public static final Graphic NULL
This value is used to indicate that the Graphics based opperation should be skipped. Aka this is used by Stroke.Stroke as place holders for GRAPHIC_FILL and GRAPHIC_STROKE.
Method Detail |
public ExternalGraphic[] getExternalGraphics()
public void setExternalGraphics(ExternalGraphic[] externalGraphics)
public void addExternalGraphic(ExternalGraphic externalGraphic)
public Mark[] getMarks()
public void setMarks(Mark[] marks)
public void addMark(Mark mark)
public Symbol[] getSymbols()
public void setSymbols(Symbol[] symbols)
public void addSymbol(Symbol symbol)
public Expression getOpacity()
public void setOpacity(Expression opacity)
public Expression getSize()
The default size of an image format (such as GIFD) is the inherent size of the image. The default size of a format without an inherent size (such as SVG) is defined to be 16 pixels in height and the corresponding aspect in width. If a size is specified, the height of the graphic will be scaled to that size and the corresponding aspect will be used for the width.
public void setSize(Expression size)
public Displacement getDisplacement()
public void setDisplacement(Displacement offset)
public Expression getRotation()
public void setRotation(Expression rotation)
public java.lang.String getGeometryPropertyName()
public void setGeometryPropertyName(java.lang.String geometryPropertyName)
geometryPropertyName
- New value of property geometryPropertyName.public void accept(StyleVisitor visitor)
visitor
- - the visitor object
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |