From 47d455dd55be855e4cc691c32f687f723d9247ee Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features. BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- ksvg/dom/SVGPatternElement.h | 188 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 188 insertions(+) create mode 100644 ksvg/dom/SVGPatternElement.h (limited to 'ksvg/dom/SVGPatternElement.h') diff --git a/ksvg/dom/SVGPatternElement.h b/ksvg/dom/SVGPatternElement.h new file mode 100644 index 00000000..9caf5c14 --- /dev/null +++ b/ksvg/dom/SVGPatternElement.h @@ -0,0 +1,188 @@ +/* + Copyright (C) 2001-2003 KSVG Team + This file is part of the KDE project + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public License + along with this library; see the file COPYING.LIB. If not, write to + the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + Boston, MA 02110-1301, USA. + + + This file includes excerpts from the Scalable Vector Graphics + (SVG) 1.0 Specification (Proposed Recommendation) + http://www.w3.org/TR/SVG + + Copyright © 2001 World Wide Web Consortium, (Massachusetts + Institute of Technology, Institut National de Recherche en + Informatique et en Automatique, Keio University). + All Rights Reserved. +*/ + +#ifndef SVGPatternElement_H +#define SVGPatternElement_H + +#include "SVGElement.h" +#include "SVGURIReference.h" +#include "SVGTests.h" +#include "SVGLangSpace.h" +#include "SVGExternalResourcesRequired.h" +#include "SVGStylable.h" +#include "SVGFitToViewBox.h" +#include "SVGUnitTypes.h" + +namespace KSVG +{ + +class SVGAnimatedEnumeration; +class SVGAnimatedTransformList; +class SVGAnimatedLength; +class SVGPatternElementImpl; + +/** + * A pattern is used to fill or stroke an object using a pre-defined graphic object which can be + * replicated ("tiled") at fixed intervals in x and y to cover the areas to be painted. + * + * Patterns are defined using a 'pattern' element and then referenced by properties 'fill' and 'stroke' + * on a given graphics element to indicate that the given element shall be filled or stroked with the + * referenced pattern. + */ +class SVGPatternElement : public SVGElement, + public SVGURIReference, + public SVGTests, + public SVGLangSpace, + public SVGExternalResourcesRequired, + public SVGStylable, + public SVGFitToViewBox, + public SVGUnitTypes +{ +public: + SVGPatternElement(); + SVGPatternElement(const SVGPatternElement &other); + SVGPatternElement &operator=(const SVGPatternElement &other); + SVGPatternElement(SVGPatternElementImpl *other); + virtual ~SVGPatternElement(); + + /** + * Defines the coordinate system for attributes x, y, width, height. + * If patternUnits="userSpaceOnUse", x, y, width, height represent + * values in the coordinate system that results from taking the current user coordinate system in place at the time when + * the 'pattern' element is referenced (i.e., the user coordinate system for the element referencing the 'pattern' element + * via a 'fill' or 'stroke' property) and then applying the transform specified by attribute patternTransform. + * If patternUnits="objectBoundingBox", the user coordinate system for attributes x, y, width, + * height is established using the bounding box of the element to which the pattern is applied and then applying + * the transform specified by attribute patternTransform. + * If attribute patternUnits is not specified, then the effect is as if a value of objectBoundingBox were specified. + * + * This attribute is animatable. + * + * @return The current target coordinate system mode. + */ + SVGAnimatedEnumeration patternUnits() const; + + /** + * Defines the coordinate system for the contents of the 'pattern'. Note that this attribute has no effect + * if attribute viewBox is specified. + * If patternContentUnits="userSpaceOnUse", the user coordinate system for the contents of the 'pattern' element + * is the coordinate system that results from taking the current user coordinate system in place at the time + * when the 'pattern' element is referenced (i.e., the user coordinate system for the element referencing the + * 'pattern' element via a 'fill' or 'stroke' property) and then applying the transform specified by attribute + * patternTransform. + * If patternContentUnits="objectBoundingBox", the user coordinate system for the contents of the 'pattern' element + * is established using the bounding box of the element to which the pattern is applied and then applying the + * transform specified by attribute patternTransform. + * If attribute patternContentUnits is not specified, then the effect is as if a value of + * userSpaceOnUse were specified. + * + * This attribute is animatable. + * + * @return The current content coordinate system mode. + */ + SVGAnimatedEnumeration patternContentUnits() const; + + /** + * Contains the definition of an optional additional transformation from the pattern coordinate + * system onto the target coordinate system (i.e., userSpaceOnUse or objectBoundingBox). + * This allows for things such as skewing the pattern tiles. This additional transformation + * matrix is post-multiplied to (i.e., inserted to the right of) any previously defined + * transformations, including the implicit transformation necessary to convert from object + * bounding box units to user space. + * If attribute patternTransform is not specified, then the effect is as if an identity transform + * were specified. + * + * This attribute is animatable. + * + * @return The transformation list that is applied to the pattern tile. + */ + SVGAnimatedTransformList patternTransform() const; + + /** + * The attributes x, y, width, height + * indicate how the pattern tiles are placed and spaced. + * These attributes represent coordinates and values in the coordinate space specified by + * the combination of attributes patternUnits and patternTransform. + * If the attribute is not specified, the effect is as if a value of zero were specified. + * + * This attribute is animatable. + * + * @return The x-axis coordinate of the pattern tile. + */ + SVGAnimatedLength x() const; + + /** + * @see x + * If the attribute is not specified, the effect is as if a value of zero were specified. + * + * This attribute is animatable. + * + * @return The y-axis coordinate of the pattern tile. + */ + SVGAnimatedLength y() const; + + /** + * @see x + * A negative value is an error. A value of zero disables rendering of + * the element (i.e., no paint is applied). + * + * If the attribute is not specified, the effect is as if a value of zero were specified. + * + * This attribute is animatable. + * + * @return The width of the pattern tile. + */ + SVGAnimatedLength width() const; + + /** + * @see x + * A negative value is an error. A value of zero disables rendering of + * the element (i.e., no paint is applied). + * + * If the attribute is not specified, the effect is as if a value of zero were specified. + * + * This attribute is animatable. + * + * @return The height coordinate of the pattern tile. + */ + SVGAnimatedLength height() const; + + // Internal! - NOT PART OF THE SVG SPECIFICATION + SVGPatternElementImpl *handle() const { return impl; } + +private: + SVGPatternElementImpl *impl; +}; + +} + +#endif + +// vim:ts=4:noet -- cgit v1.2.1