[gwt-contrib] [google-web-toolkit] r9341 committed - Improve Canvas 2D documentation...

codesite-noreply Thu, 02 Dec 2010 09:55:00 -0800

Revision: 9341
Author: gwt.mirror...@gmail.com
Date: Thu Dec  2 09:52:19 2010
Log: Improve Canvas 2D documentation


Review at http://gwt-code-reviews.appspot.com/1165801

Review by: p...@google.com
http://code.google.com/p/google-web-toolkit/source/detail?r=9341

Added:
 /trunk/user/src/com/google/gwt/canvas/client/package-info.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/package-info.java
Modified:
 /trunk/user/src/com/google/gwt/canvas/client/Canvas.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasGradient.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasPattern.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasPixelArray.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/Context.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/Context2d.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/CssColor.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/FillStrokeStyle.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/ImageData.java
 /trunk/user/src/com/google/gwt/canvas/dom/client/TextMetrics.java
 /trunk/user/src/com/google/gwt/dom/client/CanvasElement.java
 /trunk/user/src/com/google/gwt/dom/client/Document.java
 /trunk/user/src/com/google/gwt/user/client/IsSupported.java

=======================================
--- /dev/null

+++ /trunk/user/src/com/google/gwt/canvas/client/package-info.java Thu Dec2 09:52:19 2010

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2010 Google Inc.
+ *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you maynot+ * use this file except in compliance with the License. You may obtain acopy of

+ * the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software

+ * distributed under the License is distributed on an "AS IS" BASIS,WITHOUT

+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ * License for the specific language governing permissions and limitationsunder

+ * the License.
+ */
+
+/**
+ * Classes for HTML Canvas 2D support.
+ */
+...@com.google.gwt.util.preventspuriousrebuilds
+package com.google.gwt.canvas.client;
=======================================
--- /dev/null

+++ /trunk/user/src/com/google/gwt/canvas/dom/client/package-info.java ThuDec 2 09:52:19 2010

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2010 Google Inc.
+ *

+ * Licensed under the Apache License, Version 2.0 (the "License"); you maynot+ * use this file except in compliance with the License. You may obtain acopy of

+ * the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software

+ * distributed under the License is distributed on an "AS IS" BASIS,WITHOUT

+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

+ * License for the specific language governing permissions and limitationsunder

+ * the License.
+ */
+
+/**
+ * Classes for HTML Canvas 2D support.
+ */
+...@com.google.gwt.util.preventspuriousrebuilds
+package com.google.gwt.canvas.dom.client;
=======================================

--- /trunk/user/src/com/google/gwt/canvas/client/Canvas.java Tue Nov 3006:11:17 2010+++ /trunk/user/src/com/google/gwt/canvas/client/Canvas.java Thu Dec 209:52:19 2010

@@ -34,6 +34,7 @@

* This widget may not be supported on all browsers, see {...@linkIsSupported}

  */
 public class Canvas extends FocusWidget implements IsSupported {
+
   /**

* Runtime check for whether the canvas element is supported in thisbrowser.

    * See {...@link IsSupported}
@@ -63,6 +64,7 @@
   /**
    * Gets the rendering context that may be used to draw on this canvas.
    *
+   * @param contextId the context id as a String
    * @return the canvas rendering context
    */
   public Context getContext(String contextId) {
@@ -72,7 +74,7 @@
   /**
    * Returns a 2D rendering context.
    *
-   * This is a convenience method, @see {...@link #getContext(String)}
+   * This is a convenience method, see {...@link #getContext(String)}.
    *
    * @return a 2D canvas rendering context
    */
@@ -84,6 +86,7 @@
    * Gets the height of the internal canvas coordinate space.
    *
    * @return the height, in pixels
+   * @see #setCoordinateSpaceHeight(int)
    */
   public int getCoordinateSpaceHeight() {
     return getCanvasElement().getHeight();
@@ -93,6 +96,7 @@
    * Gets the width of the internal canvas coordinate space.
    *
    * @return the width, in pixels
+   * @see #setCoordinateSpaceWidth(int)
    */
   public int getCoordinateSpaceWidth() {
     return getCanvasElement().getWidth();
@@ -102,6 +106,7 @@
    * Sets the height of the internal canvas coordinate space.
    *
    * @param height the height, in pixels
+   * @see #getCoordinateSpaceHeight()
    */
   public void setCoordinateSpaceHeight(int height) {
     getCanvasElement().setHeight(height);
@@ -111,6 +116,7 @@
    * Sets the width of the internal canvas coordinate space.
    *
    * @param width the width, in pixels
+   * @see #getCoordinateSpaceWidth()
    */
   public void setCoordinateSpaceWidth(int width) {
     getCanvasElement().setWidth(width);
@@ -126,10 +132,12 @@
   }

   /**

- * Returns a data URL for the current content of the canvas element,with a specified type.+ * Returns a data URL for the current content of the canvas element,with a

+   * specified type.
    *
    * @param type the type of the data url, e.g., image/jpeg or image/png.

- * @return a data URL for the current content of this element with thespecified type.

+   * @return a data URL for the current content of this element with the
+   *         specified type.
    */
   public String toDataUrl(String type) {
     return getCanvasElement().toDataUrl(type);
=======================================

--- /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasGradient.javaTue Nov 30 06:11:17 2010+++ /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasGradient.javaThu Dec 2 09:52:19 2010

@@ -24,9 +24,10 @@
  * </span>
  * </p>
  *

- * This class serves as a reference to a gradient created using {...@linkContext2d#createPattern}

+ * This class serves as a reference to a gradient created using
+ * {...@link Context2d#createPattern}.
  *

- * @see <ahref="http://www.w3.org/TR/2dcontext/#canvasgradient";>CanvasGradient</a>+ * @see <a href="http://www.w3.org/TR/2dcontext/#canvasgradient";>HTMLCanvas 2D CanvasGradient</a>

  */
 public class CanvasGradient extends FillStrokeStyle {

=======================================

--- /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasPattern.java TueNov 30 06:11:17 2010+++ /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasPattern.java ThuDec 2 09:52:19 2010

@@ -27,7 +27,7 @@

* Note that this class has no methods. It simply serves as a reference toa

  * pattern created using {...@link Context2d#createPattern}.
  *

- * @see <ahref="http://www.w3.org/TR/2dcontext/#canvaspattern";>CanvasPattern</a>+ * @see <a href="http://www.w3.org/TR/2dcontext/#canvaspattern";>HTMLCanvas 2D CanvasPattern</a>

  */
 public class CanvasPattern extends FillStrokeStyle {

=======================================

--- /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasPixelArray.javaTue Nov 30 06:11:17 2010+++ /trunk/user/src/com/google/gwt/canvas/dom/client/CanvasPixelArray.javaThu Dec 2 06:15:06 2010

@@ -18,15 +18,17 @@
 import com.google.gwt.core.client.JavaScriptObject;

 /**

- * Array-like object holding the actual image data for an ImageDataobject. For each pixel,+ * Array-like object holding the actual image data for an ImageDataobject. For each pixel,* this object contains a red, green, blue and alpha value between 0 and255 (in this order).* Note that we use ints here to represent the data to avoid complexitiesstemming from

  * bytes being signed in Java.
- *
+ *
  * <p>

* <span style="color:red">Experimental API: This class is still underrapid

  * development, and is very likely to be deleted. Use it at your own risk.
  * </span>
+ *

+ * @see <a href="http://www.w3.org/TR/2dcontext/#canvaspixelarray";>HTMLCanvas 2D CanvasPixelArray</a>

  * </p>
  */
 public class CanvasPixelArray extends JavaScriptObject {
@@ -36,6 +38,9 @@

   /**
    * Returns the data value at index i.
+   *
+   * @param i the data index
+   * @return the data value
    */
   public final native int get(int i) /*-{
     return this[i] || 0;
@@ -43,6 +48,8 @@

   /**
    * Returns the length of the array.
+   *
+   * @return the array length
    */
   public final native int getLength() /*-{
     return this.length;
@@ -50,10 +57,10 @@

   /**
    * Sets the data value at position i to the given value.
-   *

- * Most browsers will clamp this value to the range 0...255 that is notenforced in this

-   * implementation.
-   *
+   *

+ * Most browsers will clamp this value to the range 0...255, but that isnot

+   * enforced in this implementation.
+   *
    * @param i index to set.
    * @param value value to set (use values from 0 to 255)
    */
=======================================

--- /trunk/user/src/com/google/gwt/canvas/dom/client/Context.java Tue Nov30 06:11:17 2010+++ /trunk/user/src/com/google/gwt/canvas/dom/client/Context.java Thu Dec2 06:15:06 2010

@@ -16,7 +16,8 @@
 package com.google.gwt.canvas.dom.client;

 /**
- * Rendering Context interface used to draw on a {...@link CanvasElement}.
+ * Rendering Context interface used to draw on a
+ * {...@link com.google.gwt.dom.client.CanvasElement}.
  *
  * <p>

* <span style="color:red">Experimental API: This class is still underrapid

=======================================

--- /trunk/user/src/com/google/gwt/canvas/dom/client/Context2d.java Tue Nov30 06:11:17 2010+++ /trunk/user/src/com/google/gwt/canvas/dom/client/Context2d.java ThuDec 2 06:15:06 2010

@@ -1,12 +1,12 @@
 /*
  * Copyright 2010 Google Inc.
- *
+ *

* Licensed under the Apache License, Version 2.0 (the "License"); you maynot* use this file except in compliance with the License. You may obtain acopy of

  * the License at
- *
+ *
  * http://www.apache.org/licenses/LICENSE-2.0
- *
+ *
  * Unless required by applicable law or agreed to in writing, software

* distributed under the License is distributed on an "AS IS" BASIS,WITHOUT

  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
@@ -22,34 +22,92 @@

 /**
  * Rendering interface used to draw on a {...@link CanvasElement}.
- *
+ *
  * <p>

* <span style="color:red">Experimental API: This class is still underrapid

  * development, and is very likely to be deleted. Use it at your own risk.
  * </span>
  * </p>
- *
+ *

* @see <ahref="http://www.w3.org/TR/2dcontext/#canvasrenderingcontext2d";>W3C

  *      HTML 5 Specification</a>
  */
 public class Context2d extends JavaScriptObject implements Context {
   /**
-   * Specifies the context id property used in creating a Context.
+   * Enum for composite style.
+   *
+   * @see Context2d#setGlobalCompositeOperation(Composite)
    */
-  public static final String CONTEXT_ID = "2d";
-
-  /**
-   * Enum for the repetition values.
-   *
-   * @see Context2d#createPattern(ImageElement, Repetition)
-   * @see Context2d#createPattern(CanvasElement, Repetition)
-   */
-  public enum Repetition {

- REPEAT("repeat"), REPEAT_X("repeat-x"), REPEAT_Y("repeat-y"),NO_REPEAT("no-repeat");

+  public enum Composite {
+    /**

+ * A (B is ignored). Display the source image instead of thedestination

+     * image.
+     */
+    COPY("copy"),
+
+    /**

+ * B atop A. Same as source-atop but using the destination imageinstead of

+     * the source image and vice versa.
+     */
+    DESTINATION_ATOP("destination-atop"),
+
+    /**

+ * B in A. Same as source-in but using the destination image insteadof the

+     * source image and vice versa.
+     */
+    DESTINATION_IN("destination-in"),
+
+    /**

+ * B out A. Same as source-out but using the destination image insteadof the

+     * source image and vice versa.
+     */
+    DESTINATION_OUT("destination-out"),
+
+    /**

+ * B over A. Same as source-over but using the destination imageinstead of

+     * the source image and vice versa.
+     */
+    DESTINATION_OVER("destination-over"),
+
+    /**

+ * A plus B. Display the sum of the source image and destinationimage, with

+     * color values approaching 1 as a limit.
+     */
+    LIGHTER("lighter"),
+
+    /**

+ * A atop B. Display the source image wherever both images are opaque.Display+ * the destination image wherever the destination image is opaque butthe

+     * source image is transparent. Display transparency elsewhere.
+     */
+    SOURCE_ATOP("source-atop"),
+
+    /**
+     * A in B. Display the source image wherever both the source image and
+     * destination image are opaque. Display transparency elsewhere.
+     */
+    SOURCE_IN("source-in"),
+
+    /**

+ * A out B. Display the source image wherever the source image isopaque and+ * the destination image is transparent. Display transparencyelsewhere.

+     */
+    SOURCE_OUT("source-out"),
+
+    /**

+ * A over B. Display the source image wherever the source image isopaque.

+     * Display the destination image elsewhere.
+     */
+    SOURCE_OVER("source-over"),
+
+    /**
+     * A xor B. Exclusive OR of the source image and destination image.
+     */
+    XOR("xor");

     private final String value;

-    private Repetition(String value) {
+    private Composite(String value) {
       this.value = value;
     }

@@ -60,7 +118,7 @@

   /**
    * Enum for line-cap style.
-   *
+   *
    * @see Context2d#setLineCap(LineCap)
    */
   public enum LineCap {
@@ -79,11 +137,11 @@

   /**
    * Enum for line-join style.
-   *
+   *
    * @see Context2d#setLineJoin(LineJoin)
    */
   public enum LineJoin {
-    ROUND("round"), BEVEL("bevel"), MITER("miter");
+    BEVEL("bevel"), MITER("miter"), ROUND("round");

     private final String value;

@@ -97,80 +155,17 @@
   }

   /**
-   * Enum for composite style.
-   *
-   * @see Context2d#setGlobalCompositeOperation(Composite)
+   * Enum for the repetition values.
+   *
+   * @see Context2d#createPattern(ImageElement, Repetition)
+   * @see Context2d#createPattern(CanvasElement, Repetition)
    */
-  public enum Composite {
-    /**

- * A atop B. Display the source image wherever both images are opaque.Display- * the destination image wherever the destination image is opaque butthe

-     * source image is transparent. Display transparency elsewhere.
-     */
-    SOURCE_ATOP("source-atop"),
-
-    /**
-     * A in B. Display the source image wherever both the source image and
-     * destination image are opaque. Display transparency elsewhere.
-     */
-    SOURCE_IN("source-in"),
-
-    /**

- * A out B. Display the source image wherever the source image isopaque and- * the destination image is transparent. Display transparencyelsewhere.

-     */
-    SOURCE_OUT("source-out"),
-
-    /**

- * A over B. Display the source image wherever the source image isopaque.

-     * Display the destination image elsewhere.
-     */
-    SOURCE_OVER("source-over"),
-
-    /**

- * B atop A. Same as source-atop but using the destination imageinstead of

-     * the source image and vice versa.
-     */
-    DESTINATION_ATOP("destination-atop"),
-
-    /**

- * B in A. Same as source-in but using the destination image insteadof the

-     * source image and vice versa.
-     */
-    DESTINATION_IN("destination-in"),
-
-    /**

- * B out A. Same as source-out but using the destination image insteadof the

-     * source image and vice versa.
-     */
-    DESTINATION_OUT("destination-out"),
-
-    /**

- * B over A. Same as source-over but using the destination imageinstead of

-     * the source image and vice versa.
-     */
-    DESTINATION_OVER("destination-over"),
-
-    /**

- * A plus B. Display the sum of the source image and destinationimage, with

-     * color values approaching 1 as a limit.
-     */
-    LIGHTER("lighter"),
-
-    /**

- * A (B is ignored). Display the source image instead of thedestination

-     * image.
-     */
-    COPY("copy"),
-
-    /**
-     * A xor B. Exclusive OR of the source image and destination image.
-     */
-    XOR("xor");
+  public enum Repetition {

+ NO_REPEAT("no-repeat"), REPEAT("repeat"), REPEAT_X("repeat-x"),REPEAT_Y("repeat-y");


     private final String value;

-    private Composite(String value) {
+    private Repetition(String value) {
       this.value = value;
     }

@@ -181,11 +176,11 @@

   /**
    * Enum for text align style.
-   *
+   *
    * @see Context2d#setTextAlign(TextAlign)
    */
   public enum TextAlign {

- START("start"), END("end"), LEFT("left"), RIGHT("right"),CENTER("center");+ CENTER("center"), END("end"), LEFT("left"), RIGHT("right"),START("start");


     private final String value;

@@ -200,12 +195,12 @@

   /**
    * Enum for text baseline style.
-   *
+   *
    * @see Context2d#setTextBaseline(TextBaseline)
    */
   public enum TextBaseline {

- TOP("top"), HANGING("hanging"), MIDDLE("middle"),ALPHABETIC("alphabetic"),

-    IDEOGRAPHIC("ideographic"), BOTTOM("bottom");

+ ALPHABETIC("alphabetic"), BOTTOM("bottom"), HANGING("hanging"),IDEOGRAPHIC("ideographic"),

+    MIDDLE("middle"), TOP("top");

     private final String value;

@@ -217,20 +212,51 @@
       return value;
     }
   }
+
+  /**
+   * Specifies the context id property used in creating a Context.
+   */
+  public static final String CONTEXT_ID = "2d";

   protected Context2d() {
   }

   /**
-   * Draws an arc.

+ * Draws an arc. If a current subpath exists, a line segment is addedfrom the

+   * current point to the starting point of the arc. If {...@code endAngle -

+ * startAngle} is equal to or greater than {...@code 2 * Math.Pi}, the arcis the

+   * whole circumference of the circle.
+   *
+   * @param x the x coordinate of the center of the arc
+   * @param y the y coordinate of the center of the arc
+   * @param radius the radius of the arc

+ * @param startAngle the start angle, measured in radians clockwise fromthe

+   *          positive x-axis
+   * @param endAngle the end angle, measured in radians clockwise from the
+   *          positive x-axis
    */

- public final native void arc(float x, float y, float radius, floatstartAngle,+ public final native void arc(float x, float y, float radius, floatstartAngle,

       float endAngle) /*-{
     this.arc(x, y, radius, startAngle, endAngle);
   }-*/;

   /**
-   * Draws an arc.

+ * Draws an arc. If a current subpath exists, a line segment is addedfrom the+ * current point to the starting point of the arc. If {...@codeanticlockwise} is+ * false and {...@code endAngle - startAngle} is equal to or greater than{...@code

+   * 2 * Math.PI}, or if {...@code anticlockwise} is {...@code true} and 
{...@code

+ * startAngle - endAngle} is equal to or greater than {...@code 2 *Math.PI},

+   * then the arc is the whole circumference of the circle.
+   *
+   * @param x the x coordinate of the center of the arc
+   * @param y the y coordinate of the center of the arc
+   * @param radius the radius of the arc

+ * @param startAngle the start angle, measured in radians clockwise fromthe

+   *          positive x-axis
+   * @param endAngle the end angle, measured in radians clockwise from the
+   *          positive x-axis

+ * @param anticlockwise if {...@code true}, the arc is drawn in ananticlockwise

+   *       direction
    */

public final native void arc(float x, float y, float radius, floatstartAngle, float endAngle,

       boolean anticlockwise) /*-{
@@ -238,7 +264,14 @@
   }-*/;

   /**
-   * Draws an arc.
+   * Adds an arc to the current subpath, connecting it to the current point
+   * with a line segment.
+   *
+   * @param x1 the x coordinate of the starting point of the arc
+   * @param y1 the y coordinate of the starting point of the arc
+   * @param x2 the x coordinate of the ending point of the arc
+   * @param y2 the y coordinate of the ending point of the arc
+   * @param radius the radius of a circle containing the arc
    */

public final native void arcTo(float x1, float y1, float x2, float y2,float radius) /*-{

     this.arcTo(x1, y1, x2, y2, radius);
@@ -252,15 +285,28 @@
   }-*/;

   /**
-   * Draws a Bezier curve.
+   * Draws a cubic B\u00e9zier curve from the current point to the point
+   * (x, y), with control points (cp1x, cp1y) and (cp2x, cp2y).
+   *
+   * @param cp1x the x coordinate of the first control point
+   * @param cp1y the y coordinate of the first control point
+   * @param cp2x the x coordinate of the second control point
+   * @param cp2y the y coordinate of the second control point
+   * @param x the x coordinate of the end point
+   * @param y the y coordinate of the end point
    */

- public final native void bezierCurveTo(float cp1x, float cp1y, floatcp2x, float cp2y, float x,

-      float y) /*-{
+  public final native void bezierCurveTo(float cp1x, float cp1y,
+      float cp2x, float cp2y, float x, float y) /*-{
     this.bezierCurveTo(cp1x, cp1y, cp2x, cp2y, x, y);
   }-*/;

   /**
    * Clears a rectangle.
+   *
+   * @param x the x coordinate of the rectangle's upper-left corner
+   * @param y the y coordinate of the rectangle's upper-left corner
+   * @param w the width of the rectangle
+   * @param h the height of the rectangle
    */

public final native void clearRect(float x, float y, float w, float h)/*-{

     this.clearRect(x, y, w, h);
@@ -281,29 +327,46 @@
   }-*/;

   /**
-   * Creates and image data object of the given size.
+   * Creates an image data object of the same size as the given object.
+   *
+   * @param imagedata an {...@link ImageData} object
+   * @return a new {...@link ImageData} object
    */
-  public final native ImageData createImageData(int w, int h) /*-{
-    return this.createImageData(w, h);
+  public final native ImageData createImageData(ImageData imagedata) /*-{
+    return this.createImageData(imagedata);
   }-*/;

   /**
-   * Creates an image data object of the same size as the given object.
+   * Creates an image data object of the given size.
+   *
+   * @param w the width of the image
+   * @param h the height of the image
+   * @return an {...@link ImageData} object
    */
-  public final native ImageData createImageData(ImageData imagedata) /*-{
-    return this.createImageData(imagedata);
+  public final native ImageData createImageData(int w, int h) /*-{
+    return this.createImageData(w, h);
   }-*/;

   /**
    * Creates a linear gradient.
+   *
+   * @param x0 the x coordinate of the starting point of the gradient
+   * @param y0 the y coordinate of the starting point of the gradient
+   * @param x1 the x coordinate of the ending point of the gradient
+   * @param y1 the y coordinate of the ending point of the gradient
+   * @return a {...@link CanvasGradient} object
    */

- public final native CanvasGradient createLinearGradient(float x0, floaty0, float x1,+ public final native CanvasGradient createLinearGradient(float x0, floaty0, float x1,

       float y1) /*-{
     return this.createLinearGradient(x0, y0, x1, y1);
   }-*/;

   /**
    * Creates a pattern from another canvas.
+   *
+   * @param image an {...@link CanvasElement} object
+   * @param repetition a {...@link Repetition} object
+   * @return a {...@link CanvasPattern} object
    */

public final CanvasPattern createPattern(CanvasElement image, Repetitionrepetition) {

     return createPattern(image, repetition.getValue());
@@ -311,6 +374,10 @@

   /**
    * Creates a pattern from another canvas.
+   *
+   * @param image an {...@link CanvasElement} object
+   * @param repetition the repetition type as a String
+   * @return a {...@link CanvasPattern} object
    */

public final native CanvasPattern createPattern(CanvasElement image,String repetition) /*-{

     return this.createPattern(image, repetition);
@@ -318,6 +385,10 @@

   /**
    * Creates a pattern from an image.
+   *
+   * @param image an {...@link ImageElement} object
+   * @param repetition a {...@link Repetition} object
+   * @return a {...@link CanvasPattern} object
    */

public final CanvasPattern createPattern(ImageElement image, Repetitionrepetition) {

     return createPattern(image, repetition.getValue());
@@ -325,6 +396,10 @@

   /**
    * Creates a pattern from an image.
+   *
+   * @param image an {...@link ImageElement} object
+   * @param repetition the repetition type as a String
+   * @return a {...@link CanvasPattern} object
    */

public final native CanvasPattern createPattern(ImageElement image,String repetition) /*-{

     return this.createPattern(image, repetition);
@@ -332,9 +407,14 @@

   /**
    * Creates a radial gradient.
-   *

- * Due to needing to wrap the contained gradient when in devmode, wecreate an array containing- * the CanvasGradient in devmode (when isScript == false.) @seeFillStrokeStyle

+   *

+ * @param x0 the x coordinate of the center of the start circle of thegradient+ * @param y0 the y coordinate of the center of the start circle of thegradient

+   * @param r0 the radius of the start circle of the gradient

+ * @param x1 the x coordinate of the center of the end circle of thegradient+ * @param y1 the y coordinate of the center of the end circle of thegradient

+   * @param r1 the radius of the end circle of the gradient
+   * @return a {...@link CanvasGradient} object
    */

public final native CanvasGradient createRadialGradient(float x0, floaty0, float r0, float x1,

       float y1, float r1) /*-{
@@ -343,6 +423,10 @@

   /**
    * Draws an image.
+   *
+   * @param image an {...@link CanvasElement} object