com.dingi.dingisdk.style.light

Class Light

java.lang.Object

com.dingi.dingisdk.style.light.Light

@UiThread
public class Light
extends java.lang.Object

The global light source.

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAnchor() Get the Anchor property.
java.lang.String	getColor() Get the Color property.
TransitionOptions	getColorTransition() Get the Color property transition options.
float	getIntensity() Get the Intensity property.
TransitionOptions	getIntensityTransition() Get the Intensity property transition options.
Position	getPosition() Get the Position property.
TransitionOptions	getPositionTransition() Get the Position property transition options.
void	setAnchor(java.lang.String anchor) Set the Anchor property.
void	setColor(int color) Set the Color property.
void	setColor(java.lang.String color) Set the Color property.
void	setColorTransition(TransitionOptions options) Set the Color property transition options.
void	setIntensity(float intensity) Set the Intensity property.
void	setIntensityTransition(TransitionOptions options) Set the Intensity property transition options.
void	setPosition(Position position) Set the Position property.
void	setPositionTransition(TransitionOptions options) Set the Position property transition options.

Methods inherited from class java.lang.Object

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

Method Detail

setAnchor

public void setAnchor(java.lang.String anchor)

Set the Anchor property. Whether extruded geometries are lit relative to the map or viewport.

Parameters:

anchor - as String

getAnchor

@NonNull
public java.lang.String getAnchor()

Get the Anchor property. Whether extruded geometries are lit relative to the map or viewport.

Returns:

anchor as String

setPosition

public void setPosition(@NonNull
                        Position position)

Set the Position property. Position of the light source relative to lit (extruded) geometries, in [r radial coordinate, a azimuthal angle, p polar angle] where r indicates the distance from the center of the base of an object to its light, a indicates the position of the light relative to 0° (0° when `light.anchor` is set to `viewport` corresponds to the top of the viewport, or 0° when `light.anchor` is set to `map` corresponds to due north, and degrees proceed clockwise), and p indicates the height of the light (from 0°, directly above, to 180°, directly below).

Parameters:

position - of the light

getPosition

@NonNull
public Position getPosition()

Get the Position property. Position of the light source relative to lit (extruded) geometries, in [r radial coordinate, a azimuthal angle, p polar angle] where r indicates the distance from the center of the base of an object to its light, a indicates the position of the light relative to 0° (0° when `light.anchor` is set to `viewport` corresponds to the top of the viewport, or 0° when `light.anchor` is set to `map` corresponds to due north, and degrees proceed clockwise), and p indicates the height of the light (from 0°, directly above, to 180°, directly below).

Returns:

position as Position

getPositionTransition

@NonNull
public TransitionOptions getPositionTransition()

Get the Position property transition options.

Returns:

transition options for position

setPositionTransition

public void setPositionTransition(@NonNull
                                  TransitionOptions options)

Set the Position property transition options.

Parameters:

options - transition options for position

setColor

public void setColor(int color)

Set the Color property. Color tint for lighting extruded geometries.

Parameters:

color - as int

setColor

public void setColor(java.lang.String color)

Set the Color property. Color tint for lighting extruded geometries.

Parameters:

color - as String

getColor

@NonNull
public java.lang.String getColor()

Get the Color property. Color tint for lighting extruded geometries.

Returns:

color as String

getColorTransition

@NonNull
public TransitionOptions getColorTransition()

Get the Color property transition options.

Returns:

transition options for color

setColorTransition

public void setColorTransition(@NonNull
                               TransitionOptions options)

Set the Color property transition options.

Parameters:

options - transition options for color

setIntensity

public void setIntensity(float intensity)

Set the Intensity property. Intensity of lighting (on a scale from 0 to 1). Higher numbers will present as more extreme contrast.

Parameters:

intensity - as Float

getIntensity

@NonNull
public float getIntensity()

Get the Intensity property. Intensity of lighting (on a scale from 0 to 1). Higher numbers will present as more extreme contrast.

Returns:

intensity as Float

getIntensityTransition

@NonNull
public TransitionOptions getIntensityTransition()

Get the Intensity property transition options.

Returns:

transition options for intensity

setIntensityTransition

public void setIntensityTransition(@NonNull
                                   TransitionOptions options)

Set the Intensity property transition options.

Parameters:

options - transition options for intensity