Class: KmlScreenOverlay

KmlScreenOverlay(options)

Contains the data associated with ScreenOverlay node.

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
Name Type Description
objectNode Node Node representing ScreenOverlay
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
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(readonly) kmlRotationXYx :String

It decides by how much will be the screen overlay rotated in x direction
Type:
  • String
Source:

(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
Source:

(readonly) kmlRotationXYy :String

It decides by how much will be the screen overlay rotated in y direction
Type:
  • String
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(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
Source:

(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:

timeRange :Array.<Date>

An array with two elements: start time and end time of the visible range.
Type:
  • Array.<Date>
Inherited From:
Source:

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
Name Type Description
lastStyle KmlStyle Style representing the one to apply to current information.
Inherited From:
Source:

solveTimeVisibility()

Internal function for solving the visibility based on time. The element is visible when its whole range is inside the selected time range.
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: