ilog.tgo.graphic.renderer

Class IltBTSAntennaBaseRenderer.Offscreen

java.lang.Object

ilog.tgo.graphic.renderer.IltBaseRenderer

ilog.tgo.graphic.renderer.IltBTSAntennaBaseRenderer

ilog.tgo.graphic.renderer.IltBTSAntennaBaseRenderer.Offscreen

Enclosing class:

IltBTSAntennaBaseRenderer

public static class IltBTSAntennaBaseRenderer.Offscreen
extends IltBTSAntennaBaseRenderer

The base renderer for the standard BTS Antenna representation making use of the offscreen buffered image technique. This implementation has a more refined cache for common methods like getRect and boundingBox, which yields to better use of hard-to-compute Shapes. As the use of offscreen buffered image is not always supported (such as with blinking colors or when the antenna bounding box is too big), this renderer should also be able to render the BTS antenna directly into the main Graphics.

Internal use only.

Since:

JViews 8.0

Nested Class Summary

Nested classes/interfaces inherited from class ilog.tgo.graphic.renderer.IltBTSAntennaBaseRenderer

IltBTSAntennaBaseRenderer.Offscreen, IltBTSAntennaBaseRenderer.Standard

Field Summary

Fields inherited from class ilog.tgo.graphic.renderer.IltBTSAntennaBaseRenderer

DRAWING_THRESHOLD

Constructor Summary

Constructors

Constructor and Description
Offscreen()

Method Summary

Modifier and Type	Method and Description
IlvRect	boundingBox(IlvTransformer transf, IlvRect rect, boolean withSelection) Returns the bounding box of the area that draw(g,t,rect) draws into.
protected boolean	containsExtraBorders(IlvPoint p, IlvPoint tp, IlvTransformer t, IlvRect rect) Tests whether a point lies within the borders of this object.
protected boolean	containsMain(IlvPoint p, IlvPoint tp, IlvTransformer t, IlvRect rect) Tests whether a point lies within the main part of the base of this object.
protected ilog.tgo.graphic.renderer.internal.IltBaseRendererState	createBaseRendererState() Creates the BTS base renderer state.
void	draw(Graphics grp, IlvTransformer transf, IlvRect rect) Draws the entire base, such that it fits into a given rectangle.
protected boolean	drawAlarmBorder(Graphics grp, IlvTransformer transf, IlvRect rect, int distance) Draw the alarm border.
protected void	drawExtraBorder(Graphics grp, IlvTransformer transf, IlvRect rect, IltPalette palette, int distance, int thickness) Draws an extra border inside or outside the base depending on the value returned by isExtraBorderOutside().
protected void	drawExtraBorder(Graphics grp, Shape shape, IltPalette palette) Draws the extra border for a given border Shape.
void	drawMain(Graphics grp, IlvTransformer transf, IlvRect rect) Draws the main part of the base.
protected boolean	drawSelectionBorder(Graphics grp, IlvTransformer transf, IlvRect rect, int distance) Draw the selection border.
float	getAlphaBeamWidth() Returns the alpha value used to achieve transparency effects when drawing the antenna beam width.
int	getAntennaRadius() Returns the antenna size when the power value is maximum.
float	getBeam() Returns the beam of the antenna.
int	getBeamDirection() Returns the direction of the antenna, in degrees.
int	getBeamWidth() Returns the beam width of the antenna, in degrees.
int	getBeamWidthRadius() Returns the antenna beam width radius when the power value is maximum.
float	getPower() Returns the power of the antenna.
int	getPowerMaxValue() Returns the maximum power possible value for the antenna.
IlvRect	getRect(IlvPoint center) Returns the preferred size of the base.
int	getRotation() Returns the antenna orientation, which is measured in degrees.
Shape	getShape(IlvTransformer transf) Returns the cached bounding shape of this element.
protected void	initBaseRenderer() Initializes the properties of this base renderer.
void	initResources() Initializes resources using the property values defined in this base renderer.
boolean	isAntennaVisible() Returns if the antenna is visible or not.
boolean	isAntialiasing() Returns if anti-aliasing is used or not when drawing the antenna.
boolean	isBeamWidthBorderVisible() Returns if the bean width is drawn with a border or not.
boolean	isBeamWidthVisible() Returns if the antenna beamwidth is visible or not.
void	setAlarmBorderColor(Color c) Sets the color of the alarm border, or null if no alarm border is to be drawn.
void	setAlphaBeamWidth(float v) Sets the alpha value used to achieve transparency effects when drawing the antenna beam width.
void	setAntennaRadius(int r) Sets the antenna size when the power value is maximum.
void	setAntennaVisible(boolean v) Sets if the antenna is visible or not.
void	setAntialiasing(boolean antialiasing) Sets if the anti-aliasing is used or not when drawing the antenna.
void	setBackground(Color bg) Sets the background color used to display the face part.
void	setBeam(float v) Sets the beam of the antenna.
void	setBeamDirection(int v) Sets the direction of the antenna, in degrees.
void	setBeamWidth(int w) Sets the beam width of the antenna, in degrees.
void	setBeamWidthBorderVisible(boolean v) Sets if the bean width is drawn with a border or not.
void	setBeamWidthRadius(int v) Sets the antenna beam width radius when the power value is maximum.
void	setBeamWidthVisible(boolean v) Sets if the antenna beamwidth is visible or not.
void	setBorderColor(Color c) Sets the primary color of the base border.
void	setBorderColor2(Color c) Sets the secondary color of the base border.
void	setDottedBorderBackground(Color c) Sets the background color of the dotted border, or null if no dotted border is to be drawn.
void	setDottedBorderForeground(Color c) Sets the foreground color of the dotted border, or null if no dotted border is to be drawn.
void	setForeground(Color fg) Sets the foreground color used to display the face part.
void	setPower(float v) Sets the power of the antenna.
void	setPowerMaxValue(int v) Sets the maximum power possible value for the antenna.
void	setRotation(int r) Sets the antenna orientation, which is measured in degrees.
void	setSelectionBorderBackground(Color v) Sets the background color of the selection border, or null if no selection border is to be drawn.
void	setSelectionBorderForeground(Color c) Sets the foreground color of the selection border, or null if no selection border is to be drawn.

Methods inherited from class ilog.tgo.graphic.renderer.IltBTSAntennaBaseRenderer

drawExtraBorders, isExtraBorderOutside

Methods inherited from class ilog.tgo.graphic.renderer.IltBaseRenderer

__isDottedBorderVisible, attach, boundingBoxWithTransformer, contains, drawExtraBorder, dropResources, getAlarmBorderColor, getAlarmBorderWidth, getAlarmColorLevel, getBackground, getBaseRenderer, getBaseRendererState, getBorderColor, getBorderColor2, getBorderLineStyle, getBorderPalette, getBorderPattern, getBorderWidth, getBrightPalette, getDarkPalette, getDeprecatedBlinkingMode, getDetailLevel, getDottedBorderBackground, getDottedBorderForeground, getDottedBorderLineStyle, getDottedBorderPalette, getExtraBorders, getFillAngle, getFillEnd, getFillStart, getFillStyle, getFillTexture, getForeground, getPalette, getPattern, getRepresentationObject, getSelectionBorderBackground, getSelectionBorderForeground, getSelectionBorderLineStyle, getSelectionBorderWidth, getSourceImage, getView, isAlarmBorderVisible, isAlarmColorVisible, isBaseSelectionBorderVisible, isDottedBorderVisible, isPolygonalBorder, isReliefBorders, isUsingBlinkingResources, setAlarmBorderVisible, setAlarmBorderWidth, setAlarmColorLevel, setAlarmColorVisible, setBaseRendererState, setBaseSelectionBorderVisible, setBorderLineStyle, setBorderPattern, setBorderWidth, setDeprecatedBlinkingMode, setDetailLevel, setDottedBorderLineStyle, setDottedBorderVisible, setFillAngle, setFillEnd, setFillStart, setFillStyle, setFillTexture, setPattern, setPolygonalBorder, setReliefBorders, setRepresentationObject, setSelectionBorderLineStyle, setSelectionBorderWidth, setSourceImage, setView

Methods inherited from class java.lang.Object

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

Constructor Detail

Offscreen

public Offscreen()

Method Detail

initBaseRenderer

protected void initBaseRenderer()

Description copied from class: IltBaseRenderer

Initializes the properties of this base renderer. This method is called at initialization time.

Overrides:

initBaseRenderer in class IltBaseRenderer

createBaseRendererState

protected ilog.tgo.graphic.renderer.internal.IltBaseRendererState createBaseRendererState()

Creates the BTS base renderer state.

Overrides:

createBaseRendererState in class IltBaseRenderer

setForeground

public void setForeground(Color fg)

Description copied from class: IltBaseRenderer

Sets the foreground color used to display the face part.

Overrides:

setForeground in class IltBaseRenderer

Parameters:

fg - Foreground color

setBackground

public void setBackground(Color bg)

Description copied from class: IltBaseRenderer

Sets the background color used to display the face part.

Overrides:

setBackground in class IltBaseRenderer

Parameters:

bg - background color

setBorderColor

public void setBorderColor(Color c)

Description copied from class: IltBaseRenderer

Sets the primary color of the base border.

The value depends on the semantic state of the object.

Overrides:

setBorderColor in class IltBaseRenderer

setBorderColor2

public void setBorderColor2(Color c)

Description copied from class: IltBaseRenderer

Sets the secondary color of the base border.

The value depends on the semantic state of the object.

Overrides:

setBorderColor2 in class IltBaseRenderer

setAlarmBorderColor

public void setAlarmBorderColor(Color c)

Description copied from class: IltBaseRenderer

Sets the color of the alarm border, or null if no alarm border is to be drawn.

The value depends on the semantic state of the object.

Overrides:

setAlarmBorderColor in class IltBaseRenderer

setSelectionBorderForeground

public void setSelectionBorderForeground(Color c)

Description copied from class: IltBaseRenderer

Sets the foreground color of the selection border, or null if no selection border is to be drawn.

The value depends on the graphic object environment.

Overrides:

setSelectionBorderForeground in class IltBaseRenderer

setSelectionBorderBackground

public void setSelectionBorderBackground(Color v)

Description copied from class: IltBaseRenderer

Sets the background color of the selection border, or null if no selection border is to be drawn.

The value depends on the graphic object environment.

Overrides:

setSelectionBorderBackground in class IltBaseRenderer

setDottedBorderForeground

public void setDottedBorderForeground(Color c)

Description copied from class: IltBaseRenderer

Sets the foreground color of the dotted border, or null if no dotted border is to be drawn.

The value depends on the graphic object environment.

Overrides:

setDottedBorderForeground in class IltBaseRenderer

setDottedBorderBackground

public void setDottedBorderBackground(Color c)

Description copied from class: IltBaseRenderer

Sets the background color of the dotted border, or null if no dotted border is to be drawn.

The value depends on the graphic object environment.

Overrides:

setDottedBorderBackground in class IltBaseRenderer

setRotation

public void setRotation(int r)

Sets the antenna orientation, which is measured in degrees.

Specified by:

setRotation in class IltBTSAntennaBaseRenderer

getRotation

public int getRotation()

Returns the antenna orientation, which is measured in degrees.

setPowerMaxValue

public void setPowerMaxValue(int v)

Sets the maximum power possible value for the antenna.

Specified by:

setPowerMaxValue in class IltBTSAntennaBaseRenderer

getPowerMaxValue

public int getPowerMaxValue()

Returns the maximum power possible value for the antenna.

setAntennaRadius

public void setAntennaRadius(int r)

Sets the antenna size when the power value is maximum.

Specified by:

setAntennaRadius in class IltBTSAntennaBaseRenderer

getAntennaRadius

public int getAntennaRadius()

Returns the antenna size when the power value is maximum.

setBeamWidthRadius

public void setBeamWidthRadius(int v)

Sets the antenna beam width radius when the power value is maximum.

Specified by:

setBeamWidthRadius in class IltBTSAntennaBaseRenderer

getBeamWidthRadius

public int getBeamWidthRadius()

Returns the antenna beam width radius when the power value is maximum.

setPower

public void setPower(float v)

Sets the power of the antenna.

Specified by:

setPower in class IltBTSAntennaBaseRenderer

getPower

public float getPower()

Returns the power of the antenna.

setBeam

public void setBeam(float v)

Sets the beam of the antenna.

Specified by:

setBeam in class IltBTSAntennaBaseRenderer

getBeam

public float getBeam()

Returns the beam of the antenna.

setBeamDirection

public void setBeamDirection(int v)

Sets the direction of the antenna, in degrees.

Specified by:

setBeamDirection in class IltBTSAntennaBaseRenderer

getBeamDirection

public int getBeamDirection()

Returns the direction of the antenna, in degrees.

setBeamWidth

public void setBeamWidth(int w)

Sets the beam width of the antenna, in degrees.

Specified by:

setBeamWidth in class IltBTSAntennaBaseRenderer

getBeamWidth

public int getBeamWidth()

Returns the beam width of the antenna, in degrees.

setBeamWidthVisible

public void setBeamWidthVisible(boolean v)

Sets if the antenna beamwidth is visible or not.

Specified by:

setBeamWidthVisible in class IltBTSAntennaBaseRenderer

isBeamWidthVisible

public boolean isBeamWidthVisible()

Returns if the antenna beamwidth is visible or not.

setBeamWidthBorderVisible

public void setBeamWidthBorderVisible(boolean v)

Sets if the bean width is drawn with a border or not.

Specified by:

setBeamWidthBorderVisible in class IltBTSAntennaBaseRenderer

isBeamWidthBorderVisible

public boolean isBeamWidthBorderVisible()

Returns if the bean width is drawn with a border or not.

setAntennaVisible

public void setAntennaVisible(boolean v)

Sets if the antenna is visible or not.

Specified by:

setAntennaVisible in class IltBTSAntennaBaseRenderer

isAntennaVisible

public boolean isAntennaVisible()

Returns if the antenna is visible or not.

setAlphaBeamWidth

public void setAlphaBeamWidth(float v)

Sets the alpha value used to achieve transparency effects when drawing the antenna beam width.

Specified by:

setAlphaBeamWidth in class IltBTSAntennaBaseRenderer

getAlphaBeamWidth

public float getAlphaBeamWidth()

Returns the alpha value used to achieve transparency effects when drawing the antenna beam width.

setAntialiasing

public void setAntialiasing(boolean antialiasing)

Sets if the anti-aliasing is used or not when drawing the antenna.

Specified by:

setAntialiasing in class IltBTSAntennaBaseRenderer

isAntialiasing

public boolean isAntialiasing()

Returns if anti-aliasing is used or not when drawing the antenna.

getRect

public IlvRect getRect(IlvPoint center)

Description copied from class: IltBTSAntennaBaseRenderer

Returns the preferred size of the base.

Specified by:

getRect in class IltBTSAntennaBaseRenderer

initResources

public void initResources()

Description copied from class: IltBaseRenderer

Initializes resources using the property values defined in this base renderer.

This method can be overridden if you want to modify the value of the properties that have been automatically set by JTGO.

If this method is overridden, super.initResources() should be called after setting your own values.

Overrides:

initResources in class IltBaseRenderer

containsMain

protected boolean containsMain(IlvPoint p,
                               IlvPoint tp,
                               IlvTransformer t,
                               IlvRect rect)

Description copied from class: IltBaseRenderer

Tests whether a point lies within the main part of the base of this object. This test should return true only if the point corresponds to a point drawn by the method drawMain.

This implementation returns true if the point tp is inside the rectangle rect, because it is assumed that the implementation of the drawMain method fills rect.

Note: This method may be overridden to take into account the shape drawn by this base renderer, if it is not rectangular or if it has transparency.

Note: The parameters tp and rect are given in the same coordinate system. The transformer t has already been applied to these parameters.

Overrides:

containsMain in class IltBaseRenderer

Parameters:

p - The point to be tested.

tp - The point p transformed by the transformer t.

t - The transformation that was applied to the object when it was drawn.

rect - As in draw.

See Also:

IltBaseRenderer.drawMain(java.awt.Graphics, ilog.views.IlvTransformer, ilog.views.IlvRect)

containsExtraBorders

protected boolean containsExtraBorders(IlvPoint p,
                                       IlvPoint tp,
                                       IlvTransformer t,
                                       IlvRect rect)

Description copied from class: IltBaseRenderer

Tests whether a point lies within the borders of this object. This test should return true only if the point corresponds to a point drawn by the method drawExtraBorders.

This implementation returns true if the point tp is one of the pixels drawn by the default implementation of drawExtraBorders. It takes into account the dotted border when drawn, and the rectangular or polygonal borders according to the value returned by getExtraBorders.

Note: This method may be overridden to take into account particular borders drawn by a subclass.

Note: The parameters tp and rect are given in the same coordinate system. The transformer t has already been applied to these parameters.

Overrides:

containsExtraBorders in class IltBaseRenderer

Parameters:

p - The point to be tested.

tp - The point p transformed by the transformer t.

t - The transformation that was applied to the object when it was drawn.

rect - As in draw.

See Also:

IltBaseRenderer.getExtraBorders(ilog.views.IlvRect), IltBaseRenderer.drawExtraBorders(java.awt.Graphics, ilog.views.IlvTransformer, ilog.views.IlvRect)

getShape

public Shape getShape(IlvTransformer transf)

Description copied from class: IltBTSAntennaBaseRenderer

Returns the cached bounding shape of this element. This method is needed to implement the tooltip functionality in the thin-client (JSF)

Specified by:

getShape in class IltBTSAntennaBaseRenderer

Parameters:

transf - The view transformer

boundingBox

public IlvRect boundingBox(IlvTransformer transf,
                           IlvRect rect,
                           boolean withSelection)

Description copied from class: IltBaseRenderer

Returns the bounding box of the area that draw(g,t,rect) draws into.

The argument rect is a fresh copy and may be destructively modified by this function.

This implementation of the function assumes that the main part fills rect. Depending on the value returned by isExtraBorderOutside(), the function returns rect, or rect enlarged by the width of the selection border, alarm border and dotted border, if present.

Overrides:

boundingBox in class IltBaseRenderer

Parameters:

transf - Transformer applied to the object.

rect - As in draw.

withSelection - if false the rect will not be enlarged by the selection.

draw

public void draw(Graphics grp,
                 IlvTransformer transf,
                 IlvRect rect)

Description copied from class: IltBaseRenderer

Draws the entire base, such that it fits into a given rectangle.

Overrides:

draw in class IltBTSAntennaBaseRenderer

Parameters:

grp - The graphics context to draw into.

transf - The transformer that has been applied to rect. (It is only passed because drawing with an Ilt2DPalette requires it.)

rect - The rectangle to draw into. This is a rectangle with integer coordinates. Its corners have the following coordinates x₁ = rect.x, x₂ = rect.x + rect.width - 1, y₁ = rect.y, y₂ = rect.y + rect.height - 1.

The default implementation of this function calls drawMain and drawExtraBorders.

drawMain

public void drawMain(Graphics grp,
                     IlvTransformer transf,
                     IlvRect rect)

Description copied from class: IltBaseRenderer

Draws the main part of the base.

Specified by:

drawMain in class IltBaseRenderer

Parameters:

grp - As in draw.

transf - As in draw.

rect - As in draw.

drawSelectionBorder

protected boolean drawSelectionBorder(Graphics grp,
                                      IlvTransformer transf,
                                      IlvRect rect,
                                      int distance)

Description copied from class: IltBaseRenderer

Draw the selection border. Returns if the selection border was displayed or not.

Overrides:

drawSelectionBorder in class IltBaseRenderer

drawAlarmBorder

protected boolean drawAlarmBorder(Graphics grp,
                                  IlvTransformer transf,
                                  IlvRect rect,
                                  int distance)

Description copied from class: IltBaseRenderer

Draw the alarm border. Returns if the alarm border was displayed or not.

Overrides:

drawAlarmBorder in class IltBaseRenderer

drawExtraBorder

protected void drawExtraBorder(Graphics grp,
                               IlvTransformer transf,
                               IlvRect rect,
                               IltPalette palette,
                               int distance,
                               int thickness)

Description copied from class: IltBaseRenderer

Draws an extra border inside or outside the base depending on the value returned by isExtraBorderOutside().

This method is called by drawExtraBorders for each border that needs to be drawn (selection, alarm and dotted borders).

The shape of the drawn borders is a rectangle if the dotted border is visible OR if getExtraBorders returns null. If the dotted border is invisible AND getExtraBorders returns a non-null array of IltPolygon, then these polygons are used as shapes for the borders.

Overrides:

drawExtraBorder in class IltBaseRenderer

Parameters:

grp - As in draw

transf - As in draw

rect - As in draw

palette - The palette with the border colors

distance - The distance from the main part (not including width)

thickness - The width of the border

See Also:

IltBaseRenderer.getExtraBorders(ilog.views.IlvRect), IltBaseRenderer.isExtraBorderOutside(), IltBaseRenderer.isDottedBorderVisible()

drawExtraBorder

protected void drawExtraBorder(Graphics grp,
                               Shape shape,
                               IltPalette palette)

Draws the extra border for a given border Shape.