merged tag ooo/OOO330_m14
[LibreOffice.git] / offapi / com / sun / star / rendering / XHalfFloatReadOnlyBitmap.idl
blob166f38425d5c4050649c270368814efca45d5ffb
1 /*************************************************************************
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5 * Copyright 2000, 2010 Oracle and/or its affiliates.
7 * OpenOffice.org - a multi-platform office productivity suite
9 * This file is part of OpenOffice.org.
11 * OpenOffice.org is free software: you can redistribute it and/or modify
12 * it under the terms of the GNU Lesser General Public License version 3
13 * only, as published by the Free Software Foundation.
15 * OpenOffice.org is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU Lesser General Public License version 3 for more details
19 * (a copy is included in the LICENSE file that accompanied this code).
21 * You should have received a copy of the GNU Lesser General Public License
22 * version 3 along with OpenOffice.org. If not, see
23 * <http://www.openoffice.org/license.html>
24 * for a copy of the LGPLv3 License.
26 ************************************************************************/
27 #ifndef __com_sun_star_rendering_XHalfFloatReadOnlyBitmap_idl__
28 #define __com_sun_star_rendering_XHalfFloatReadOnlyBitmap_idl__
30 #ifndef __com_sun_star_lang_IllegalArgumentException_idl__
31 #include <com/sun/star/lang/IllegalArgumentException.idl>
32 #endif
33 #ifndef __com_sun_star_lang_IndexOutOfBoundsException_idl__
34 #include <com/sun/star/lang/IndexOutOfBoundsException.idl>
35 #endif
36 #ifndef __com_sun_star_rendering_FloatingPointBitmapLayout_idl__
37 #include <com/sun/star/rendering/FloatingPointBitmapLayout.idl>
38 #endif
39 #ifndef __com_sun_star_geometry_IntegerPoint2D_idl__
40 #include <com/sun/star/geometry/IntegerPoint2D.idl>
41 #endif
42 #ifndef __com_sun_star_geometry_IntegerRectangle2D_idl__
43 #include <com/sun/star/geometry/IntegerRectangle2D.idl>
44 #endif
45 #ifndef __com_sun_star_rendering_XBitmap_idl__
46 #include <com/sun/star/rendering/XBitmap.idl>
47 #endif
48 #ifndef __com_sun_star_rendering_VolatileContentDestroyedException_idl__
49 #include <com/sun/star/rendering/VolatileContentDestroyedException.idl>
50 #endif
52 module com { module sun { module star { module rendering {
54 /** Specialized interface for bitmaps containing half floats as their
55 color components. Half floats are 16 bit wide, and some high-end
56 GPUs already have them as supported frame buffer format. In
57 contrast to <type>XHalfFloatBitmap</type>, this interface only
58 permits read-only access.<p>
60 Use this interface for e.g. bitmaps that are calculated
61 on-the-fly, or that are pure functional, and thus cannot be
62 modified.<p>
64 If you get passed an instance of
65 <type>XHalfFloatReadOnlyBitmap</type> that also supports the
66 <type>XVolatileBitmap</type> interface, things become a bit more
67 complicated. When reading data, one has to check for both
68 <type>VolatileContentDestroyedException</type> and mismatching
69 <type>FloatingPointBitmapLayout</type> return values. If either of them
70 occurs, the whole bitmap read operation should be repeated.<p>
72 interface XHalfFloatReadOnlyBitmap : XBitmap
74 /** Query the raw data of this bitmap.<p>
76 Query the raw data of this bitmap, in the format as defined by
77 getMemoryLayout(). With the given rectangle, a subset of the
78 whole bitmap can be queried. When querying subsets of the
79 bitmap, the same scanline padding takes place as when the
80 whole bitmap is requested. Note: as we currently have no 16
81 bit float UNO data type, the values are transported as 16 bit
82 integers across the API (which requires casting on both
83 sides).<p>
85 @throws <type>VolatileContentDestroyedException</type>
86 if the bitmap is volatile, and the content has been destroyed by the system.
88 sequence<short> getData( [in] ::com::sun::star::geometry::IntegerRectangle2D rect )
89 raises (com::sun::star::lang::IndexOutOfBoundsException,
90 VolatileContentDestroyedException);
92 //-------------------------------------------------------------------------
94 /** Get a single pixel of the bitmap, returning its color
95 value.<p>
97 @throws <type>VolatileContentDestroyedException</type>
98 if the bitmap is volatile, and the content has been destroyed by the system.
100 sequence<short> getPixel( [in] ::com::sun::star::geometry::IntegerPoint2D pos )
101 raises (com::sun::star::lang::IndexOutOfBoundsException,
102 VolatileContentDestroyedException);
104 //-------------------------------------------------------------------------
106 /** Query the memory layout for this bitmap.<p>
108 FloatingPointBitmapLayout getMemoryLayout();
111 }; }; }; };
113 #endif