Class: KmlPhotoOverlay

KmlPhotoOverlay(options)

Contains the data associated with PhotoOverlay node.

Constructor

new KmlPhotoOverlay(options)

Constructs an KmlPhotoOverlay. 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 Photo Overlay.
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) kmlImagePyramid :ImagePyramid

For very large images, you'll need to construct an image pyramid, which is a hierarchical set of images, each of which is an increasingly lower resolution version of the original image. Each image in the pyramid is subdivided into tiles, so that only the portions in view need to be loaded. Google Earth calculates the current viewpoint and loads the tiles that are appropriate to the user's distance from the image. As the viewpoint moves closer to the PhotoOverlay, Google Earth loads higher resolution tiles. Since all the pixels in the original image can't be viewed on the screen at once, this preprocessing allows Google Earth to achieve maximum performance because it loads only the portions of the image that are in view, and only the pixel details that can be discerned by the user at the current viewpoint. When you specify an image pyramid, you also modify the <href> in the <Icon> element to include specifications for which tiles to load.
Type:
  • ImagePyramid
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) kmlPhoneNumber :String

It represents phone number associated with current feature. Quite probably irrelevant information.
Type:
  • String
Inherited From:
Source:

(readonly) kmlPoint :KmlPoint

The <Point> element acts as a <Point> inside a <Placemark> element. It draws an icon to mark the position of the PhotoOverlay. The icon drawn is specified by the <styleUrl> and <StyleSelector> fields, just as it is for <Placemark>.
Type:
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 :String

Adjusts how the photo is placed inside the field of view. This element is useful if your photo has been rotated and deviates slightly from a desired horizontal view.
Type:
  • String
Source:

(readonly) kmlShape :String

The PhotoOverlay is projected onto the <shape>. The <shape> can be one of the following: rectangle (default) - for an ordinary photo
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) kmlViewVolume :ViewVolume

Defines how much of the current scene is visible. Specifying the field of view is analogous to specifying the lens opening in a physical camera. A small field of view, like a telephoto lens, focuses on a small part of the scene. A large field of view, like a wide-angle lens, focuses on a large part of the scene.
Type:
  • ViewVolume
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.
Inherited From:
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: