summaryrefslogtreecommitdiffstats
path: root/ksvg/dom/SVGLocatable.h
blob: eb6adef8380189c7b3fa7dfc2af81ad1929413ca (plain)
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