Package sec.web.render

Class Shape3DHandler

java.lang.Object

sec.web.render.Shape3DHandler

public class Shape3DHandler
extends Object

Responsible for generating the KML for all 3D shapes. This

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ATTRIBUTES
static final String	CAKE
static final String	CYLINDER
static final String	DEFAULT_ATTRIBUTES
static final String	ERR_ATTRIBUTES_NOT_FORMATTED
static final String	ERR_COORDINATES_NOT_FORMATTED
static final String	ERR_GENERAL_ERROR
static final String	ERR_INVALID_NUMBER_POINTS_ERROR
static final String	LEFT_AZIMUTH
static final double	LEFT_AZIMUTH_DEFAULT
static final String	MAX_ALT
static final double	MAX_ALT_DEFAULT
static final String	MIN_ALT
static final double	MIN_ALT_DEFAULT
static final String	ORBIT
static final String	POLYARC
static final String	POLYGON
static final String	RADARC
static final String	RADIUS1
static final double	RADIUS1_DEFAULT
static final String	RADIUS2
static final double	RADIUS2_DEFAULT
static final String	RIGHT_AZIMUTH
static final double	RIGHT_AZIMUTH_DEFAULT
static final String	ROUTE
static final String	TRACK

Constructor Summary

Constructors

Constructor	Description
Shape3DHandler()

Method Summary

Modifier and Type	Method	Description
static String	buildCake(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds a cake graphic--multiple radarcs stacked on top of each other.
static String	buildCylinder(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds a cylinder given a point.
static String	buildKml(String[] coords, String id, String name, String lineColor, String fillColor)
static String	buildOrbit(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Build an Orbit graphic.
static String	buildPolyArc(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds the PolyArc graphic
static String	buildPolygon(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds a 3d Polygon with elevation.
static String	buildRadarc(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds the Radarc graphic
static String	buildRoute(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds a route graphic.
static String	buildTrack(String controlPoints, String id, String name, String description, String lineColor, String fillColor, KmlOptions.AltitudeMode altitudeMode, SymbolModifiers attributes)	Builds a track graphic composed of multiple routes
static String	render3dSymbol(String name, String id, String shapeType, String description, String lineColor, String fillColor, String altitudeMode, String controlPoints, SymbolModifiers attributes)	Generates the KML for a 3D symbol.

Methods inherited from class java.lang.Object

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

Field Details

CYLINDER

public static final String CYLINDER

See Also:

• Constant Field Values

ORBIT

public static final String ORBIT

See Also:

• Constant Field Values

ROUTE

public static final String ROUTE

See Also:

• Constant Field Values

POLYGON

public static final String POLYGON

See Also:

• Constant Field Values

RADARC

public static final String RADARC

See Also:

• Constant Field Values

POLYARC

public static final String POLYARC

See Also:

• Constant Field Values

CAKE

public static final String CAKE

See Also:

• Constant Field Values

TRACK

public static final String TRACK

See Also:

• Constant Field Values

ATTRIBUTES

public static final String ATTRIBUTES

See Also:

• Constant Field Values

MIN_ALT

public static final String MIN_ALT

See Also:

• Constant Field Values

MAX_ALT

public static final String MAX_ALT

See Also:

• Constant Field Values

RADIUS1

public static final String RADIUS1

See Also:

• Constant Field Values

RADIUS2

public static final String RADIUS2

See Also:

• Constant Field Values

LEFT_AZIMUTH

public static final String LEFT_AZIMUTH

See Also:

• Constant Field Values

RIGHT_AZIMUTH

public static final String RIGHT_AZIMUTH

See Also:

• Constant Field Values

MIN_ALT_DEFAULT

public static final double MIN_ALT_DEFAULT

See Also:

• Constant Field Values

MAX_ALT_DEFAULT

public static final double MAX_ALT_DEFAULT

See Also:

• Constant Field Values

RADIUS1_DEFAULT

public static final double RADIUS1_DEFAULT

See Also:

• Constant Field Values

RADIUS2_DEFAULT

public static final double RADIUS2_DEFAULT

See Also:

• Constant Field Values

LEFT_AZIMUTH_DEFAULT

public static final double LEFT_AZIMUTH_DEFAULT

See Also:

• Constant Field Values

RIGHT_AZIMUTH_DEFAULT

public static final double RIGHT_AZIMUTH_DEFAULT

See Also:

• Constant Field Values

DEFAULT_ATTRIBUTES

public static final String DEFAULT_ATTRIBUTES

See Also:

• Constant Field Values

ERR_ATTRIBUTES_NOT_FORMATTED

public static final String ERR_ATTRIBUTES_NOT_FORMATTED

See Also:

• Constant Field Values

ERR_COORDINATES_NOT_FORMATTED

public static final String ERR_COORDINATES_NOT_FORMATTED

See Also:

• Constant Field Values

ERR_GENERAL_ERROR

public static final String ERR_GENERAL_ERROR

See Also:

• Constant Field Values

ERR_INVALID_NUMBER_POINTS_ERROR

public static final String ERR_INVALID_NUMBER_POINTS_ERROR

See Also:

• Constant Field Values

Constructor Details

Shape3DHandler

public Shape3DHandler()

Method Details

render3dSymbol

public static String render3dSymbol(String name,
 String id,
 String shapeType,
 String description,
 String lineColor,
 String fillColor,
 String altitudeMode,
 String controlPoints,
 SymbolModifiers attributes)

Generates the KML for a 3D symbol. Symbol should include the all the attributes and information required by the KML for output.

Parameters:

name - The user displayed name for the symbol. Users will use this to identify with the symbol.

id - An internally used unique id that developers can use to uniquely distinguish this symbol from others.

shapeType - A 15 character ID of the type of symbol to draw.

description - A brief description of what the symbol represents. Generic text that does not require any format.

color - The fill color of the graphic

altitudeMode - Indicates whether the symbol should interpret altitudes as above sea level or above ground level. Options are "relativeToGround" (from surface of earth), "absolute" (sea level), "relativeToSeaFloor" (from the bottom of major bodies of water).

controlPoints - The vertices of the shape. The number of required vertices varies based on the shapeType of the symbol. The simplest shape requires at least one point. Shapes that require more points than required will ignore extra points. Format for numbers is as follows:

"x,y,z [x,y,z ]..."

attributes - A JSON A JSON array holding the parameters for the shape. Attributes should be of the following format:

{"attributes":[{"attribute1":value,...},{[optional]]}

Returns:

A KML string that represents a placemark for the 3D shape

buildPolygon

public static String buildPolygon(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds a 3d Polygon with elevation.

Parameters:

controlPoints -

attributes -

Returns:

buildCylinder

public static String buildCylinder(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds a cylinder given a point. Can also apply a radius size and an altitude for lower and upper boundaries.

Parameters:

controlPoints -

attributes -

Returns:

buildKml

public static String buildKml(String[] coords,
 String id,
 String name,
 String lineColor,
 String fillColor)

buildOrbit

public static String buildOrbit(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Build an Orbit graphic.

Parameters:

controlPoints -

attributes -

Returns:

buildRadarc

public static String buildRadarc(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds the Radarc graphic

Parameters:

controlPoints -

attributes -

Returns:

buildPolyArc

public static String buildPolyArc(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds the PolyArc graphic

Parameters:

controlPoints -

attributes -

Returns:

buildRoute

public static String buildRoute(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds a route graphic.

Parameters:

controlPoints -

attributes -

Returns:

buildCake

public static String buildCake(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds a cake graphic--multiple radarcs stacked on top of each other.
This graphic can take up to 6 attributes. "radius1" is the max radius, "radius2" is the min radius, "minalt", "maxalt", "leftAzimuth", and "rightAzimuth"

Parameters:

controlPoints -

attributes -

Returns:

buildTrack

public static String buildTrack(String controlPoints,
 String id,
 String name,
 String description,
 String lineColor,
 String fillColor,
 KmlOptions.AltitudeMode altitudeMode,
 SymbolModifiers attributes)

Builds a track graphic composed of multiple routes

Parameters:

controlPoints -

attributes -

Returns: