fr.inria.zvtm.glyphs

Class VRing<T>

java.lang.Object

fr.inria.zvtm.glyphs.Glyph

fr.inria.zvtm.glyphs.ClosedShape

fr.inria.zvtm.glyphs.VRing<T>

All Implemented Interfaces:

Translucent, Cloneable

public class VRing<T>
extends ClosedShape

Slice of a pie or ring.

Author:

Emmanuel Pietriga

Field Summary

Fields

Modifier and Type	Field and Description
double	angle
int	angleDeg
static double	DEG2RAD_FACTOR
double	orient
int	orientDeg
Point2D.Double	p1
Point2D.Double	p2
Point2D.Double	p3
Point2D.Double	p4
static double	RAD2DEG_FACTOR

Fields inherited from class fr.inria.zvtm.glyphs.ClosedShape

bColor, borderColor, cursorInsideFColor, HSVb

Fields inherited from class fr.inria.zvtm.glyphs.Glyph

alphaC, coef, color, cursorInsideColor, ENTERED_GLYPH, EXITED_GLYPH, fColor, HSV, NO_CURSOR_EVENT, sensit, size, stickedTo, stroke, visible, vx, vy, vz

Fields inherited from interface fr.inria.zvtm.glyphs.Translucent

acO

Constructor Summary

Constructors

Constructor and Description
VRing(double x, double y, int z, double vs, double ag, float irr, double or, Color c, Color bc) Construct a slice by giving its size, angle and orientation
VRing(double x, double y, int z, double vs, double ag, float irr, double or, Color c, Color bc, float alpha) Construct a slice by giving its size, angle and orientation
VRing(double x, double y, int z, double vs, int ag, float irr, int or, Color c, Color bc) Construct a slice by giving its size, angle and orientation
VRing(double x, double y, int z, double vs, int ag, float irr, int or, Color c, Color bc, float alpha) Construct a slice by giving its size, angle and orientation

Method Summary

Modifier and Type	Method and Description
void	addCamera(int verifIndex) Create new projected coordinates.
Object	clone()
boolean	coordInside(int jpx, int jpy, Camera c, double cvx, double cvy) Detect whether the given point is inside this glyph or not.
boolean	coordInsideP(int jpx, int jpy, Camera c) Detect whether the given point is inside this glyph or not.
boolean	coordInsideV(double cvx, double cvy, Camera c) Detect whether the given point is inside this glyph or not.
void	draw(Graphics2D g, int vW, int vH, int i, Stroke stdS, AffineTransform stdT, int dx, int dy) Draw this glyph.
void	drawForLens(Graphics2D g, int vW, int vH, int i, Stroke stdS, AffineTransform stdT, int dx, int dy) Draw this glyph through a lens.
boolean	fillsView(double w, double h, int camIndex) Find out if this glyph completely fills a view.
double	getAngle() Get the arc angle.
float	getInnerRatio() Returns the inner radius ratio, as a percentage of the outer radius.
Shape	getJava2DShape() Get the Java2D Shape corresponding to this Glyph.
double	getOrient() Get the slice's orientation.
double	getSize() Get glyph's size (diameter of bounding circle).
void	initCams(int nbCam) Initialize projected coordinates.
void	move(double x, double y) Translate the glyph by (x,y) - relative translation.
void	moveTo(double x, double y) Translate the glyph to (x,y) - absolute translation.
void	orientTo(double ag) Set the slice's orientation.
void	project(Camera c, Dimension d) Project glyph w.r.t a given camera's coordinate system, prior to actual painting.
void	projectForLens(Camera c, int lensWidth, int lensHeight, float lensMag, double lensx, double lensy) Project glyph w.r.t a given camera's coordinate system, prior to actual painting through a lens.
void	removeCamera(int index) Dispose of projected coordinates.
void	reSize(double factor) Set glyph's size by multiplying its bounding circle diameter by a factor.
void	setAngle(double ag) Set the arc angle.
void	sizeTo(double s) Set glyph's size by setting its bounding circle's diameter.
boolean	visibleInDisc(double dvx, double dvy, double dvr, Shape dvs, int camIndex, int jpx, int jpy, int dpr) The disc is actually approximated to its bounding box here.

Methods inherited from class fr.inria.zvtm.glyphs.ClosedShape

addHSVbColor, getBorderColor, getDefaultBorderColor, getHSVbColor, highlight, isBorderDrawn, isFilled, setBorderColor, setCursorInsideFillColor, setDrawBorder, setFilled, setHSVbColor

Methods inherited from class fr.inria.zvtm.glyphs.Glyph

addHSVColor, containedInRegion, getBounds, getColor, getDefaultColor, getDefaultCursorInsideHighlightColor, getHSVColor, getLocation, getOwner, getStickedGlyphArray, getStroke, getTranslucencyValue, getType, getZindex, isSelected, isSensitive, isVisible, isVisibleThroughLens, propagateMove, select, setColor, setCursorInsideHighlightColor, setDefaultCursorInsideHighlightColor, setHSVColor, setOwner, setSensitivity, setStroke, setTranslucencyValue, setType, setVisible, setZindex, stick, stickToGlyph, toString, unstick, unstickAllGlyphs, unstickAllGlyphs, unstickFromGlyph, visibleInRegion, visibleInViewport

Methods inherited from class java.lang.Object

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

Field Detail

RAD2DEG_FACTOR

public static final double RAD2DEG_FACTOR

See Also:

Constant Field Values

DEG2RAD_FACTOR

public static final double DEG2RAD_FACTOR

See Also:

Constant Field Values

p1

public Point2D.Double p1

p2

public Point2D.Double p2

p3

public Point2D.Double p3

p4

public Point2D.Double p4

angle

public double angle

orient

public double orient

angleDeg

public int angleDeg

orientDeg

public int orientDeg

Constructor Detail

VRing

public VRing(double x,
             double y,
             int z,
             double vs,
             double ag,
             float irr,
             double or,
             Color c,
             Color bc)

Construct a slice by giving its size, angle and orientation

Parameters:

x - x-coordinate in virtual space of vertex that is not an arc endpoint

y - y-coordinate in virtual space of vertex that is not an arc endpoint

z - z-index (pass 0 if you do not use z-ordering)

vs - arc radius in virtual space

ag - arc angle (in rad)

irr - inner ring radius as a percentage of outer ring radius (from center of ring); 0 to create a pie slice

or - slice orientation in virtual space (interpreted as the orientation of the segment linking the vertex that is not an arc endpoint to the middle of the arc) (in rad)

c - fill color

bc - border color

VRing

public VRing(double x,
             double y,
             int z,
             double vs,
             double ag,
             float irr,
             double or,
             Color c,
             Color bc,
             float alpha)

Construct a slice by giving its size, angle and orientation

Parameters:

x - x-coordinate in virtual space of vertex that is not an arc endpoint

y - y-coordinate in virtual space of vertex that is not an arc endpoint

z - z-index (pass 0 if you do not use z-ordering)

vs - arc radius in virtual space

ag - arc angle (in rad)

irr - inner ring radius as a percentage of outer ring radius (from center of ring); 0 to create a pie slice *@param or slice orientation in virtual space (interpreted as the orientation of the segment linking the vertex that is not an arc endpoint to the middle of the arc) (in rad)

c - fill color

bc - border color

alpha - alpha channel value in [0;1.0] 0 is fully transparent, 1 is opaque

VRing

public VRing(double x,
             double y,
             int z,
             double vs,
             int ag,
             float irr,
             int or,
             Color c,
             Color bc)

Construct a slice by giving its size, angle and orientation

Parameters:

x - x-coordinate in virtual space of vertex that is not an arc endpoint

y - y-coordinate in virtual space of vertex that is not an arc endpoint

z - z-index (pass 0 if you do not use z-ordering)

vs - arc radius in virtual space

ag - arc angle (in rad)

irr - inner ring radius as a percentage of outer ring radius (from center of ring); 0 to create a pie slice *@param or slice orientation in virtual space (interpreted as the orientation of the segment linking the vertex that is not an arc endpoint to the middle of the arc) (in degrees)

c - fill color

bc - border color

VRing

public VRing(double x,
             double y,
             int z,
             double vs,
             int ag,
             float irr,
             int or,
             Color c,
             Color bc,
             float alpha)

Construct a slice by giving its size, angle and orientation

Parameters:

x - x-coordinate in virtual space of vertex that is not an arc endpoint

y - y-coordinate in virtual space of vertex that is not an arc endpoint

z - z-index (pass 0 if you do not use z-ordering)

vs - arc radius in virtual space

ag - arc angle (in degrees)

irr - inner ring radius as a percentage of outer ring radius (from center of ring); 0 to create a pie slice

or - slice orientation in virtual space (interpreted as the orientation of the segment linking the vertex that is not an arc endpoint to the middle of the arc) (in degrees)

c - fill color

bc - border color

alpha - alpha channel value in [0;1.0] 0 is fully transparent, 1 is opaque

Method Detail

initCams

public void initCams(int nbCam)

Description copied from class: Glyph

Initialize projected coordinates. Called internally when glyph is created in order to create the initial set of projected coordinates w.r.t the number of cameras in the virtual space.

Specified by:

initCams in class Glyph

Parameters:

nbCam - current number of cameras in the virtual space

See Also:

Glyph.addCamera(int verifIndex), Glyph.removeCamera(int index)

getInnerRatio

public float getInnerRatio()

Returns the inner radius ratio, as a percentage of the outer radius.

Returns:

the inner radius ratio

getOrient

public double getOrient()

Get the slice's orientation.

Specified by:

getOrient in class Glyph

Returns:

slice's orientation in virtual space, interpreted as the orientation of the segment linking the vertex that is not an arc endpoint to the middle of the arc (bisector of the main angle). In [0:2Pi[

fillsView

public boolean fillsView(double w,
                         double h,
                         int camIndex)

Description copied from class: Glyph

Find out if this glyph completely fills a view. (In which case it is not necessary to repaint objects below it in the drawing stack). If implemented, this method should be very efficient, as it is used by an optional top-down clipping algorithm. Otherwise it might cost more time than it can potentially save. Until now it has only been implemented for non-reorientable rectangles and was activated only for treemap-like representations in which a lot of rectangles can potentially overlap each other.

Specified by:

fillsView in class Glyph

addCamera

public void addCamera(int verifIndex)

Description copied from class: Glyph

Create new projected coordinates. Called internally to create new projected coordinates to use with the new camera.

Specified by:

addCamera in class Glyph

Parameters:

verifIndex - camera index, just to be sure that the number of projected coordinates is consistent with the number of cameras.

See Also:

Glyph.initCams(int nbCam), Glyph.removeCamera(int index)

removeCamera

public void removeCamera(int index)

Description copied from class: Glyph

Dispose of projected coordinates. If a camera is removed from the virtual space to which this glyphs belongs, the corresponding projected coordinates should be deleted. the array of projected coordinates should not be modified however, because other cameras' index remain the same. The corresponding index in the array should just be set to null.

Specified by:

removeCamera in class Glyph

See Also:

Glyph.initCams(int nbCam), Glyph.addCamera(int verifIndex)

moveTo

public void moveTo(double x,
                   double y)

Description copied from class: Glyph

Translate the glyph to (x,y) - absolute translation.

Overrides:

moveTo in class Glyph

See Also:

Glyph.move(double x, double y)

move

public void move(double x,
                 double y)

Description copied from class: Glyph

Translate the glyph by (x,y) - relative translation.

Overrides:

move in class Glyph

See Also:

Glyph.moveTo(double x, double y)

sizeTo

public void sizeTo(double s)

Description copied from class: Glyph

Set glyph's size by setting its bounding circle's diameter.

Specified by:

sizeTo in class Glyph

See Also:

Glyph.reSize(double factor)

reSize

public void reSize(double factor)

Description copied from class: Glyph

Set glyph's size by multiplying its bounding circle diameter by a factor.

Specified by:

reSize in class Glyph

See Also:

Glyph.sizeTo(double s)

orientTo

public void orientTo(double ag)

Set the slice's orientation.

Specified by:

orientTo in class Glyph

Parameters:

ag - slice orientation in virtual space, interpreted as the orientation of the segment linking the vertex that is not an arc endpoint to the middle of the arc (bisector of the main angle). In [0:2Pi[

setAngle

public void setAngle(double ag)

Set the arc angle.

Parameters:

ag - in [0:2Pi[

getAngle

public double getAngle()

Get the arc angle.

Returns:

the angle in [0:2Pi[

getSize

public double getSize()

Description copied from class: Glyph

Get glyph's size (diameter of bounding circle).

Specified by:

getSize in class Glyph

coordInside

public boolean coordInside(int jpx,
                           int jpy,
                           Camera c,
                           double cvx,
                           double cvy)

Description copied from class: Glyph

Detect whether the given point is inside this glyph or not.

Specified by:

coordInside in class Glyph

Parameters:

jpx - provide projected JPanel coordinates of the associated view, not virtual space coordinates

jpy - provide projected JPanel coordinates of the associated view, not virtual space coordinates

c - camera through which the glyph is observed (only a few types of Glyph actually require this information: SICircle, SIRectangle, VText)

cvx - virtual space coordinates

cvy - virtual space coordinates

See Also:

Glyph.coordInsideV(double cvx, double cvy, Camera c), Glyph.coordInsideP(int jpx, int jpy, Camera c)

coordInsideV

public boolean coordInsideV(double cvx,
                            double cvy,
                            Camera c)

Description copied from class: Glyph

Detect whether the given point is inside this glyph or not. Uses VirtualSpace coordinates.

Specified by:

coordInsideV in class Glyph

Parameters:

cvx - virtual space coordinates

cvy - virtual space coordinates

c - camera through which the glyph is observed (only a few types of Glyph actually require this information: SICircle, SIRectangle, VText)

See Also:

Glyph.coordInside(int jpx, int jpy, Camera c, double cvx, double cvy), Glyph.coordInsideP(int jpx, int jpy, Camera c)

coordInsideP

public boolean coordInsideP(int jpx,
                            int jpy,
                            Camera c)

Description copied from class: Glyph

Detect whether the given point is inside this glyph or not. Uses projected coordinates in View.

Specified by:

coordInsideP in class Glyph

Parameters:

jpx - provide projected JPanel coordinates of the associated view, not virtual space coordinates

jpy - provide projected JPanel coordinates of the associated view, not virtual space coordinates

c - camera through which the glyph is observed

See Also:

Glyph.coordInsideV(double cvx, double cvy, Camera c), Glyph.coordInside(int jpx, int jpy, Camera c, double cvx, double cvy)

visibleInDisc

public boolean visibleInDisc(double dvx,
                             double dvy,
                             double dvr,
                             Shape dvs,
                             int camIndex,
                             int jpx,
                             int jpy,
                             int dpr)

The disc is actually approximated to its bounding box here. Precise intersection computation would be too costly.

Overrides:

visibleInDisc in class Glyph

project

public void project(Camera c,
                    Dimension d)

Description copied from class: Glyph

Project glyph w.r.t a given camera's coordinate system, prior to actual painting. Called internally.

Specified by:

project in class Glyph

Parameters:

c - camera

d - dimension of View using camera c

projectForLens

public void projectForLens(Camera c,
                           int lensWidth,
                           int lensHeight,
                           float lensMag,
                           double lensx,
                           double lensy)

Description copied from class: Glyph

Project glyph w.r.t a given camera's coordinate system, prior to actual painting through a lens. Called internally.

Specified by:

projectForLens in class Glyph

Parameters:

c - camera

lensWidth - width of lens activated in View using this camera

lensHeight - height of lens activated in View using this camera

lensMag - magnification factor of lens activated in View using this camera

lensx - horizontal coordinateof lens activated in View using this camera

lensy - vertical coordinate of lens activated in View using this camera

draw

public void draw(Graphics2D g,
                 int vW,
                 int vH,
                 int i,
                 Stroke stdS,
                 AffineTransform stdT,
                 int dx,
                 int dy)

Description copied from class: Glyph

Draw this glyph.

Specified by:

draw in class Glyph

Parameters:

g - graphics context in which the glyph should be drawn

vW - associated View width (used by some closed shapes to determine if it is worth painting the glyph's border)

vH - associated View height (used by some closed shapes to determine if it is worth painting the glyph's border)

i - camera index in the virtual space containing the glyph

stdS - default stroke

stdT - identity transform

dx - horizontal offset

dy - vertical offset

drawForLens

public void drawForLens(Graphics2D g,
                        int vW,
                        int vH,
                        int i,
                        Stroke stdS,
                        AffineTransform stdT,
                        int dx,
                        int dy)

Description copied from class: Glyph

Draw this glyph through a lens.

Specified by:

drawForLens in class Glyph

Parameters:

g - graphics context in which the glyph should be drawn

vW - associated View width (used by some closed shapes to determine if it is worth painting the glyph's border)

vH - associated View height (used by some closed shapes to determine if it is worth painting the glyph's border)

i - camera index in the virtual space containing the glyph

stdS - default stroke

stdT - identity transform

dx - horizontal offset

dy - vertical offset

getJava2DShape

public Shape getJava2DShape()

Description copied from class: Glyph

Get the Java2D Shape corresponding to this Glyph. Virtual Space coordinates.

Specified by:

getJava2DShape in class Glyph

clone

public Object clone()

Overrides:

clone in class Glyph