View Javadoc

1   /**********************************************
2    * Copyright (C) 2010 Lukas Laag
3    * This file is part of lib-gwt-svg.
4    * 
5    * libgwtsvg is free software: you can redistribute it and/or modify
6    * it under the terms of the GNU Lesser General Public License as published by
7    * the Free Software Foundation, either version 3 of the License, or
8    * (at your option) any later version.
9    * 
10   * libgwtsvg is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13   * GNU Lesser General Public License for more details.
14   * 
15   * You should have received a copy of the GNU Lesser General Public License
16   * along with libgwtsvg.  If not, see http://www.gnu.org/licenses/
17   **********************************************/
18  /*
19   * Copyright (c) 2004 World Wide Web Consortium,
20   *
21   * (Massachusetts Institute of Technology, European Research Consortium for
22   * Informatics and Mathematics, Keio University). All Rights Reserved. This
23   * work is distributed under the W3C(r) Software License [1] in the hope that
24   * it will be useful, but WITHOUT ANY WARRANTY; without even the implied
25   * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
26   *
27   * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
28   */
29  
30  package org.vectomatic.dom.svg.impl;
31  
32  import org.vectomatic.dom.svg.OMSVGAnimatedBoolean;
33  import org.vectomatic.dom.svg.OMSVGAnimatedLength;
34  import org.vectomatic.dom.svg.OMSVGAnimatedTransformList;
35  import org.vectomatic.dom.svg.OMSVGMatrix;
36  import org.vectomatic.dom.svg.OMSVGRect;
37  import org.vectomatic.dom.svg.OMSVGStringList;
38  
39  import com.google.gwt.core.client.JavaScriptException;
40  
41  /**
42   * The {@link org.vectomatic.dom.svg.impl.SVGRectElement} interface corresponds
43   * to the <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement' title='rect
44   * element specification'>rect</a> element.
45   */
46  public class SVGRectElement extends SVGElement {
47    protected SVGRectElement() {
48    }
49  
50    // Implementation of the svg::SVGRectElement W3C IDL interface
51    /**
52     * Corresponds to attribute {@link org.vectomatic.dom.svg.impl.SVGRectElement#getX()}
53     * on the given <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement'
54     * title='rect element specification'>rect</a> element.
55     */
56    public final native OMSVGAnimatedLength getX() /*-{
57      return this.x;
58    }-*/;
59    /**
60     * Corresponds to attribute {@link org.vectomatic.dom.svg.impl.SVGRectElement#getY()}
61     * on the given <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement'
62     * title='rect element specification'>rect</a> element.
63     */
64    public final native OMSVGAnimatedLength getY() /*-{
65      return this.y;
66    }-*/;
67    /**
68     * Corresponds to attribute {@link org.vectomatic.dom.svg.impl.SVGRectElement#getWidth()}
69     * on the given <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement'
70     * title='rect element specification'>rect</a> element.
71     */
72    public final native OMSVGAnimatedLength getWidth() /*-{
73      return this.width;
74    }-*/;
75    /**
76     * Corresponds to attribute {@link org.vectomatic.dom.svg.impl.SVGRectElement#getHeight()}
77     * on the given <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement'
78     * title='rect element specification'>rect</a> element.
79     */
80    public final native OMSVGAnimatedLength getHeight() /*-{
81      return this.height;
82    }-*/;
83    /**
84     * Corresponds to attribute {@link org.vectomatic.dom.svg.impl.SVGRectElement#getRx()}
85     * on the given <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement'
86     * title='rect element specification'>rect</a> element.
87     */
88    public final native OMSVGAnimatedLength getRx() /*-{
89      return this.rx;
90    }-*/;
91    /**
92     * Corresponds to attribute {@link org.vectomatic.dom.svg.impl.SVGRectElement#getRy()}
93     * on the given <a href='http://www.w3.org/TR/SVG11/shapes.html#RectElement'
94     * title='rect element specification'>rect</a> element.
95     */
96    public final native OMSVGAnimatedLength getRy() /*-{
97      return this.ry;
98    }-*/;
99  
100   // Implementation of the svg::SVGExternalResourcesRequired W3C IDL interface
101   /**
102    * Corresponds to attribute {@link org.vectomatic.dom.svg.itf.ISVGExternalResourcesRequired#getExternalResourcesRequired()}
103    * on the given element. Note that the SVG DOM defines the attribute {@link
104    * org.vectomatic.dom.svg.itf.ISVGExternalResourcesRequired#getExternalResourcesRequired()}
105    * as being of type {@link org.vectomatic.dom.svg.OMSVGAnimatedBoolean}, whereas
106    * the SVG language definition says that {@link org.vectomatic.dom.svg.itf.ISVGExternalResourcesRequired#getExternalResourcesRequired()}
107    * is not animated. Because the SVG language definition states that {@link
108    * org.vectomatic.dom.svg.itf.ISVGExternalResourcesRequired#getExternalResourcesRequired()}
109    * cannot be animated, the {@link org.vectomatic.dom.svg.OMSVGAnimatedBoolean#getAnimVal()}
110    * will always be the same as the {@link org.vectomatic.dom.svg.OMSVGAnimatedBoolean#getBaseVal()}.
111    */
112   public final native OMSVGAnimatedBoolean getExternalResourcesRequired() /*-{
113     return this.externalResourcesRequired;
114   }-*/;
115 
116   // Implementation of the svg::SVGLangSpace W3C IDL interface
117   /**
118    * Corresponds to attribute <code>xml:lang</code> on the given element.
119    */
120   public final native String getXmllang() /*-{
121     return this.xmllang;
122   }-*/;
123   /**
124    * Corresponds to attribute <code>xml:lang</code> on the given element.
125    * @throws DOMException(NO_MODIFICATION_ALLOWED_ERR) Raised on an   attempt
126    * to change the value of a <a href="svgdom.html#ReadOnlyNodes">read only
127    * attribute</a>.
128    */
129   public final native void setXmllang(String value) throws JavaScriptException /*-{
130     this.xmllang = value;
131   }-*/;
132   /**
133    * Corresponds to attribute <code>xml:space</code> on the given element.
134    */
135   public final native String getXmlspace() /*-{
136     return this.xmlspace;
137   }-*/;
138   /**
139    * Corresponds to attribute <code>xml:space</code> on the given element.
140    * @throws DOMException(NO_MODIFICATION_ALLOWED_ERR) Raised on an   attempt
141    * to change the value of a <a href="svgdom.html#ReadOnlyNodes">read only
142    * attribute</a>.
143    */
144   public final native void setXmlspace(String value) throws JavaScriptException /*-{
145     this.xmlspace = value;
146   }-*/;
147 
148   // Implementation of the svg::SVGLocatable W3C IDL interface
149   /**
150    * The element which established the current viewport. Often, the nearest
151    * ancestor <a href='http://www.w3.org/TR/SVG11/struct.html#SVGElement' title='svg
152    * element specification'>svg</a> element. Null if the current element is
153    * the outermost <a href='http://www.w3.org/TR/SVG11/struct.html#SVGElement'
154    * title='svg element specification'>svg</a> element.
155    */
156   public final native SVGElement getNearestViewportElement() /*-{
157     return this.nearestViewportElement;
158   }-*/;
159   /**
160    * The farthest ancestor <a href='http://www.w3.org/TR/SVG11/struct.html#SVGElement'
161    * title='svg element specification'>svg</a> element. Null if the current
162    * element is the outermost <a href='http://www.w3.org/TR/SVG11/struct.html#SVGElement'
163    * title='svg element specification'>svg</a> element.
164    */
165   public final native SVGElement getFarthestViewportElement() /*-{
166     return this.farthestViewportElement;
167   }-*/;
168   /**
169    * Returns the tight bounding box in current user space (i.e., after application
170    * of the <code>transform</code> attribute, if any) on the geometry of all
171    * contained graphics elements, exclusive of stroking, clipping, masking and
172    * filter effects). Note that getBBox must return the actual bounding box
173    * at the time the method was called, even in case the element has not yet
174    * been rendered.
175    * @return An {@link org.vectomatic.dom.svg.OMSVGRect} object that defines
176    * the bounding box.
177    */
178   public final native OMSVGRect getBBox() /*-{
179     return this.getBBox();
180   }-*/;
181   /**
182    * Returns the transformation matrix from current user units (i.e., after
183    * application of the <code>transform</code> attribute, if any) to the viewport
184    * coordinate system for the {@link org.vectomatic.dom.svg.itf.ISVGLocatable#getNearestViewportElement()}.
185    * @return An {@link org.vectomatic.dom.svg.OMSVGMatrix} object that defines
186    * the CTM.
187    */
188   public final native OMSVGMatrix getCTM() /*-{
189     return this.getCTM();
190   }-*/;
191   /**
192    * Returns the transformation matrix from current user units (i.e., after
193    * application of the <code>transform</code> attribute, if any) to the parent
194    * user agent's notice of a "pixel". For display devices, ideally this represents
195    * a physical screen pixel. For other devices or environments where physical
196    * pixel sizes are not known, then an algorithm similar to the CSS2 definition
197    * of a "pixel" can be used instead.  Note that null is returned if this element
198    * is not hooked into the document tree. This method would have been more
199    * aptly named as <code>getClientCTM</code>, but the name <code>getScreenCTM</code>
200    * is kept for historical reasons.
201    * @return An {@link org.vectomatic.dom.svg.OMSVGMatrix} object that defines
202    * the given   transformation matrix.
203    */
204   public final native OMSVGMatrix getScreenCTM() /*-{
205     return this.getScreenCTM();
206   }-*/;
207   /**
208    * Returns the transformation matrix from the user coordinate system on the
209    * current element (after application of the <code>transform</code> attribute,
210    * if any) to the user coordinate system on parameter <var>element</var> (after
211    * application of its <code>transform</code> attribute, if any).
212    * @param element The target element.
213    * @return An {@link org.vectomatic.dom.svg.OMSVGMatrix} object that defines
214    * the transformation.
215    * @throws SVGException(SVG_MATRIX_NOT_INVERTABLE) Raised if the currently
216    * defined transformation matrices make it impossible to compute the   given
217    * matrix (e.g., because one of the transformations is singular).
218    */
219   public final native OMSVGMatrix getTransformToElement(SVGElement element) throws JavaScriptException /*-{
220     return this.getTransformToElement(element);
221   }-*/;
222 
223   // Implementation of the svg::SVGTests W3C IDL interface
224   /**
225    * Corresponds to attribute {@link org.vectomatic.dom.svg.itf.ISVGTests#getRequiredFeatures()}
226    * on the given element.
227    */
228   public final native OMSVGStringList getRequiredFeatures() /*-{
229     return @org.vectomatic.dom.svg.OMNode::convertList(Lcom/google/gwt/core/client/JavaScriptObject;)(this.requiredFeatures);
230   }-*/;
231   /**
232    * Corresponds to attribute {@link org.vectomatic.dom.svg.itf.ISVGTests#getRequiredExtensions()}
233    * on the given element.
234    */
235   public final native OMSVGStringList getRequiredExtensions() /*-{
236     return @org.vectomatic.dom.svg.OMNode::convertList(Lcom/google/gwt/core/client/JavaScriptObject;)(this.requiredExtensions);
237   }-*/;
238   /**
239    * Corresponds to attribute {@link org.vectomatic.dom.svg.itf.ISVGTests#getSystemLanguage()}
240    * on the given element.
241    */
242   public final native OMSVGStringList getSystemLanguage() /*-{
243     return @org.vectomatic.dom.svg.OMNode::convertList(Lcom/google/gwt/core/client/JavaScriptObject;)(this.systemLanguage);
244   }-*/;
245   /**
246    * Returns true if the user agent supports the given extension, specified
247    * by a URI.
248    * @param extension The name of the extension, expressed as a URI.
249    * @return True or false, depending on whether the given extension is   supported.
250    */
251   public final native boolean hasExtension(String extension) /*-{
252     return this.hasExtension(extension);
253   }-*/;
254 
255   // Implementation of the svg::SVGTransformable W3C IDL interface
256   /**
257    * Corresponds to attribute {@link org.vectomatic.dom.svg.itf.ISVGTransformable#getTransform()}
258    * on the given element.
259    */
260   public final native OMSVGAnimatedTransformList getTransform() /*-{
261     return this.transform;
262   }-*/;
263 
264 }