gov.nasa.worldwind.render

Interface BalloonAttributes

All Superinterfaces:

Exportable, ShapeAttributes

All Known Implementing Classes:

BasicBalloonAttributes

public interface BalloonAttributes
extends ShapeAttributes

Holds attributes for WorldWind Balloon shapes. Changes made to the attributes are applied to the balloon when the WorldWindow renders the next frame. Instances of BalloonAttributes may be shared by many balloons, thereby reducing the memory normally required to store attributes for each balloon.

See Also:

Balloon

Field Summary

Fields inherited from interface gov.nasa.worldwind.Exportable

FORMAT_NOT_SUPPORTED, FORMAT_PARTIALLY_SUPPORTED, FORMAT_SUPPORTED

Method Summary

Modifier and Type	Method and Description
java.lang.String	getBalloonShape() Indicates the shape of the balloon's frame.
int	getCornerRadius() Indicates the radius of each rounded corner on the balloon's rectangular frame, in pixels.
java.awt.Font	getFont() Indicates the font used to display the balloon's text.
java.awt.Point	getImageOffset() Indicates the location of the balloon's texture (in pixels) relative to the balloon's upper left corner.
double	getImageOpacity() Indicates the opacity of the balloon's texture as a floating-point value in the range 0.0 to 1.0.
java.lang.String	getImageRepeat() Indicates the balloon texture's horizontal and vertical repeat mode.
java.awt.Insets	getInsets() Indicates the amount of space between the balloon's content and its frame, in pixels.
java.lang.String	getLeaderShape() Indicates the shape of the balloon's leader.
int	getLeaderWidth() Indicates the width of the balloon's leader, in pixels.
Size	getMaximumSize() Indicates the maximum width and height of the balloon's shape in the viewport.
Offset	getOffset() Indicates the location relative to the balloon's screen reference point at which the balloon's frame shape is aligned.
Size	getSize() Indicates the width and height of the balloon's shape in the viewport.
java.awt.Color	getTextColor() Indicates the color used to display the balloon's text.
void	setBalloonShape(java.lang.String shape) Specifies the shape of the balloon's frame.
void	setCornerRadius(int radius) Specifies the radius of the rounded corner's on the balloon's rectangular frame in pixels.
void	setFont(java.awt.Font font) Specifies the font in which to display the balloon's text.
void	setImageOffset(java.awt.Point offset) Specifies the location of the balloon's texture (in pixels) relative to the balloon's upper left corner.
void	setImageOpacity(double opacity) Specifies the opacity of the balloon's texture as a floating-point value in the range 0.0 to 1.0.
void	setImageRepeat(java.lang.String repeat) Specifies the balloon texture's horizontal and vertical repeat mode.
void	setInsets(java.awt.Insets insets) Specifies the amount of space (in pixels) between the balloon's content and the edges of the balloon's frame.
void	setLeaderShape(java.lang.String shape) Specifies the shape of the balloon's leader.
void	setLeaderWidth(int width) Specifies the width of the balloon's leader, in pixels.
void	setMaximumSize(Size size) Specifies the maximum width and height of the balloon's shape in the viewport.
void	setOffset(Offset offset) Specifies a location relative to the balloon's screen reference point at which to align the balloon's frame shape.
void	setSize(Size size) Specifies the width and height of the balloon's shape in the viewport.
void	setTextColor(java.awt.Color color) Specifies the color in which to display the balloon's text.

Methods inherited from interface gov.nasa.worldwind.render.ShapeAttributes

copy, copy, getImageScale, getImageSource, getInteriorMaterial, getInteriorOpacity, getOutlineMaterial, getOutlineOpacity, getOutlineStippleFactor, getOutlineStipplePattern, getOutlineWidth, getRestorableState, isDrawInterior, isDrawOutline, isEnableAntialiasing, isEnableLighting, isUnresolved, restoreState, setDrawInterior, setDrawOutline, setEnableAntialiasing, setEnableLighting, setImageScale, setImageSource, setInteriorMaterial, setInteriorOpacity, setOutlineMaterial, setOutlineOpacity, setOutlineStippleFactor, setOutlineStipplePattern, setOutlineWidth, setUnresolved

Methods inherited from interface gov.nasa.worldwind.Exportable

export, isExportFormatSupported

Method Detail

getBalloonShape

java.lang.String getBalloonShape()

Indicates the shape of the balloon's frame.

Returns:

the balloon frame's shape, either AVKey.SHAPE_NONE, AVKey.SHAPE_RECTANGLE, or AVKey.SHAPE_ELLIPSE.

See Also:

setBalloonShape(String)

getCornerRadius

int getCornerRadius()

Indicates the radius of each rounded corner on the balloon's rectangular frame, in pixels. The returned value is either zero or a positive integer. If the returned value is zero the balloon's rectangular frame has sharp corners. This value is ignored if the balloon's shape is AVKey.SHAPE_ELLIPSE.

Returns:

the radius of the rounded corner's on the balloon's on the balloon's rectangular frame, in pixels.

See Also:

setCornerRadius(int)

getFont

java.awt.Font getFont()

Indicates the font used to display the balloon's text. This value may be ignored if the balloon's text contains HTML.

Returns:

the balloon's text font.

See Also:

setFont(java.awt.Font)

getImageOffset

java.awt.Point getImageOffset()

Indicates the location of the balloon's texture (in pixels) relative to the balloon's upper left corner.

Returns:

the location of the balloon's texture in pixels.

See Also:

setImageOffset(java.awt.Point)

getImageOpacity

double getImageOpacity()

Indicates the opacity of the balloon's texture as a floating-point value in the range 0.0 to 1.0.

Returns:

the balloon texture's opacity as a floating-point value from 0.0 to 1.0.

See Also:

setImageOpacity(double)

getImageRepeat

java.lang.String getImageRepeat()

Indicates the balloon texture's horizontal and vertical repeat mode.

Returns:

the balloon texture's repeat mode, one of AVKey.REPEAT_NONE, AVKey.REPEAT_X, AVKey.REPEAT_Y, or AVKey.REPEAT_XY

See Also:

setImageRepeat(String)

getInsets

java.awt.Insets getInsets()

Indicates the amount of space between the balloon's content and its frame, in pixels. The balloon's content area decreases to account for the returned space.

Returns:

the padding between the balloon's content and its frame, in pixels.

See Also:

setInsets(java.awt.Insets)

getLeaderShape

java.lang.String getLeaderShape()

Indicates the shape of the balloon's leader.

Returns:

the balloon leader's shape, either AVKey.SHAPE_NONE or AVKey.SHAPE_TRIANGLE.

See Also:

setLeaderShape(String)

getLeaderWidth

int getLeaderWidth()

Indicates the width of the balloon's leader, in pixels. The returned value is either zero or a positive integer.

Returns:

the width of the balloon's leader (in pixels) where it intersects the balloon's frame.

See Also:

setLeaderWidth(int)

getMaximumSize

Size getMaximumSize()

Indicates the maximum width and height of the balloon's shape in the viewport. If the balloon's shape is AVKey.SHAPE_RECTANGLE, then the returned Size indicates the rectangle's maximum width and height. If the balloon's shape is AVKey.SHAPE_ELLIPSE, then the returned Size indicates the ellipse's maximum x- and y-radii. This returns null if the balloon has no maximum size.

Returns:

the maximum width and height of the balloon's shape in the viewport, or null if the balloon has no maximum size.

getOffset

Offset getOffset()

Indicates the location relative to the balloon's screen reference point at which the balloon's frame shape is aligned. The balloon's lower left corner begins at the returned offset.

Returns:

the location at which the balloon's lower left corner is aligned.

See Also:

setOffset(Offset)

getSize

Size getSize()

Indicates the width and height of the balloon's shape in the viewport. If the balloon's shape is AVKey.SHAPE_RECTANGLE, then the returned Size indicates the rectangle's width and height. If the balloon's shape is AVKey.SHAPE_ELLIPSE, then the returned Size indicates the ellipse's x- and y-radii.

Returns:

the width and height of the balloon's shape in the viewport

getTextColor

java.awt.Color getTextColor()

Indicates the color used to display the balloon's text. This value may be ignored if the balloon's text contains HTML.

Returns:

the balloon's text color.

See Also:

setTextColor(java.awt.Color)

setBalloonShape

void setBalloonShape(java.lang.String shape)

Specifies the shape of the balloon's frame. The shape may be one of the following:

• AVKey.SHAPE_NONE
• AVKey.SHAPE_RECTANGLE
• AVKey.SHAPE_ELLIPSE

If the shape is AVKey.SHAPE_NONE, the balloon's content is displayed in a rectangle in the viewport without any decoration. The rectangle's dimension in the viewport are specified by calling setSize(Size).

If the shape is AVKey.SHAPE_RECTANGLE, the balloon is displayed as a rectangle in the viewport with optionally rounded corners. The rectangle's dimension in the viewport are specified by calling setSize(Size). The rectangle's corner radius in pixels is specified by calling setCornerRadius(int).

If the shape is AVKey.SHAPE_ELLIPSE, the balloon is displayed as an ellipse in the viewport. The ellipse's x- and y-radii are specified by calling setSize(Size). The balloon's corner radius attribute is ignored.

Parameters:

shape - the frame shape to use, either AVKey.SHAPE_NONE AVKey.SHAPE_RECTANGLE or AVKey.SHAPE_ELLIPSE.

Throws:

java.lang.IllegalArgumentException - if shape is null.

See Also:

getBalloonShape()

setCornerRadius

void setCornerRadius(int radius)

Specifies the radius of the rounded corner's on the balloon's rectangular frame in pixels. The specified radius must be zero or a positive integer. Specifying a radius of zero causes the shape's rectangular frame to have sharp corners. This does nothing if the balloon's shape is AVKey.SHAPE_ELLIPSE.

Parameters:

radius - the desired radius, in pixels.

Throws:

java.lang.IllegalArgumentException - if radius is less than zero.

See Also:

getCornerRadius()

setFont

void setFont(java.awt.Font font)

Specifies the font in which to display the balloon's text. The specified font may be ignored if the balloon's text contains HTML.

Parameters:

font - the font to use for the balloon's text.

Throws:

java.lang.IllegalArgumentException - if font is null.

See Also:

getFont()

setImageOffset

void setImageOffset(java.awt.Point offset)

Specifies the location of the balloon's texture (in pixels) relative to the balloon's upper left corner. The location is applied to the balloon's texture before the balloon's texture scale is applied.

Parameters:

offset - the location of the balloon's texture source in pixels.

Throws:

java.lang.IllegalArgumentException - if offset is null.

See Also:

getImageOffset()

setImageOpacity

void setImageOpacity(double opacity)

Specifies the opacity of the balloon's texture as a floating-point value in the range 0.0 to 1.0. The specified opacity is multiplied by the shape's interior opacity to determine the texture's final opacity. A value of 1.0 specifies a completely opaque texture, and 0.0 specifies a completely transparent texture. Values in between specify a partially transparent texture.

Parameters:

opacity - the balloon texture's opacity as a floating-point value from 0.0 to 1.0.

Throws:

java.lang.IllegalArgumentException - if opacity is less than 0.0 or greater than 1.0.

See Also:

getImageOpacity()

setImageRepeat

void setImageRepeat(java.lang.String repeat)

Specifies the balloon texture's horizontal and vertical repeat mode. The repeat may be one of the following:

• AVKey.REPEAT_NONE
• AVKey.REPEAT_X
• AVKey.REPEAT_Y
• AVKey.REPEAT_XY

If repeat is AVKey.REPEAT_NONE, the balloon's texture is displayed according to its offset and scale without any repeating pattern.

If repeat is AVKey.REPEAT_X, AVKey.REPEAT_Y, or AVKey.REPEAT_XY, the balloon's texture is repeated along the X axis, along the Y axis, or along both the X and Y axes, respectively. The texture is repeated after its offset and scale are applied.

Parameters:

repeat - the texture's repeat mode to use, one of AVKey.REPEAT_NONE, AVKey.REPEAT_X, AVKey.REPEAT_Y, or AVKey.REPEAT_XY.

Throws:

java.lang.IllegalArgumentException - if repeat is null.

See Also:

getImageRepeat()

setInsets

void setInsets(java.awt.Insets insets)

Specifies the amount of space (in pixels) between the balloon's content and the edges of the balloon's frame. The balloon's content area decreases to account for the specified insets. If the balloon's size and insets cause the content width or height to become less than 1, then the balloon's content is not displayed.

If the balloon's shape is AVKey.SHAPE_RECTANGLE, insets specifies the padding between the balloon's content area and the rectangle's top, left, bottom, and right.

If the balloon's shape is AVKey.SHAPE_ELLIPSE, insets specifies the padding between the balloon's content area and the ellipse's top, left, bottom, and right apexes.

Parameters:

insets - the desired padding between the balloon's content and its frame, in pixels.

Throws:

java.lang.IllegalArgumentException - if insets is null.

See Also:

getInsets()

setLeaderShape

void setLeaderShape(java.lang.String shape)

Specifies the shape of the balloon's leader. The shape may be one of the following:

• AVKey.SHAPE_NONE
• AVKey.SHAPE_TRIANGLE

If the shape is AVKey.SHAPE_NONE, the leader is disabled and does not display.

If the shape is AVKey.SHAPE_TRIANGLE, the leader extends from one side of the balloon's frame and points to the balloon's screen reference point. The width of the leader (in pixels) where it intersects the balloon's frame is specified by calling setLeaderWidth(int).

Parameters:

shape - the leader shape to use, either AVKey.SHAPE_NONE or AVKey.SHAPE_TRIANGLE.

Throws:

java.lang.IllegalArgumentException - if shape is null.

See Also:

getLeaderShape(), setLeaderWidth(int)

setLeaderWidth

void setLeaderWidth(int width)

Specifies the width of the balloon's leader, in pixels. The specified width must be zero or a positive integer. Specifying a width of zero disables the balloon's leader.

This does nothing if the balloon's leader shape is AVKey.SHAPE_NONE.

If the balloon's leader shape is AVKey.SHAPE_TRIANGLE, this specifies the size of the leader where it intersects the balloon's frame.

Parameters:

width - the desired leader width, in pixels.

Throws:

java.lang.IllegalArgumentException - if width is less than zero.

See Also:

getLeaderWidth()

setMaximumSize

void setMaximumSize(Size size)

Specifies the maximum width and height of the balloon's shape in the viewport. If the balloon's shape is AVKey.SHAPE_RECTANGLE, then size specifies the rectangle's maximum width and height. If the balloon's shape is AVKey.SHAPE_ELLIPSE, then size specifies the ellipse's maximum x- and y-radii. Specifying a null size causes the balloon to have no maximum size.

Parameters:

size - the desired maximum width and height of the balloon's shape in the viewport, or null if the balloon should have no maximum size.

setOffset

void setOffset(Offset offset)

Specifies a location relative to the balloon's screen reference point at which to align the balloon's frame shape. The balloon's frame shape begins at the point indicated by the offset. An offset of (0, 0) pixels causes the balloon's lower left corner to be placed at the screen reference point. An offset of (1, 1) in fraction units causes the balloon's upper right corner to be placed at the screen reference point.

If the balloon is attached to the globe, the screen reference point is the projection of its geographic position into the viewport. If the balloon is attached to the screen, the screen reference point is the balloon's screen point.

If the balloon has a leader shape, the leader extends from one side of the balloon's frame and points to the screen reference point.

Parameters:

offset - a location at which to align the balloon's lower left corner.

Throws:

java.lang.IllegalArgumentException - if offset is null.

See Also:

getOffset()

setSize

void setSize(Size size)

Specifies the width and height of the balloon's shape in the viewport. If the balloon's shape is AVKey.SHAPE_RECTANGLE, then size specifies the rectangle's width and height. If the balloon's shape is AVKey.SHAPE_ELLIPSE, then size specifies the ellipse's x- and y-radii.

The balloon's content area is the rectangle obtained by taking the balloon's size and shrinking it by the balloon's insets.

Parameters:

size - the desired width and height of the balloon's shape in the viewport.

Throws:

java.lang.IllegalArgumentException - if size is null.

See Also:

getSize(), getMaximumSize(), setInsets(java.awt.Insets)

setTextColor

void setTextColor(java.awt.Color color)

Specifies the color in which to display the balloon's text. The specified color may be ignored if the balloon's text contains HTML.

Parameters:

color - the color to use for the balloon's text.

Throws:

java.lang.IllegalArgumentException - if color is null.

See Also:

getTextColor()