fr.inria.zvtm.lens

Class SCBLens

java.lang.Object

fr.inria.zvtm.lens.Lens

fr.inria.zvtm.lens.FixedSizeLens

fr.inria.zvtm.lens.BlendingLens

fr.inria.zvtm.lens.SCBLens

All Implemented Interfaces:

TemporalLens

Direct Known Subclasses:

LInfSCBLens

public class SCBLens
extends BlendingLens
implements TemporalLens

Translucent lens. Lens that fades away when moving fast - Distance metric: L(2) (circular shape)
Size expressed as an absolute value in pixels

Field Summary

Fields

Modifier and Type	Field and Description
protected float	dMM pseudo Dynamic magnification factor.
protected boolean	doRing
protected float	mindMM
protected float	scRingRadius
protected SpeedCoupling	speedCoupling

Fields inherited from class fr.inria.zvtm.lens.BlendingLens

MMTc, MMTf

Fields inherited from class fr.inria.zvtm.lens.FixedSizeLens

CONSTANT, LR1, LR2, SPEED_DEPENDENT_LINEAR

Fields inherited from class fr.inria.zvtm.lens.Lens

h, lensHeight, lensWidth, lx, ly, magnifiedGraphics, mbh, mbi, mbw, MM, MM_FLOOR, mSwitchThreshold, owningView, sh, sw, w

Constructor Summary

Constructors

Constructor and Description
SCBLens() create a lens with a maximum magnification factor of 2.0
SCBLens(float mm) create a lens with a given maximum magnification factor
SCBLens(float mm, float minT, float maxT, int innerRadius) create a lens with a given maximum magnification factor, inner and outer radii
SCBLens(float mm, float minT, float maxT, int innerRadius, int x, int y) create a lens with a given maximum magnification factor, inner and outer radii

Method Summary

Modifier and Type	Method and Description
void	dispose()
void	drawBoundary(Graphics2D g2d) for internal use
float	getActualMaximumMagnification()
float	getActualRingRadius()
boolean	getDoRing()
int	getRadius() outer radius
TemporalParamListener	getTemporalParamListener()
void	gfT(float x, float y, float[] g)
void	setAbsolutePosition(int ax, int ay, long absTime) set the position of the lens inside the view
void	setBoundaryColor(Color bc) Set the color used to draw the lens' boundaries (default is black)
void	setCutoffFrequencyParameters(double a, double b)
void	setDoRing(boolean b)
void	setInnerRadius(int r) set the lens' inner radius (beyond which maximum magnification is applied - inward)
void	setMaximumMagnification(float mm) set the lens' maximum magnification
void	setMaximumMagnification(float mm, boolean forceRaster) set the lens' maximum magnification
void	setMMandRadii(float mm, int outerRadius, int innerRadius) set the lens' radii and maximum magnification
void	setMMandRadii(float mm, int outerRadius, int innerRadius, boolean forceRaster) set the lens' radii and maximum magnification
void	setNoUpdateWhenMouseStill(boolean b)
void	setObservedRegionColor(Color bc) Set the color used to draw the boundaries of the region observed through the lens (default is black)
void	setRadii(int outerRadius, int innerRadius) set the lens' radii
void	setRadii(int outerRadius, int innerRadius, boolean forceRaster) set the lens' radii
void	setSpeedCoupling(SpeedCoupling sc)
void	setTemporalParamListener(TemporalParamListener tpl) To be notified about updates to MM due to speed-coupling.
void	updateFrequency()
void	updateFrequency(long currentTime)
void	updateTimeBasedParams()
void	updateTimeBasedParams(int cx, int cy)

Methods inherited from class fr.inria.zvtm.lens.BlendingLens

getContextTranslucencyValue, getFocusTranslucencyValue, gf, setContextTranslucencyValue, setFocusTranslucencyValue

Methods inherited from class fr.inria.zvtm.lens.FixedSizeLens

getInnerRadius, getInnerRadiusColor, getOuterRadius, getOuterRadiusColor, getVisibleRegionInFocus, moveLensBy, setAbsolutePosition, setFocusControlled, setFocusControlled, setInnerRadiusColor, setLensBuffer, setOuterRadius, setOuterRadiusColor

Methods inherited from class fr.inria.zvtm.lens.Lens

getBufferThreshold, getMagnificationGraphics, getMaximumMagnification, getOwningView, getVisibleRegion, getXfocusOffset, getYfocusOffset, isInitialized, resetMagnificationBuffer, setBufferThreshold, setMagRasterDimensions, setMagRasterDimensions, setXfocusOffset, setYfocusOffset, transform

Methods inherited from class java.lang.Object

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

Field Detail

speedCoupling

protected SpeedCoupling speedCoupling

scRingRadius

protected float scRingRadius

doRing

protected boolean doRing

dMM

protected float dMM

pseudo Dynamic magnification factor.

mindMM

protected float mindMM

Constructor Detail

SCBLens

public SCBLens()

create a lens with a maximum magnification factor of 2.0

SCBLens

public SCBLens(float mm)

create a lens with a given maximum magnification factor

Parameters:

mm - magnification factor, mm in [0,+inf[

SCBLens

public SCBLens(float mm,
               float minT,
               float maxT,
               int innerRadius)

create a lens with a given maximum magnification factor, inner and outer radii

Parameters:

mm - magnification factor, mm in [0,+inf[

minT - translucency value (at junction between transition and focus), in [0,1.0]

maxT - translucency value (at junction between transition and focus), in [0,1.0]

innerRadius - inner radius (beyond which maximum magnification is applied - inward)

SCBLens

public SCBLens(float mm,
               float minT,
               float maxT,
               int innerRadius,
               int x,
               int y)

create a lens with a given maximum magnification factor, inner and outer radii

Parameters:

mm - magnification factor, mm in [0,+inf[

minT - translucency value (at junction between transition and focus), in [0,1.0]

maxT - translucency value (at junction between transition and focus), in [0,1.0]

innerRadius - inner radius (beyond which maximum magnification is applied - inward)

x - horizontal coordinate of the lens' center (as an offset w.r.t the view's center coordinates)

y - vertical coordinate of the lens' center (as an offset w.r.t the view's center coordinates)

Method Detail

setInnerRadius

public void setInnerRadius(int r)

set the lens' inner radius (beyond which maximum magnification is applied - inward)

Overrides:

setInnerRadius in class FixedSizeLens

Parameters:

r - radius in pixels

setRadii

public void setRadii(int outerRadius,
                     int innerRadius)

set the lens' radii

Overrides:

setRadii in class FixedSizeLens

Parameters:

outerRadius - outer radius (beyond which no magnification is applied - outward)

innerRadius - inner radius (beyond which maximum magnification is applied - inward)

setRadii

public void setRadii(int outerRadius,
                     int innerRadius,
                     boolean forceRaster)

set the lens' radii

Overrides:

setRadii in class FixedSizeLens

Parameters:

outerRadius - outer radius (beyond which no magnification is applied - outward)

innerRadius - inner radius (beyond which maximum magnification is applied - inward)

forceRaster - true if the magnification raster size should be updated according to the new maximum magnification factor (default is true)

setMMandRadii

public void setMMandRadii(float mm,
                          int outerRadius,
                          int innerRadius)

set the lens' radii and maximum magnification

Overrides:

setMMandRadii in class FixedSizeLens

Parameters:

mm - maximum magnification factor, mm in [0,+inf[

outerRadius - outer radius (beyond which no magnification is applied - outward)

innerRadius - inner radius (beyond which maximum magnification is applied - inward)

setMMandRadii

public void setMMandRadii(float mm,
                          int outerRadius,
                          int innerRadius,
                          boolean forceRaster)

set the lens' radii and maximum magnification

Overrides:

setMMandRadii in class FixedSizeLens

Parameters:

mm - maximum magnification factor, mm in [0,+inf[

outerRadius - outer radius (beyond which no magnification is applied - outward)

innerRadius - inner radius (beyond which maximum magnification is applied - inward)

forceRaster - true if the magnification raster size should be updated according to the new maximum magnification factor (default is true)

setMaximumMagnification

public void setMaximumMagnification(float mm)

Description copied from class: Lens

set the lens' maximum magnification

Overrides:

setMaximumMagnification in class Lens

Parameters:

mm - maximum magnification factor, mm in [0,+inf[

setMaximumMagnification

public void setMaximumMagnification(float mm,
                                    boolean forceRaster)

Description copied from class: Lens

set the lens' maximum magnification

Overrides:

setMaximumMagnification in class Lens

Parameters:

mm - maximum magnification factor, mm in [0,+inf[

forceRaster - true if the magnification raster size should be updated according to the new maximum magnification factor (default is true)

gfT

public void gfT(float x,
                float y,
                float[] g)

Specified by:

gfT in class BlendingLens

updateFrequency

public void updateFrequency()

updateFrequency

public void updateFrequency(long currentTime)

updateTimeBasedParams

public void updateTimeBasedParams(int cx,
                                  int cy)

Specified by:

updateTimeBasedParams in interface TemporalLens

updateTimeBasedParams

public void updateTimeBasedParams()

Specified by:

updateTimeBasedParams in interface TemporalLens

setCutoffFrequencyParameters

public void setCutoffFrequencyParameters(double a,
                                         double b)

setSpeedCoupling

public void setSpeedCoupling(SpeedCoupling sc)

setDoRing

public void setDoRing(boolean b)

getDoRing

public boolean getDoRing()

setNoUpdateWhenMouseStill

public void setNoUpdateWhenMouseStill(boolean b)

Specified by:

setNoUpdateWhenMouseStill in interface TemporalLens

dispose

public void dispose()

Overrides:

dispose in class Lens

setAbsolutePosition

public void setAbsolutePosition(int ax,
                                int ay,
                                long absTime)

set the position of the lens inside the view

Specified by:

setAbsolutePosition in interface TemporalLens

Parameters:

ax - lens's center horizontal coordinate expressed as an absolute position within the view (JPanel coordinate system)

ay - lens's center vertical coordinate expressed as an absolute position within the view (JPanel coordinate system)

absTime - time at which this event is occuring (in ms, as can be obtained e.g. by System.currentTimeMillis())

getRadius

public int getRadius()

Description copied from class: Lens

outer radius

Overrides:

getRadius in class FixedSizeLens

setBoundaryColor

public void setBoundaryColor(Color bc)

Set the color used to draw the lens' boundaries (default is black)

Parameters:

bc - color of the boundary (set to null if you do not want to draw the border)

setObservedRegionColor

public void setObservedRegionColor(Color bc)

Set the color used to draw the boundaries of the region observed through the lens (default is black)

Parameters:

bc - color of the boundary (set to null if you do not want to draw that region)

drawBoundary

public void drawBoundary(Graphics2D g2d)

for internal use

Overrides:

drawBoundary in class FixedSizeLens

getActualRingRadius

public float getActualRingRadius()

Overrides:

getActualRingRadius in class FixedSizeLens

getActualMaximumMagnification

public float getActualMaximumMagnification()

Overrides:

getActualMaximumMagnification in class Lens

setTemporalParamListener

public void setTemporalParamListener(TemporalParamListener tpl)

To be notified about updates to MM due to speed-coupling.

Specified by:

setTemporalParamListener in interface TemporalLens

getTemporalParamListener

public TemporalParamListener getTemporalParamListener()

Specified by:

getTemporalParamListener in interface TemporalLens