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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/*/*************************************************************************
*
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* Copyright 2000, 2010 Oracle and/or its affiliates.
*
* OpenOffice.org - a multi-platform office productivity suite
*
* This file is part of OpenOffice.org.
*
* OpenOffice.org is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3
* only, as published by the Free Software Foundation.
*
* OpenOffice.org 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 Lesser General Public License version 3 for more details
* (a copy is included in the LICENSE file that accompanied this code).
*
* You should have received a copy of the GNU Lesser General Public License
* version 3 along with OpenOffice.org. If not, see
* <http://www.openoffice.org/license.html>
* for a copy of the LGPLv3 License.
*
************************************************************************/
#ifndef com_sun_star_graphic_XGraphicRasterizer_idl
#define com_sun_star_graphic_XGraphicRasterizer_idl
#include <com/sun/star/io/XInputStream.idl>
#include <com/sun/star/graphic/XGraphic.idl>
#include <com/sun/star/beans/PropertyValues.idl>
#include <com/sun/star/beans/XPropertySet.idl>
#include <com/sun/star/awt/Size.idl>
module com { module sun { module star { module graphic
{
/** This interfaces exposes the initialize and a rasterize method to
rasterize a given data stream to a pixel graphic
*/
interface XGraphicRasterizer : ::com::sun::star::uno::XInterface
{
/** Initializing the rasterizer
<p>This method could also be used to determine, if
the provided data is able to be rasterized by the
implementation. The implementation should take care of
this feature as well as setting the default image size in
pixel within the given output parameter.</p>
@param DataStream
The input stream of data that should be rasterized
@param DPI_X
The horizontal resolution of the callers device in pixel per inch. This
value is needed to calculate the correct dimensions of the graphic to be
rasterized. If a value of <value>0</value> is given, a horizontal default
resolution of 72 DPI is used.
@param DPI_Y
The vertical resolution of the callers device in pixel per inch. This
value is needed to calculate the correct dimensions of the graphic to be
rasterized. If a value of <value>0</value> is given, a vertical default
resolution of 72 DPI is used.
@param DefaultSizePixel
The default rendering size in pixel of the underlying graphics
data may be available after the call via this output parameter.
In case no default size can be determined during initialization,
a default pixel size of 0,0 is returned. In this case, the caller
needs to assume a default pixel size, appropriate for the calling
context.
@returns
A boolean value indicating if rasterizing of the given data is
possible at all and if the initialization process happened
successfully.
@see com::sun::star::io::XInputStream
@see com::sun::star::awt::Size
*/
boolean initializeData( [in] com::sun::star::io::XInputStream DataStream,
[in] unsigned long DPI_X,
[in] unsigned long DPI_Y,
[out] com::sun::star::awt::Size DefaultSizePixel );
/** Rasterizing the initialized data into a <type>XGraphic</type> container.
<p>The <type>XGraphic</type> container will contain a pixel
type graphic after a successful rasterization process</p>
<p>In case of any fault during the rasterization process,
the <type>XGraphic</type> container will be empty afterwards and
the method will return false</p>
@param Width
The width in pixel of the graphic to be rasterized.
This parameter is used without taking other transformation
values into account.
@param Height
The height in pixel of the graphic to be rasterized.
This parameter is used without taking other transformation
values into account.
@param RotateAngle
The rotation angle of the graphic to be rasterized.
This parameter is used without taking other transformation
values into account. The rotation is applied after scaling
and shearing the original image.
@param ShearXAngle
The horizontal shear angle of the graphic to be rasterized.
This parameter is used without taking other transformation
values into account. The shearing is applied after scaling
and before rotation of the image.
@param ShearYAngle
The vertical shear angle of the graphic to be rasterized.
This parameter is used without taking other transformation
values into account. The shearing is applied after scaling
and before rotation of the image.
@param RasterizeProperties
Additional properties for special needs (undefined by now)
@param Graphic
An interface to a graphic container into which the given data
should be rasterized.
@returns com::sun::star::graphic::XGraphic
An interface to a graphic container that holds the rasterized pixel data
@see com::sun::star::beans::PropertyValues
@see com::sun::star::graphic::XGraphic
*/
com::sun::star::graphic::XGraphic rasterize( [in] unsigned long Width,
[in] unsigned long Height,
[in] double RotateAngle,
[in] double ShearAngle_X,
[in] double ShearAngle_Y,
[in] com::sun::star::beans::PropertyValues RasterizeProperties );
};
} ; } ; } ; } ;
#endif
|
