Constructor
new KmlScreenOverlay(options)
Constructs an KmlScreenOverlay. Applications usually don't call this constructor. It is called by KmlFile as objects from Kml file are read. This object is already concrete implementation.
Parameters:
Name | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
options |
Object |
Properties
|
- Source:
- See:
Throws:
-
If the node is null or undefined.
- Type
- ArgumentError
Extends
Members
displayName :String
The display name of the renderable.
Type:
- String
- Inherited From:
- Default Value:
- "Renderable"
- Source:
enabled :Boolean
Indicates whether to display this renderable.
Type:
- Boolean
- Inherited From:
- Default Value:
- true
- Source:
(readonly) id :String
Every object, which is part of the KML document has its identity. We will use it for changes in the
document for binding.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlAbstractView :KmlAbstractView
It represents one of the AbstractViews associated with current Feature. Specific implementation of
AbstractView will be returned.
Type:
- Inherited From:
- Source:
(readonly) kmlAddress :String
It represents unstructured address associated with the Feature.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlColor :String
Color values are expressed in hexadecimal notation, including opacity (alpha) values. The order of
expression is alpha, blue, green, red (aabbggrr). The range of values for any one color is 0 to 255 (00
to ff). For opacity, 00 is fully transparent and ff is fully opaque. For example, if you want to apply a
blue color with
50 percent opacity to an overlay, you would specify the following: <color>7fff0000</color>
Type:
- String
- Inherited From:
- Source:
(readonly) kmlDescription :String
It represents description of this feature. It can be displayed as a part of the feature.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlDrawOrder :Number
This element defines the stacking order for the images in overlapping overlays. Overlays with higher
<drawOrder> values are drawn on top of overlays with lower <drawOrder> values.
Type:
- Number
- Inherited From:
- Source:
(readonly) kmlIcon :KmlIcon
Defines the image associated with the Overlay. The <href> element defines the location of the image to
be
used as the Overlay. This location can be either on a local file system or on a web server. If this
element is omitted or contains no <href>, a rectangle is drawn using the color and size defined by the
ground or screen overlay.
Type:
- Inherited From:
- Source:
(readonly) kmlName :String
Name of this feature. Every feature should have name.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlOpen :Boolean
It is applied only to Document, Folder and NetworkLink and represents whether they should be rendered
collapsed or expanded.
Type:
- Boolean
- Inherited From:
- Source:
(readonly) kmlOverlayXYx :String
Either the number of pixels, a fractional component of the image, or a pixel inset indicating the x
component of a point on the overlay image.
Type:
- String
(readonly) kmlOverlayXYxunits :String
Units in which the x value is specified. A value of "fraction" indicates the x value is a fraction of the
image. A value of "pixels" indicates the x value in pixels. A value of "insetPixels" indicates the indent
from the right edge of the image.
Type:
- String
(readonly) kmlOverlayXYy :String
Either the number of pixels, a fractional component of the image, or a pixel inset indicating the y
component of a point on the overlay image.
Type:
- String
(readonly) kmlOverlayXYyunits :String
Units in which the y value is specified. A value of "fraction" indicates the y value is a fraction of the
image. A value of "pixels" indicates the y value in pixels. A value of "insetPixels" indicates the indent
from the top edge of the image.
Type:
- String
(readonly) kmlPhoneNumber :String
It represents phone number associated with current feature. Quite probably irrelevant information.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlRegion :KmlRegion
Features and geometry associated with a Region are drawn only when the Region is active. See
<Region>.
Type:
- Inherited From:
- Source:
(readonly) kmlRotation :Number
Indicates the angle of rotation of the parent object. A value of 0 means no rotation. The value is an
angle in degrees counterclockwise starting from north. Use +-180 to indicate the rotation of the parent
object from
0. The center of the <rotation>, if not (.5,.5), is specified in <rotationXY>.
Type:
- Number
(readonly) kmlRotationXYx :String
It decides by how much will be the screen overlay rotated in x direction
Type:
- String
(readonly) kmlRotationXYxunits :String
Units in which the x value is specified. A value of "fraction" indicates the x value is a fraction of
the
screen. A value of "pixels" indicates the x value in pixels. A value of "insetPixels" indicates the
indent from the right edge of the screen.
Type:
- String
(readonly) kmlRotationXYy :String
It decides by how much will be the screen overlay rotated in y direction
Type:
- String
(readonly) kmlRotationXYyunits :String
Units in which the y value is specified. A value of fraction indicates the y value is a fraction of the
screen. A value of "pixels" indicates the y value in pixels. A value of "insetPixels" indicates the
indent from the top edge of the screen.
Type:
- String
(readonly) kmlScreenXYx :String
Either the number of pixels, a fractional component of the screen, or a pixel inset indicating the x
component of a point on the screen.
Type:
- String
(readonly) kmlScreenXYxunits :String
Units in which the x value is specified. A value of "fraction" indicates the x value is a fraction of
the
screen. A value of "pixels" indicates the x value in pixels. A value of "insetPixels" indicates the
indent from the right edge of the screen.
Type:
- String
(readonly) kmlScreenXYy :String
Either the number of pixels, a fractional component of the screen, or a pixel inset indicating the y
component of a point on the screen.
Type:
- String
(readonly) kmlScreenXYyunits :String
Units in which the y value is specified. A value of fraction indicates the y value is a fraction of the
screen. A value of "pixels" indicates the y value in pixels. A value of "insetPixels" indicates the
indent from the top edge of the screen.
Type:
- String
(readonly) kmlSizex :String
A value of +-1 indicates to use the native dimension
A value of 0 indicates to maintain the aspect ratio
A value of n sets the value of the dimension
Type:
- String
(readonly) kmlSizexunits :String
Units in which the x value is specified. A value of "fraction" indicates the x value is a fraction of
the
screen. A value of "pixels" indicates the x value in pixels. A value of "insetPixels" indicates the
indent from the right edge of the screen.
Type:
- String
(readonly) kmlSizey :String
A value of +-1 indicates to use the native dimension
A value of 0 indicates to maintain the aspect ratio
A value of n sets the value of the dimension
Type:
- String
(readonly) kmlSizeyunits :String
Units in which the y value is specified. A value of fraction indicates the y value is a fraction of the
screen. A value of "pixels" indicates the y value in pixels. A value of "insetPixels" indicates the
indent from the top edge of the screen.
Type:
- String
(readonly) kmlSnippet :String
A short description of the feature. In Google Earth, this description is displayed in the Places panel
under the name of the feature. If a Snippet is not supplied, the first two lines of the
<description> are used. In Google Earth, if a Placemark contains both a description and a Snippet,
the <Snippet> appears beneath the Placemark in the Places panel, and the <description>
appears in the Placemark's description balloon. This tag does not support HTML markup. <Snippet>
has a maxLines attribute, an integer that specifies the maximum number of lines to display.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlStyleSelector :KmlStyle
One style element per Feature, with possible children of different substyles.
Type:
- Inherited From:
- Source:
(readonly) kmlStyleUrl :String
URL of a <Style> or <StyleMap> defined in a Document. If the style is in the same file, use
a # reference. If the style is defined in an external file, use a full URL along with # referencing. If
it references remote URL, this server must support CORS for us to be able to download it.
Type:
- String
- Inherited From:
- Source:
(readonly) kmlTimePrimitive :KmlTimePrimitive
It represents one of the TimePrimitives associated with current Feature. Specific implementation of
TimePrimitive will be returned.
Type:
- Inherited From:
- Source:
(readonly) kmlVisibility :Boolean
Visibility of current feature. It is possible for some features to be invisible.
Type:
- Boolean
- Inherited From:
- Source:
(readonly) node :Node
Node of this object. It may be overridden by other users of some functions like parse.
Type:
- Node
- Inherited From:
- Source:
pickDelegate :Object
Indicates the object to return as the userObject of this shape when picked. If null,
then this shape is returned as the userObject.
Type:
- Object
- Inherited From:
- Default Value:
- null
- Source:
- See:
userProperties :Object
An application defined object associated with this renderable. A typical use case is to associate
application defined data with a picked renderable.
Type:
- Object
- Inherited From:
- Default Value:
- An empty object
- Source:
Methods
getStyle() → {Promise|undefined}
It retrieves the style for current element, regardless of whether it is local or remote.
- Inherited From:
- Source:
Returns:
Promise of the file to deliver
- Type
- Promise | undefined
getTagNames() → {Array.<String>}
Returns tag name of all descendants of abstract node or the tag name for current node.
- Overrides:
- Source:
Returns:
- Type
- Array.<String>
hook(controls, options)
It calls all controls associated with current KmlFile with the link to this.
Parameters:
Name | Type | Description |
---|---|---|
controls |
Array.<KmlControls> | Controls associated with current tree. |
options |
Object | Options to pass into the controls. |
- Inherited From:
- Source:
render(dc)
Render this renderable. Some shapes actually draw themselves during this call, others only add themselves
to the draw context's ordered rendering list for subsequent drawing when their renderOrdered method is called.
This method is intended to be called by layers such as RenderableLayer and not by applications.
Parameters:
Name | Type | Description |
---|---|---|
dc |
DrawContext | The current draw context. |
- Overrides:
- Source:
solveRegion(dc) → {boolean}
Internal use only
It solves whether the feature should be visible based on the Region.
Parameters:
Name | Type | Description |
---|---|---|
dc |
DrawContext | Draw context associated with current processing. |
- Inherited From:
- Source:
Returns:
true if there is no region or the feature is in the region.
- Type
- boolean
solveStyle(dc, kmlOptions)
Internal use only
It solves style which should be applied to current feature.
Parameters:
Name | Type | Description | ||||||
---|---|---|---|---|---|---|---|---|
dc |
DrawContext | DrawContext associated with current processing. | ||||||
kmlOptions |
Object |
Properties
|
- Inherited From:
- Source:
solveTimeVisibility()
Internal function for solving the time visibility. The element is visible when its whole range is inside the
time range chosen by user.
- Inherited From:
- Source:
solveVisibility(dc, kmlOptions)
Internal use only
It solves whether current feature should be visible. It takes into account the visibility of parent elements, Time constraints, region, visibility.
Parameters:
Name | Type | Description |
---|---|---|
dc |
DrawContext | Draw context associated with current processing. |
kmlOptions |
Object |
- Inherited From:
- Source: