|| || Doxygen's  

---

CanvasChain Class Reference

Inheritance diagram for CanvasChain::

List of all members.

Public Methods
	CanvasChain (int[] chain, double x, double y)
	CanvasChain (int[] chain, double x, double y, Color color)
	CanvasChain (int[] chain, double x, double y, Color color, boolean stroke, float linew, float trans, double ccs_scale)
void	draw (Graphics g)
	Draw CanvasObject on 'g', using internal CCS values. More...
Object	clone ()
	Return an identical copy of this CanvasObject. More...
boolean	isInside (double x, double y)
boolean	isNear (double x, double y)
void	setDimension (double w, double h)
	Resize CanvasObject to width 'w' and height 'h'. More...
void	doPixelFit (double zoomFactor)
	Round internal ICS values to nearest natural number. More...
void	doMove (double w, double h)
	Move CanvasObject 'w' positions in x-direction, and 'h' posi- tions in y-direction. More...
void	setColor (Color newColor)
double	getFirstX ()
double	getFirstY ()
double[]	getXPoints ()
double[]	getYPoints ()
int	getNrPoints ()
int[]	getChain ()
boolean	isCircular ()
void	setCircular (boolean b)
boolean	isInsideCcs (int x, int y)
	To be removed. More...
boolean	isNearCcs (int x, int y)
	To be removed. More...
void	setDimension (int w, int h)
void	doMove (int w, int h)
int	changePoint (int index, int x, int y)
Protected Methods
void	initChain (int[] chain, double x, double y)
void	transformICStoCCS ()
	Perform a full ICS to CCS coordinate transformation. More...
void	makeFreemanPoly (double x, double y, int[] chain)
void	makePixelChain ()
void	setBox ()
Protected Attributes
int[]	freeman = null
double[]	ics_xPoints = null
double[]	ics_yPoints = null
Polygon	ccs_poly = null
boolean	circular = false
Image	image = null

---

Constructor & Destructor Documentation

CanvasChain::CanvasChain (  int    chain[], double    x, double    y )  [inline]

{ this(chain, x, y, NO_COLOR, false, DEF_LINEW, DEF_TRANS, DEF_SCALE); }

CanvasChain::CanvasChain (  int    chain[], double    x, double    y, Color    color )  [inline]

{ this(chain, x, y, color, false, DEF_LINEW, DEF_TRANS, DEF_SCALE); }

CanvasChain::CanvasChain (  int    chain[], double    x, double    y, Color    color, boolean    stroke, float    linew, float    trans, double    ccs_scale )  [inline]

{ super(x, y, 0., 0., COPY_MODE, color, stroke, linew, trans, ccs_scale); initChain(chain, x, y); }

---

Member Function Documentation

void CanvasChain::draw (  Graphics    g )  [inline, virtual]

Draw CanvasObject on 'g', using internal CCS values. Reimplemented from CanvasObject. { if (!getTransformOK()) { transformICStoCCS(); } if (ccs_poly != null) { setupDrawMode(g); int shift = (int)getZoomFactor(); int half = (int)(getZoomFactor()/2); g.drawImage(image, getX1Ccs() - half, getY1Ccs() - half, getWidthCcs()+shift, getHeightCcs()+shift, null); g.setColor(new Color(drawColor.getRGB() ^ 0xFFFFFFFF)); g.drawPolyline(ccs_poly.xpoints, ccs_poly.ypoints, ccs_poly.npoints); } }

Object CanvasChain::clone (    )  [inline, virtual]

Return an identical copy of this CanvasObject. Reimplemented from CanvasObject. { Color color = drawColor; if (hasNoColor) { color = NO_COLOR; } return (new CanvasChain(freeman, ics_xPoints[0], ics_yPoints[0], color, strokeSet, lineWidth, transparency, getZoomFactor())); }

boolean CanvasChain::isInside (  double    x, double    y )  [inline]

{ if (circular) { double[] ics_vals = { x, y }; int[] ccs_vals = Converter.ICStoCCS(ics_vals, getZoomFactor()); if (!getTransformOK()) { transformICStoCCS(); } return (ccs_poly.contains(ccs_vals[0], ccs_vals[1])); } return false; }

boolean CanvasChain::isNear (  double    x, double    y )  [inline]

{ // adapted from 'Graphics Gems II' - James Arvo, // chap. 1.3, 'Distance from a point to a line', pages 10-13. // check if inside enlarged bounding box (== box + SPHERE) if (!((x >= getX1() - SPHERE) && (x < getX1() + getWidth() + SPHERE) && (y >= getY1() - SPHERE) && (y < getY1() + getHeight() + SPHERE))) { return false; } // we are inside the box, now check each line of the polygon double min_x, min_y, max_x, max_y; double area, abs1, abs2, distance; for (int i=0, j=1; i<ics_xPoints.length; i++, j++) { if (j == ics_xPoints.length) { if (!circular) { break; } j = 0; } min_x = Math.min(ics_xPoints[i], ics_xPoints[j]); min_y = Math.min(ics_yPoints[i], ics_yPoints[j]); max_x = Math.max(ics_xPoints[i], ics_xPoints[j]); max_y = Math.max(ics_yPoints[i], ics_yPoints[j]); // check if inside enlarged bounding box of line if ((x >= min_x - SPHERE) && (x < max_x + SPHERE) && (y >= min_y - SPHERE) && (y < max_y + SPHERE)) { // calculate the area of the triangle formed by the two // CanvasPolyline points and the 'check' point area = (y - ics_yPoints[i])* (ics_xPoints[j] - ics_xPoints[i]) - (x - ics_xPoints[i])* (ics_yPoints[j] - ics_yPoints[i]); // calculate approximation of distance perpendicular to // CanvasLine abs1 = Math.abs(ics_xPoints[j] - ics_xPoints[i]); abs2 = Math.abs(ics_yPoints[j] - ics_yPoints[i]); distance = (int)(Math.abs(area) / (abs1 + abs2 - 0.5 * Math.min(abs1, abs2))); // this approximation can also be used as an // approximation for the 'true' distance if (distance <= SPHERE) { return true; } } } return false; }

void CanvasChain::setDimension (  double    w, double    h )  [inline]

Resize CanvasObject to width 'w' and height 'h'. Parameters are assumed Image Coordinate System values. Reimplemented from ScribbleObject. { // overrule super.setDimension(w, h), and do nothing return; }

void CanvasChain::doPixelFit (  double    zoomFactor )  [inline]

Round internal ICS values to nearest natural number. Although the ICS values are changed, they are not converted to 'integer' internally. Reimplemented from ScribbleObject. { super.doPixelFit(zoomFactor); // Round ICS values of polyline... for (int i=0; i < ics_xPoints.length; i++) { ics_xPoints[i] = Math.round(ics_xPoints[i]); ics_yPoints[i] = Math.round(ics_yPoints[i]); } setTransformOK(false); }

void CanvasChain::doMove (  double    w, double    h )  [inline]

Move CanvasObject 'w' positions in x-direction, and 'h' posi- tions in y-direction. Parameters are assumed Image Coordinate System values. Reimplemented from ScribbleObject. { super.doMove(w, h); for (int i=0; i < ics_xPoints.length; i++) { ics_xPoints[i] += w; ics_yPoints[i] += h; } setTransformOK(false); }

void CanvasChain::setColor (  Color    newColor )  [inline]

Reimplemented from ScribbleFigure. { super.setColor(newColor); if (getWidth() > 0. && getHeight() > 0.) { makePixelChain(); } }

double CanvasChain::getFirstX (    )  [inline]

{ if (ics_xPoints != null) { return ics_xPoints[0]; } return Double.NaN; }

double CanvasChain::getFirstY (    )  [inline]

{ if (ics_yPoints != null) { return ics_yPoints[0]; } return Double.NaN; }

double [] CanvasChain::getXPoints (    )  [inline]

{ return ics_xPoints; }

double [] CanvasChain::getYPoints (    )  [inline]

{ return ics_yPoints; }

int CanvasChain::getNrPoints (    )  [inline]

{ return ics_xPoints.length; }

int [] CanvasChain::getChain (    )  [inline]

{ return freeman; }

boolean CanvasChain::isCircular (    )  [inline]

{ return circular; }

void CanvasChain::setCircular (  boolean    b )  [inline]

{ circular = b; }

boolean CanvasChain::isInsideCcs (  int    x, int    y )  [inline]

To be removed. Reimplemented from CanvasObject. { if (circular) { if (!getTransformOK()) { transformICStoCCS(); } if (ccs_poly != null) { return (ccs_poly.contains(x, y)); } } return false; }

boolean CanvasChain::isNearCcs (  int    x, int    y )  [inline]

To be removed. Reimplemented from CanvasObject. { if (!getTransformOK()) { transformICStoCCS(); } // adapted from 'Graphics Gems II' - James Arvo, // chap. 1.3, 'Distance from a point to a line', pages 10-13. // check if inside enlarged bounding box (== box + SPHERE) if (!((x >= getX1Ccs() - SPHERE) && (x < getX1Ccs() + getWidthCcs() + SPHERE) && (y >= getY1Ccs() - SPHERE) && (y < getY1Ccs() + getHeightCcs() + SPHERE))) { return false; } // we are inside the box, now check each line of the polygon int min_x, min_y, max_x, max_y; int area, abs1, abs2, distance; for (int i=0, j=1; i<ccs_poly.npoints; i++, j++) { if (j == ccs_poly.npoints) { if (!circular) { break; } j = 0; } min_x = Math.min(ccs_poly.xpoints[i], ccs_poly.xpoints[j]); min_y = Math.min(ccs_poly.ypoints[i], ccs_poly.ypoints[j]); max_x = Math.max(ccs_poly.xpoints[i], ccs_poly.xpoints[j]); max_y = Math.max(ccs_poly.ypoints[i], ccs_poly.ypoints[j]); // check if inside enlarged bounding box of line if ((x >= min_x - SPHERE) && (x < max_x + SPHERE) && (y >= min_y - SPHERE) && (y < max_y + SPHERE)) { // calculate the area of the triangle formed by the two // CanvasPolyline points and the 'check' point area = (y - ccs_poly.ypoints[i])* (ccs_poly.xpoints[j] - ccs_poly.xpoints[i]) - (x - ccs_poly.xpoints[i])* (ccs_poly.ypoints[j] - ccs_poly.ypoints[i]); // calculate approximation of distance perpendicular to // CanvasLine abs1 = Math.abs(ccs_poly.xpoints[j] - ccs_poly.xpoints[i]); abs2 = Math.abs(ccs_poly.ypoints[j] - ccs_poly.ypoints[i]); distance = (int)(Math.abs(area) / (abs1 + abs2 - 0.5 * Math.min(abs1, abs2))); // this approximation can also be used as an // approximation for the 'true' distance if (distance <= SPHERE) { return true; } } } return false; }

void CanvasChain::setDimension (  int    w, int    h )  [inline]

Reimplemented from ScribbleObject. { // overrule super.setDimension(w, h), and do nothing return; }

void CanvasChain::doMove (  int    w, int    h )  [inline]

Reimplemented from ScribbleObject. { double shift_x = getX1(); double shift_y = getY1(); super.doMove(w, h); shift_x -= getX1(); shift_y -= getY1(); if (ccs_poly != null) { for (int i=0; i < ccs_poly.npoints; i++) { ics_xPoints[i] -= shift_x; ics_yPoints[i] -= shift_y; } transformICStoCCS(); } }

int CanvasChain::changePoint (  int    index, int    x, int    y )  [inline]

Reimplemented from ScribbleFigure. { // overrule super.changePoint(index, x, y), and do nothing return index; }

void CanvasChain::initChain (  int    chain[], double    x, double    y )  [inline, protected]

{ resizeable = false; if (chain != null) { makeFreemanPoly(x, y, chain); transformICStoCCS(); makePixelChain(); } }

void CanvasChain::transformICStoCCS (    )  [inline, protected]

Perform a full ICS to CCS coordinate transformation. Reimplemented from CanvasObject. { if (ics_xPoints != null) { int[] xs = Converter.ICStoCCS(ics_xPoints, getZoomFactor()); int[] ys = Converter.ICStoCCS(ics_yPoints, getZoomFactor()); ccs_poly = new Polygon(xs, ys, xs.length); setBox(); super.transformICStoCCS(); } }

void CanvasChain::makeFreemanPoly (  double    x, double    y, int    chain[] )  [inline, protected]

{ freeman = new int[chain.length]; for (int i=0; i<chain.length; i++) { freeman[i] = chain[i]; } ics_xPoints = new double[chain.length + 1]; ics_yPoints = new double[chain.length + 1]; ics_xPoints[0] = x; ics_yPoints[0] = y; for (int i=0; i<chain.length; i++) { int direction = chain[i]; switch (direction) { case 0 : ics_xPoints[i+1] = ics_xPoints[i] + 1.; ics_yPoints[i+1] = ics_yPoints[i]; break; case 1 : ics_xPoints[i+1] = ics_xPoints[i] + 1.; ics_yPoints[i+1] = ics_yPoints[i] - 1.; break; case 2 : ics_xPoints[i+1] = ics_xPoints[i]; ics_yPoints[i+1] = ics_yPoints[i] - 1.; break; case 3 : ics_xPoints[i+1] = ics_xPoints[i] - 1.; ics_yPoints[i+1] = ics_yPoints[i] - 1.; break; case 4 : ics_xPoints[i+1] = ics_xPoints[i] - 1.; ics_yPoints[i+1] = ics_yPoints[i]; break; case 5 : ics_xPoints[i+1] = ics_xPoints[i] - 1.; ics_yPoints[i+1] = ics_yPoints[i] + 1.; break; case 6 : ics_xPoints[i+1] = ics_xPoints[i]; ics_yPoints[i+1] = ics_yPoints[i] + 1.; break; case 7 : ics_xPoints[i+1] = ics_xPoints[i] + 1.; ics_yPoints[i+1] = ics_yPoints[i] + 1.; break; } } if ((ics_xPoints[0] == ics_xPoints[chain.length]) && (ics_yPoints[0] == ics_yPoints[chain.length])) { circular = true; } setTransformOK(false); }

void CanvasChain::makePixelChain (    )  [inline, protected]

{ int color = drawColor.getRGB(); int im_w = (int)(getWidth() + 0.5) + 1; int im_h = (int)(getHeight() + 0.5) + 1; int[] pixels = new int[im_w * im_h]; for (int i=0; i<pixels.length; i++) { pixels[i] = 0x00000000; } for (int i=0; i<freeman.length+1; i++) { int im_x = (int)(ics_xPoints[i] - getX1() + 0.5); int im_y = (int)(ics_yPoints[i] - getY1() + 0.5); pixels[im_w*im_y + im_x] = color; } ImageBuffer ib = new ImageBuffer(pixels, im_w, im_h); image = ib.toImage(); }

void CanvasChain::setBox (    )  [inline, protected]

{ if (freeman != null) { double ics_maxX = 0.; double ics_maxY = 0.; setX1(Double.MAX_VALUE); setY1(Double.MAX_VALUE); for (int i=0; i < ics_xPoints.length; i++) { if (ics_xPoints[i] < getX1()) { setX1(ics_xPoints[i]); } if (ics_yPoints[i] < getY1()) { setY1(ics_yPoints[i]); } if (ics_xPoints[i] > ics_maxX) { ics_maxX = ics_xPoints[i]; } if (ics_yPoints[i] > ics_maxY) { ics_maxY = ics_yPoints[i]; } } setWidth(ics_maxX - getX1()); setHeight(ics_maxY - getY1()); setTransformOK(false); } }

---

Member Data Documentation

int [] CanvasChain::freeman = null [protected]

double [] CanvasChain::ics_xPoints = null [protected]

double [] CanvasChain::ics_yPoints = null [protected]

Polygon CanvasChain::ccs_poly = null [protected]

boolean CanvasChain::circular = false [protected]

Image CanvasChain::image = null [protected]

---

The documentation for this class was generated from the following file:

• CanvasChain.java

---