com.gargoylesoftware.htmlunit.javascript.host.canvas.rendering

Interface RenderingBackend

All Known Implementing Classes:

AwtRenderingBackend

public interface RenderingBackend

Interface to the rendering context used by CanvasRenderingContext2D.

Author:

Ronald Brill

Method Summary

Modifier and Type	Method and Description
void	arc(double x, double y, double radius, double startAngle, double endAngle, boolean anticlockwise) Adds a circular arc to the current sub-path.
void	beginPath() Starts a new path by emptying the list of sub-paths.
void	bezierCurveTo(double cp1x, double cp1y, double cp2x, double cp2y, double x, double y) Adds a cubic Bézier curve to the current sub-path.
void	clearRect(int x, int y, int w, int h) Paints the specified rectangular area.
void	drawImage(ImageReader imageReader, int dxI, int dyI) Draws images onto the context.
String	encodeToString(String type) Constructs a base64 encoded string out of the image data.
void	fill() Fills the current or given path with the current fillStyle.
void	fillRect(int x, int y, int w, int h) Paints the specified rectangular area.
void	fillText(String text, int x, int y) Fills a given text at the given (x, y) position.
byte[]	getBytes(int width, int height, int sx, int sy) Creates a byte array containing the (4) color values of all pixels.
int	getLineWidth() Returns the lineWidth property.
void	lineTo(double x, double y) Adds a straight line to the current sub-path by connecting the sub-path's last point to the specified (x, y) coordinates.
void	moveTo(double x, double y) Begins a new sub-path at the point specified by the given (x, y) coordinates.
void	quadraticCurveTo(double cpx, double cpy, double x, double y) Adds a quadratic Bézier curve to the current sub-path.
void	rect(double x, double y, double w, double h) Adds a rectangle to the current path.
void	restore() Restores the most recently saved canvas state by popping the top entry in the drawing state stack.
void	rotate(double angle) Adds a rotation to the transformation matrix.
void	save() Saves the entire state of the canvas by pushing the current state onto a stack.
void	setFillStyle(String fillStyle) Sets the fillStyle property.
void	setLineWidth(int lineWidth) Sets the lineWidth property.
void	setStrokeStyle(String strokeStyle) Sets the strokeStyle property.
void	setTransform(double m11, double m12, double m21, double m22, double dx, double dy) Resets (overrides) the current transformation to the identity matrix, and then invokes a transformation described by the arguments of this method.
void	stroke() Strokes (outlines) the current or given path with the current stroke style.
void	strokeRect(int x, int y, int w, int h) Paints the specified rectangular area.
void	transform(double m11, double m12, double m21, double m22, double dx, double dy) Multiplies the current transformation with the matrix described by the arguments of this method.
void	translate(int x, int y) Adds a translation transformation to the current matrix.

Method Detail

beginPath

void beginPath()

Starts a new path by emptying the list of sub-paths.

bezierCurveTo

void bezierCurveTo(double cp1x,
                   double cp1y,
                   double cp2x,
                   double cp2y,
                   double x,
                   double y)

Adds a cubic Bézier curve to the current sub-path. It requires three points: the first two are control points and the third one is the end point. The starting point is the latest point in the current path, which can be changed using moveTo() before creating the Bézier curve.

Parameters:

cp1x - the cp1x

cp1y - the cp1y

cp2x - the cp2x

cp2y - the cp2y

x - the x

y - the y

arc

void arc(double x,
         double y,
         double radius,
         double startAngle,
         double endAngle,
         boolean anticlockwise)

Adds a circular arc to the current sub-path.

Parameters:

x - the x

y - the y

radius - the radius

startAngle - the start angle

endAngle - the end angle

anticlockwise - is anti-clockwise

clearRect

void clearRect(int x,
               int y,
               int w,
               int h)

Paints the specified rectangular area.

Parameters:

x - the x

y - the y

w - the width

h - the height

drawImage

void drawImage(ImageReader imageReader,
               int dxI,
               int dyI)
        throws IOException

Draws images onto the context.

Parameters:

imageReader - the reader to read the image from 8the first one)

dxI - the x coordinate of the starting point (top left)

dyI - the y coordinate of the starting point (top left)

Throws:

IOException - in case o problems

encodeToString

String encodeToString(String type)
               throws IOException

Constructs a base64 encoded string out of the image data.

Parameters:

type - the name of the image format

Returns:

the base64 encoded string

Throws:

IOException - in case o problems

fill

void fill()

Fills the current or given path with the current fillStyle.

fillRect

void fillRect(int x,
              int y,
              int w,
              int h)

Paints the specified rectangular area.

Parameters:

x - the x

y - the y

w - the width

h - the height

fillText

void fillText(String text,
              int x,
              int y)

Fills a given text at the given (x, y) position.

Parameters:

text - the text

x - the x

y - the y

getBytes

byte[] getBytes(int width,
                int height,
                int sx,
                int sy)

Creates a byte array containing the (4) color values of all pixels.

Parameters:

width - the width

height - the height

sx - start point x

sy - start point y

Returns:

the bytes

lineTo

void lineTo(double x,
            double y)

Adds a straight line to the current sub-path by connecting the sub-path's last point to the specified (x, y) coordinates.

Parameters:

x - the x

y - the y

moveTo

void moveTo(double x,
            double y)

Begins a new sub-path at the point specified by the given (x, y) coordinates.

Parameters:

x - the x

y - the y

quadraticCurveTo

void quadraticCurveTo(double cpx,
                      double cpy,
                      double x,
                      double y)

Adds a quadratic Bézier curve to the current sub-path. It requires two points: the first one is a control point and the second one is the end point. The starting point is the latest point in the current path, which can be changed using moveTo() before creating the quadratic Bézier curve.

Parameters:

cpx - the cpx

cpy - the cpy

x - the x

y - the y

rect

void rect(double x,
          double y,
          double w,
          double h)

Adds a rectangle to the current path.

Parameters:

x - the x

y - the y

w - the width

h - the height

restore

void restore()

Restores the most recently saved canvas state by popping the top entry in the drawing state stack. If there is no saved state, this method does nothing.

rotate

void rotate(double angle)

Adds a rotation to the transformation matrix.

Parameters:

angle - the angle

save

void save()

Saves the entire state of the canvas by pushing the current state onto a stack.

setFillStyle

void setFillStyle(String fillStyle)

Sets the fillStyle property.

Parameters:

fillStyle - the fillStyle property

setStrokeStyle

void setStrokeStyle(String strokeStyle)

Sets the strokeStyle property.

Parameters:

strokeStyle - the strokeStyle property

getLineWidth

int getLineWidth()

Returns the lineWidth property.

Returns:

the lineWidth property

setLineWidth

void setLineWidth(int lineWidth)

Sets the lineWidth property.

Parameters:

lineWidth - the lineWidth property

setTransform

void setTransform(double m11,
                  double m12,
                  double m21,
                  double m22,
                  double dx,
                  double dy)

Resets (overrides) the current transformation to the identity matrix, and then invokes a transformation described by the arguments of this method. This lets you scale, rotate, translate (move), and skew the context.

Parameters:

m11 - Horizontal scaling. A value of 1 results in no scaling

m12 - Vertical skewing

m21 - Horizontal skewing

m22 - Vertical scaling. A value of 1 results in no scaling

dx - Horizontal translation (moving)

dy - Vertical translation (moving).

stroke

void stroke()

Strokes (outlines) the current or given path with the current stroke style.

strokeRect

void strokeRect(int x,
                int y,
                int w,
                int h)

Paints the specified rectangular area.

Parameters:

x - the x

y - the y

w - the width

h - the height

transform

void transform(double m11,
               double m12,
               double m21,
               double m22,
               double dx,
               double dy)

Multiplies the current transformation with the matrix described by the arguments of this method. This lets you scale, rotate, translate (move), and skew the context.

Parameters:

m11 - Horizontal scaling. A value of 1 results in no scaling

m12 - Vertical skewing

m21 - Horizontal skewing

m22 - Vertical scaling. A value of 1 results in no scaling

dx - Horizontal translation (moving)

dy - Vertical translation (moving).

translate

void translate(int x,
               int y)

Adds a translation transformation to the current matrix.

Parameters:

x - the x

y - the y