1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
/*
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 SVGLocatable_H
#define SVGLocatable_H
namespace KSVG
{
class SVGElement;
class SVGMatrix;
class SVGRect;
class SVGLocatableImpl;
/**
* Interface SVGLocatable is for all elements which either have a <code>transform</code>
* attribute or don't have a <code>transform</code> attribute but whose content can have
* a bounding box in current user space.
*/
class SVGLocatable
{
public:
SVGLocatable(const SVGLocatable &other);
SVGLocatable &operator=(const SVGLocatable &other);
SVGLocatable(SVGLocatableImpl *other);
virtual ~SVGLocatable();
/**
* The element which established the current viewport. Often, the nearest
* ancestor 'svg' element. Null if the current element is the outermost 'svg' element.
*/
SVGElement nearestViewportElement() const;
/**
* The farthest ancestor 'svg' element. Null if the current element is
* the outermost 'svg' element.
*/
SVGElement farthestViewportElement() const;
/**
* Returns the tight bounding box in current user space (i.e., after application of
* the <code>transform</code> attribute, if any) on the geometry of all contained graphics
* elements, exclusive of stroke-width and filter effects).
*
* @return An SVGRect object that defines the bounding box.
*/
SVGRect getBBox();
/**
* Returns the transformation matrix from current user units (i.e., after application of
* the <code>transform</code> attribute, if any) to the viewport coordinate system for
* the nearestViewportElement.
*
* @return An SVGMatrix object that defines the CTM.
*/
SVGMatrix getCTM();
/**
* Returns the transformation matrix from current user units (i.e., after application of
* the <code>transform</code> attribute, if any) to the parent user agent's notice of a "pixel".
* For display devices, ideally this represents a physical screen pixel. For other devices or
* environments where physical pixel sizes are not known, then an algorithm similar to the
* CSS2 definition of a "pixel" can be used instead.
*
* @return An SVGMatrix object that defines the given transformation matrix.
*/
SVGMatrix getScreenCTM();
/**
* Returns the transformation matrix from the user coordinate system on the current
* element (after application of the <code>transform</code> attribute, if any) to the
* user coordinate system on parameter element (after application of its
* <code>transform</code> attribute, if any).
*
* @param element The target element.
*
* @return An SVGMatrix object that defines the transformation.
*/
SVGMatrix getTransformToElement(const SVGElement &element);
// Internal! - NOT PART OF THE SVG SPECIFICATION
SVGLocatableImpl *handle() const { return impl; }
protected:
SVGLocatable();
private:
SVGLocatableImpl *impl;
};
}
#endif
|
