1/**************************************************************
2 *
3 * Licensed to the Apache Software Foundation (ASF) under one
4 * or more contributor license agreements.  See the NOTICE file
5 * distributed with this work for additional information
6 * regarding copyright ownership.  The ASF licenses this file
7 * to you under the Apache License, Version 2.0 (the
8 * "License"); you may not use this file except in compliance
9 * with the License.  You may obtain a copy of the License at
10 *
11 *   http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing,
14 * software distributed under the License is distributed on an
15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 * KIND, either express or implied.  See the License for the
17 * specific language governing permissions and limitations
18 * under the License.
19 *
20 *************************************************************/
21
22
23#ifndef __com_sun_star_graphic_XPrimitive2D_idl__
24#define __com_sun_star_graphic_XPrimitive2D_idl__
25
26#ifndef __com_sun_star_uno_XInterface_idl__
27#include <com/sun/star/uno/XInterface.idl>
28#endif
29#ifndef __com_sun_star_beans_PropertyValue_idl__
30#include <com/sun/star/beans/PropertyValue.idl>
31#endif
32#ifndef __com_sun_star_geometry_RealRectangle2D_idl__
33#include <com/sun/star/geometry/RealRectangle2D.idl>
34#endif
35
36module com {  module sun {  module star {  module graphic {
37
38/** XPrimitive2D interface
39
40    This is the basic interface for 2D graphic primitives. They need to be able
41	- to provide a decomposition consisting of simpler graphic primitives
42	- to provide a 2D bound rectangle as a 2D range
43 */
44interface XPrimitive2D : ::com::sun::star::uno::XInterface
45{
46    /** Retrieve decomposed list of simpler primitives
47
48        @param aViewParameters
49        2D View-specific parameter set. The defined but not mandatory
50		parameters include:
51
52		::com::sun::star::geometry::AffineMatrix2D Transformation
53
54		A transformation matrix which maps between world coordinates (which
55		is equal to object's local coordinates) to view coordinates. If not
56		defined, an empty transformation is implied.
57
58		::com::sun::star::geometry::RealRectangle2D Viewport
59
60		Defines the visible part of the view in world coordinates. May be used
61		to optimize decompositions, e.g. for 3d scenes only the visible part
62		needs to be created. If not given, an empty Viewport is implied which
63		means all is visible.
64
65		double Time
66
67		Defines the point in time for which the geometry is defined. This may
68		lead to varied results for animated objects. This value is defined in the
69		range [0.0 .. n[, negative values are not allowed. If not given, a value of
70		0.0 is implied.
71     */
72    sequence< XPrimitive2D > getDecomposition( [in] sequence< ::com::sun::star::beans::PropertyValue > aViewParameters );
73
74    /** Retrieve bound rect of primitive
75
76        This method calculates the actual bound rect of the area in
77        <em>world coordinates<em>. Note that for view-dependent primitives,
78		the necessary pixel adjustments are taken into account. For that reason
79		the ViewParameters need to be given.
80
81		@param aViewParameters
82        2D View-specific parameter set, same as in getDecomposition.
83     */
84    ::com::sun::star::geometry::RealRectangle2D getRange( [in] sequence< ::com::sun::star::beans::PropertyValue > aViewParameters );
85};
86
87}; }; }; };
88
89#endif
90