TLspRadarVideoStyle (LuciadFusion API documentation)

java.lang.Object
- com.luciad.view.lightspeed.style.ALspStyle
- - com.luciad.realtime.lightspeed.radarvideo.TLspRadarVideoStyle

All Implemented Interfaces:

ILspStyler
```
public final class TLspRadarVideoStyle
extends ALspStyle
```
Style that configures the visualization of a radar video layer. Radar video styles can be created using the supplied TLspRadarVideoStyle.Builder. The following screenshot is an example of what a radar video layer might display: What follows is an overview of the elements of the radar display and how they can be configured using this style.
Background
The circular area covered by the radar is filled in a constant color as given by getBackgroundColor() (dark gray in the screenshot). It is possible to use a translucent color so that any background data is visible through the radar feed.
Detected objects
Objects detected by the radar (also referred to as "blips") are colored using getBlipColor() (green in the screenshot). After the sweep has passed them, blips begin to fade into the background color over a time interval determined by getBlipAfterglow().
If a blip is not "confirmed" by a subsequent pass of the radar (i.e. an object that was previously detected appears to be no longer there), the blip changes from the blip color to getBlipAfterglowColor(). This allows the user to visually distinguish "fresh" blips from ones that are only still visible due to afterglow. If the afterglow color is set to null, the blip color is always used and this visual distinction will not be made.
The blip/afterglow color is modulated by the amplitude of the blip, i.e. blips with a high amplitude will be more clearly visible. A blip with maximal amplitude will always have the exact blip color specified by this style.
Improving the "readability" of the display
The getIntensity() property can be used to bias the intensity of the blips and bring out more contrast in the display. The default value is 1. Higher values increase the intensity of the blips, lower values decrease it. The intensity setting has no effect on blips which already have maximal amplitude; it only makes blips with a lower amplitude appear brighter.
If the radar signal contains a lot of noise, getAmplitudeThreshold() can be used to filter out cells which produced only a low amplitude. The threshold is a normalized value: 0 means that all non-zero amplitudes are displayed, and 1 means that only cells which have the highest possible amplitude are kept.
The radar video feed can also be antialiased. This reduces "shimmering" effects for feeds that have a lot of noise or other high-frequency detail. Antialiasing incurs a performance penalty, obviously, and is therefore configurable by a quality hint.

Since:

2014.1

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`TLspRadarVideoStyle.AfterglowMode` Mode that determines how the `afterglow duration` is interpreted.
`static class`	`TLspRadarVideoStyle.AntialiasingHint` Mode that determines the quality of the antialiasing applied to radar video feeds.
`static class`	`TLspRadarVideoStyle.Builder<B extends TLspRadarVideoStyle.Builder<B>>` Builder used to create `TLspRadarVideoStyle` objects.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`TLspRadarVideoStyle.Builder<?>`	`asBuilder()` Creates a new builder initialized with all the properties of this style.
`boolean`	`equals(Object o)`
`double`	`getAmplitudeThreshold()` Returns the minimum amplitude required for a blip to be displayed, normalized into [0, 1] range.
`TLspRadarVideoStyle.AntialiasingHint`	`getAntialiasingHint()` Returns the amount of antialiasing to be applied to the radar video feed.
`Color`	`getBackgroundColor()` Returns the background color used to visualize the circular area covered by the radar.
`double`	`getBlipAfterglow()` Returns the afterglow duration of the blips.
`Color`	`getBlipAfterglowColor()` Returns the afterglow color used to visualize objects that were not detected by the last pass of the radar but which are still visible due to afterglow.
`TLspRadarVideoStyle.AfterglowMode`	`getBlipAfterglowMode()` Determines the interpretation of the blip afterglow time.
`Color`	`getBlipColor()` Returns the blip color used to visualize the detected objects.
`double`	`getIntensity()` Returns the intensity of the blips.
`int`	`hashCode()`
`boolean`	`isTransparent()` Determines whether this style is transparent.
`static TLspRadarVideoStyle.Builder<?>`	`newBuilder()` Creates a new builder with the default values.

Methods inherited from class com.luciad.view.lightspeed.style.ALspStyle
addStyleChangeListener, getZOrder, isCompatible, removeStyleChangeListener, style

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - newBuilder
```
public static TLspRadarVideoStyle.Builder<?> newBuilder()
```
    Creates a new builder with the default values.
    
    Returns:
    
    the new builder.
  - asBuilder
```
public TLspRadarVideoStyle.Builder<?> asBuilder()
```
    Creates a new builder initialized with all the properties of this style.
    
    Specified by:
    
    asBuilder in class ALspStyle
    
    Returns:
    
    the new builder.
  - getBlipColor
```
public Color getBlipColor()
```
    Returns the blip color used to visualize the detected objects.
    
    Returns:
    
    the blip color
  - getBlipAfterglowColor
```
public Color getBlipAfterglowColor()
```
    Returns the afterglow color used to visualize objects that were not detected by the last pass of the radar but which are still visible due to afterglow. If the afterglow color is set to null, the blip color is used (so current blips cannot be visually distinguished from fading ones).
    
    Returns:
    
    the afterglow color
  - getBackgroundColor
```
public Color getBackgroundColor()
```
    Returns the background color used to visualize the circular area covered by the radar.
    
    Returns:
    
    the background color
  - getBlipAfterglow
```
public double getBlipAfterglow()
```
    Returns the afterglow duration of the blips. This is used to fade the blips over time. After the time specified, the blip will completely disappear. The interpretation of the afterglow duration depends on the afterglow mode. It is either measured in seconds or as the number of full 360 degree sweeps of the radar.
    
    Returns:
    
    the afterglow duration of the blips in seconds
  - getBlipAfterglowMode
```
public TLspRadarVideoStyle.AfterglowMode getBlipAfterglowMode()
```
    Determines the interpretation of the blip afterglow time. If set to TLspRadarVideoStyle.AfterglowMode.ABSOLUTE, the afterglow is measured in seconds. If set to TLspRadarVideoStyle.AfterglowMode.RELATIVE, the afterglow is defined as a number of full 360 degree sweeps of the radar.
    
    Returns:
    
    the interpretation of the blip afterglow duration
  - getAmplitudeThreshold
```
public double getAmplitudeThreshold()
```
    Returns the minimum amplitude required for a blip to be displayed, normalized into [0, 1] range. This can be used to filter out cells which produced only a low amplitude.
    
    Returns:
    
    the minimum displayed blip amplitude
  - getIntensity
```
public double getIntensity()
```
    Returns the intensity of the blips. Higher values increase the intensity of the blips, lower values decrease it. This can be used to bias the intensity of the blips and bring out more contrast in the display.
    
    Returns:
    
    the intensity of the blips
  - getAntialiasingHint
```
public TLspRadarVideoStyle.AntialiasingHint getAntialiasingHint()
```
    Returns the amount of antialiasing to be applied to the radar video feed. Antialiasing can reduce visual artifacts when displaying high-frequency data at low zoom levels, but incurs a performance cost. Since noise can also be filtered out at no cost by changing the amplitude threshold, antialiasing is disabled by default. This should be fine for most data, but you can enable antialiasing if you don't want to use the amplitude threshold or if that alone does not solve all aliasing artifacts for your data.
    
    Returns:
    
    the amount of antialiasing applied to the data
  - isTransparent
```
public boolean isTransparent()
```
    Description copied from class: ALspStyle
    
    Determines whether this style is transparent.
    Shapes that are transparent can be painted in a different paint phase than shapes that are not transparent.
    
    Specified by:
    
    isTransparent in class ALspStyle
    
    Returns:
    
    whether or not this style is transparent
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class ALspStyle
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class ALspStyle

Real-time EngineClass TLspRadarVideoStyle

Background

Detected objects

Improving the "readability" of the display

Nested Class Summary

Method Summary

Methods inherited from class com.luciad.view.lightspeed.style.ALspStyle

Methods inherited from class java.lang.Object

Method Detail

newBuilder

asBuilder

getBlipColor

getBlipAfterglowColor

getBackgroundColor

getBlipAfterglow

getBlipAfterglowMode

getAmplitudeThreshold

getIntensity

getAntialiasingHint

isTransparent

equals

hashCode