* </p>
*
* <p>
- * Implementations of the Platform class should return subclasses of
- * DoubleBuffer from the _createDoubleBuffer() method. These
- * implementations may choose to use off-screen video ram for this
- * purpose (for example, a Pixmap on X11).
+ * Implementations of the Platform class should return objects
+ * supporting this interface from the _createDoubleBuffer()
+ * method. These implementations may choose to use off-screen video
+ * ram for this purpose (for example, a Pixmap on X11).
* </p>
*
* <p>
* represents regions internally as x,y,w,h.
* </p>
*/
-
public abstract class DoubleBuffer {
- // Methods to Be Overridden//////////////////////////////////////////////////////////////////////////////
+ /** Draw the region of source within (sx1, sy1, sx2, sy2) onto the region of this DoubleBuffer within (dx1, dy1, dx2, dy2), scaling as needed. */
+ public abstract void drawPicture(Picture source, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2);
- /** Stretch the source image to (dx1, dy1, dx2, dy2), but clip it to (cx1, cy1, cx2, cy2) */
- protected abstract void _drawPicture(Picture source, int dx1, int dy1, int dx2, int dy2, int cx1, int cy1, int cx2, int cy2);
+ /** Draw source onto this DoubleBuffer at (x,y) */
+ public abstract void drawPicture(Picture source, int x, int y);
/** Draw <tt>text</tt> in <tt>font</tt> and <tt>color</tt> on this DoubleBuffer, with the upper left corner of the text at (x, y) */
- protected abstract void _drawString(String font, String text, int x, int y, int color);
-
- /** Draw a point at (x, y) */
- protected void _drawPoint(int x, int y, int color) { fillRect(x, y, x + 1, y + 1, color); }
-
- /** Draw a line from (x1, y1) to (x2, y2) that is width pixels wide */
- protected void _drawLine(int x1, int y1, int x2, int y2, int width, int color) {
- if (Math.abs(x1 - x2) < 1) {
- for(int y=Math.min(y1, y2); y<Math.max(y1, y2); y++)
- drawPoint(x1, y, color);
- return;
- }
- if (Math.abs(y1 - y2) < 1) {
- for(int x=Math.min(x1, x2); x<Math.max(x1, x2); x++)
- drawPoint(x, y1, color);
- return;
- }
- if (x1 > x2) {
- int _x1 = x1; x1 = x2; x2 = _x1;
- int _y1 = y1; y1 = y2; y2 = _y1;
- }
- double slope = (double)(y2 - y1) / (double)(x2 - x1);
- int last_y = y1;
- for(int x=x1; x<=x2; x++) {
- int new_y = (int)(slope * (double)(x - x1)) + y1;
- if (slope >= 0) {
- for(int y=last_y + 1; y < new_y; y++) drawPoint(x, y, color);
- } else {
- for(int y=last_y - 1; y > new_y; y--) drawPoint(x, y, color);
- }
- if (x != x2) drawPoint(x, new_y, color);
- last_y = new_y;
- }
- }
+ public abstract void drawString(String font, String text, int x, int y, int color);
/** Fill the region (x1, y1, x2, y2) with <tt>color</tt> (AARRGGBB format); the alpha channel component is ignored */
- protected abstract void _fillRect(int x1, int y1, int x2, int y2, int color);
-
- /** Fill in the trapezoid defined by (x1, y1), (x2, y1), (x3, y2), (x4, y2); leftSlope and rightSlope are provided for convenience */
- protected void _fillTrapezoid(int x1, int x2, int y1, int x3, int x4, int y2, double leftSlope, double rightSlope, int color) {
- for(int y=y1; y<y2; y++) {
- int _x1 = (int)Math.floor((y - y1) * leftSlope + x1);
- int _y1 = (int)Math.floor(y);
- int _x2 = (int)Math.ceil((y - y1) * rightSlope + x2);
- int _y2 = (int)Math.floor(y) + 1;
- if (_x1 > _x2) { int _x0 = _x1; _x1 = _x2; _x2 = _x0; }
- fillRect(_x1, _y1, _x2, _y2, color);
- }
- }
-
-
- // Internal Stuff //////////////////////////////////////////////////////////////////////////////
-
- protected int width, height;
- private int clipx = 0, clipy = 0, clipw, cliph;
- private DoubleBuffer() { }
- protected DoubleBuffer(int width, int height) { this.width = width; this.height = height; clipw = width; cliph = height; }
- protected SVG.Affine ctm = null;
-
-
- // Final methods //////////////////////////////////////////////////////////////////////////////
-
- public final int getHeight() { return width; }
- public final int getWidth() { return height; }
- public final void setTransform(SVG.Affine ctm) { this.ctm = ctm; }
- public final void setClip(int x, int y, int x2, int y2) { clipx = x; clipy = y; clipw = x2 - x; cliph = y2 - y; }
- public final void drawPicture(Picture p, int x, int y) { drawPicture(p, x, y, x + p.getWidth(), y + p.getHeight(), 0, 0, p.getWidth(), p.getHeight()); }
-
- public final void drawPoint(int x, int y, int color) {
- if (x > clipx && x < clipx + clipw && y > clipy && y < clipy + cliph)
- _drawPoint(x, y, color);
- }
-
- public final void drawLine(int x1, int y1, int x2, int y2, int width, int color) {
-
- if (x1 == x2 || y1 == y2) return;
-
- // FIXME: don't compute slope if not needed
- double slope = (y2 - y1) / (x2 - x1);
- if (x1 < clipx) { y1 = (int)((clipx - x1) * slope + y1); x1 = clipx; }
- if (y1 < clipy) { x1 = (int)((clipy - y1) / slope + x1); y1 = clipy; }
- if (x2 > clipx + clipw) { x2 = clipx + clipw; y2 = (int)((x2 - x1) / slope + y1); }
- if (y2 > clipy + cliph) { y2 = clipy + cliph; x2 = (int)((y2 - y1) * slope + y1); }
-
- _drawLine(x1, y1, x2, y2, width, color);
- }
-
- /** Stretch the picture to fill (dx1, dy1, dx2, dy2) and blit it, clipping to (cx1, cy1, cx2, cy2) */
- public final void drawPicture(Picture source, int dx1, int dy1, int dx2, int dy2, int cx1, int cy1, int cx2, int cy2) {
-
- if (org.xwt.util.Log.assertionsEnabled) {
- if (dx1 >= dx2) org.xwt.util.Log.log(DoubleBuffer.class, "drawPicture(): dx1 >= dx2: dx1=" + dx1 + " dx2=" + dx2, true);
- if (dy1 >= dy2) org.xwt.util.Log.log(DoubleBuffer.class, "drawPicture(): dy1 >= dy2: dy1=" + dy1 + " dy2=" + dy2, true);
- if (cx1 >= cx2) org.xwt.util.Log.log(DoubleBuffer.class, "drawPicture(): cx1 >= cx2: cx1=" + cx1 + " cx2=" + cx2, true);
- if (cy1 >= cy2) org.xwt.util.Log.log(DoubleBuffer.class, "drawPicture(): cy1 >= cy2: cy1=" + cy1 + " cy2=" + cy2, true);
- }
-
- // shrink clipping rectangle to be no bigger than drawing rectangle
- if (cx1 < dx1) cx1 = dx1;
- if (cy1 < dy1) cy1 = dy1;
- if (cx2 > dx2) cx2 = dx2;
- if (cy2 > dy2) cy2 = dy2;
-
- // intersect the two clipping regions
- if (cx2 < clipx) return;
- if (cy2 < clipy) return;
- if (cx1 > clipx + clipw) return;
- if (cy1 > clipy + cliph) return;
- if (cx1 < clipx) cx1 = clipx;
- if (cy1 < clipy) cy1 = clipy;
- if (cx2 > clipx + clipw) cx2 = clipx + clipw;
- if (cy2 > clipy + cliph) cy2 = clipy + cliph;
-
- if (ctm == null) {
- _drawPicture(source, dx1, dy1, dx2, dy2, cx1, cy1, cx2, cy2);
- } else {
- _drawPicture(source,
- (int)ctm.multiply_px(dx1, dy1), (int)ctm.multiply_py(dx1, dy1),
- (int)ctm.multiply_px(dx2, dy2), (int)ctm.multiply_py(dx2, dy2),
- (int)ctm.multiply_px(cx1, cy1), (int)ctm.multiply_py(cx1, cy1),
- (int)ctm.multiply_px(cx2, cy2), (int)ctm.multiply_py(cx2, cy2));
- }
- }
-
- public final void drawString(String font, String text, int x, int y, int color) {
- // FIXME: clipping
- if (ctm == null) {
- _drawString(font, text, x, y, color);
- } else {
- _drawString(font, text, (int)ctm.multiply_px(x, y), (int)ctm.multiply_py(x, y), color);
- }
- }
-
- public final void fillRect(int x1, int y1, int x2, int y2, int color) {
-
- x1 = Math.max(Math.min(clipx + clipw, x1), clipx);
- x2 = Math.max(Math.min(clipx + clipw, x2), clipx);
- y1 = Math.max(Math.min(clipy + cliph, y1), clipy);
- y2 = Math.max(Math.min(clipy + cliph, y2), clipy);
-
- if (ctm == null) {
- _fillRect(x1, y1, x2, y2, color);
- } else {
- _fillRect((int)ctm.multiply_px(x1, y1), (int)ctm.multiply_py(x1, y1),
- (int)ctm.multiply_px(x2, y2), (int)ctm.multiply_py(x2, y2),
- color);
- }
- }
-
- public final void fillTrapezoid(int x1, int x2, int y1, int x3, int x4, int y2, int color) {
- fillTrapezoid(x1, x2, y1, x3, x4, y2, (double)(x3 - x1) / (double)(y2 - y1), (double)(x4 - x2) / (double)(y2 - y1), color);
- }
-
- private final void fillTrapezoid(int x1, int x2, int y1, int x3, int x4, int y2, double slope1, double slope2, int color) {
-
- // invariant: x1 <= x2, x3 <= x4, y1 <= y2
- if (y1 == y2) return;
- if (org.xwt.util.Log.assertionsEnabled) {
- if (x1 > x2) org.xwt.util.Log.log(DoubleBuffer.class, "fillTrapezoid(): x1 > x2: x1=" + x1 + " x2=" + x2, true);
- if (x3 > x4) org.xwt.util.Log.log(DoubleBuffer.class, "fillTrapezoid(): x3 > x4: x3=" + x3 + " x4=" + x4, true);
- if (y1 >= y2) org.xwt.util.Log.log(DoubleBuffer.class, "fillTrapezoid(): y1 >= y2: y1=" + y1 + " y2=" + y2, true);
- }
-
- // clip top and bottom edges
- if (y1 > clipy + cliph) return;
- if (y2 < clipy) return;
- if (y1 < clipy) { x1 = (int)(y1 + slope1 * clipy); x2 = (int)(y1 + slope2 * clipy); y1 = clipy; }
- if (y2 > clipy + cliph) { y2 = clipy + cliph; x3 = (int)(y1 + slope1 * y2); x4 = (int)(slope2 * y2); }
-
- if (x1 < clipx && x3 < clipx) {
- x1 = x3 = clipx;
- } else if (!(x1 >= clipx && x3 >= clipx)) {
- int y = (int)((clipx - x1) / slope1 + y1);
- int x = (int)(slope2 * (y - y2) + x2);
- // we have to recurse here because we don't know which subtrapezoid might get split on the other side
- fillTrapezoid(x1, x2, y1, clipx, x, y, slope1, slope2, color);
- fillTrapezoid(clipx, x, y, x3, x4, y2, slope1, slope2, color);
- return;
- }
-
- if (x2 >= clipx + clipw && x4 >= clipx + clipw) {
- x2 = x4 = clipx + clipw;
- } else if (!(x2 < clipx + clipw && x4 < clipx + clipw)) {
- int y = (int)((clipx + clipw - x3) / slope2 + y1);
- int x = (int)(slope1 * (y - y1) + x1);
- _fillTrapezoid(x1, x2, y1, x, clipx + clipw, y, slope1, slope2, color);
- _fillTrapezoid(x, clipx + clipw, y, x3, x4, y2, slope1, slope2, color);
- return;
- }
+ public abstract void fillRect(int x1, int y1, int x2, int y2, int color);
- _fillTrapezoid(x1, x2, y1, x3, x4, y2, slope1, slope2, color);
- }
+ /** Sets the clip region for this DoubleBuffer to (x,y,x2,y2) */
+ public abstract void setClip(int x, int y, int x2, int y2);
+ public abstract int getHeight();
+ public abstract int getWidth();
}