|
|
|
|
/*
|
|
|
|
|
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 <EFBFBD> 2001 World Wide Web Consortium, (Massachusetts
|
|
|
|
|
Institute of Technology, Institut National de Recherche en
|
|
|
|
|
Informatique et en Automatique, Keio University).
|
|
|
|
|
All Rights Reserved.
|
|
|
|
|
|
|
|
|
|
$Id$
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef SVGTextElement_H
|
|
|
|
|
#define SVGTextElement_H
|
|
|
|
|
|
|
|
|
|
#include "SVGTextPositioningElement.h"
|
|
|
|
|
#include "SVGTransformable.h"
|
|
|
|
|
|
|
|
|
|
namespace KSVG
|
|
|
|
|
{
|
|
|
|
|
|
|
|
|
|
class SVGAnimatedLength;
|
|
|
|
|
class SVGTextElementImpl;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @short The <code>text</code> element defines a graphics element
|
|
|
|
|
* consisting of text.
|
|
|
|
|
*
|
|
|
|
|
* The XML character data within the <code>text</code> element, along
|
|
|
|
|
* with relevant attributes and properties and character-to-glyph
|
|
|
|
|
* mapping tables within the font itself, define the glyphs to be
|
|
|
|
|
* rendered. (See <a
|
|
|
|
|
* href="http://www.w3.org/TR/SVG/text.html#CharactersAndGlyphs"> Characters
|
|
|
|
|
* and their corresponding glyphs </a>.) The attributes and properties on the
|
|
|
|
|
* 'text' element indicate such things as the writing direction, font
|
|
|
|
|
* specification and painting attributes which describe how exactly to render
|
|
|
|
|
* the characters. Since <code>text</code> elements are rendered using the
|
|
|
|
|
* same rendering methods as other graphics elements, all of the same
|
|
|
|
|
* coordinate system transformations, painting, clipping and tqmasking
|
|
|
|
|
* features that apply to tqshapes such as paths and rectangles also
|
|
|
|
|
* apply to <code>text</code> elements.
|
|
|
|
|
*
|
|
|
|
|
* It is possible to apply a gradient, pattern, clipping path, tqmask or
|
|
|
|
|
* filter to text.When one of these facilities is applied to text and
|
|
|
|
|
* keyword objectBoundingBox is used to specify a graphical effect
|
|
|
|
|
* relative to the "object bounding box", then the object bounding box
|
|
|
|
|
* units are computed relative to the entire 'text' element in all
|
|
|
|
|
* cases, even when different effects are applied to different 'tspan'
|
|
|
|
|
* elements within the same 'text' element.
|
|
|
|
|
*
|
|
|
|
|
|
|
|
|
|
* The <code>text</code> element renders its first glyph (after <a
|
|
|
|
|
* href = "http://www.w3.org/TR/SVG/text.html#RelationshipWithBiDirectionality"
|
|
|
|
|
* >bidirectionality</a> reordering) at the initial current text
|
|
|
|
|
* position, which is established by the <code>x</code> and
|
|
|
|
|
* <code>y</code> attributes on the <code>text</code> element (with
|
|
|
|
|
* possible adjustments due to the value of the @ref text-anchor
|
|
|
|
|
* property, the presence of a @ref textPath element containing the
|
|
|
|
|
* first character, and/or an <code>x</code>, <code>y</code>,
|
|
|
|
|
* <code>dx</code> or <code>dy</code> attributes on a @ref tspan, @ref
|
|
|
|
|
* tref or @ref altGlyph element which contains the first character).
|
|
|
|
|
* After the glyph(s) corresponding to the given character is(are)
|
|
|
|
|
* rendered, the current text position is updated for the next
|
|
|
|
|
* character. In the simplest case, the new current text position is
|
|
|
|
|
* the previous current text position plus the glyphs' advance value
|
|
|
|
|
* (horizontal or vertical).
|
|
|
|
|
*
|
|
|
|
|
* @see SVGShape
|
|
|
|
|
* @see SVGTextPositioningElement
|
|
|
|
|
*
|
|
|
|
|
* For more info look here : <a href =
|
|
|
|
|
* "http://www.w3.org/TR/SVG/text.html#TextElement"> 10.4 The
|
|
|
|
|
* 'text' element</a>.
|
|
|
|
|
*/
|
|
|
|
|
class SVGTextElement : public SVGTextPositioningElement,
|
|
|
|
|
public SVGTransformable
|
|
|
|
|
{
|
|
|
|
|
public:
|
|
|
|
|
SVGTextElement();
|
|
|
|
|
SVGTextElement(const SVGTextElement &);
|
|
|
|
|
SVGTextElement &operator=(const SVGTextElement &other);
|
|
|
|
|
SVGTextElement(SVGTextElementImpl *);
|
|
|
|
|
~SVGTextElement();
|
|
|
|
|
|
|
|
|
|
// Internal! - NOT PART OF THE SVG SPECIFICATION
|
|
|
|
|
SVGTextElementImpl *handle() const { return impl; }
|
|
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
SVGTextElementImpl *impl;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
#endif
|