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
|
/*************************************************************************
*
* 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_rendering_IntegerBitmapLayout_idl__
#define __com_sun_star_rendering_IntegerBitmapLayout_idl__
#ifndef __com_sun_star_rendering_XIntegerBitmapColorSpace_idl__
#include <com/sun/star/rendering/XIntegerBitmapColorSpace.idl>
#endif
#ifndef __com_sun_star_rendering_XBitmapPalette_idl__
#include <com/sun/star/rendering/XBitmapPalette.idl>
#endif
module com { module sun { module star { module rendering {
/** This structure describes the memory layout of a bitmap having
integer color channels.<p>
This structure collects all necessary information to describe the
memory layout of a bitmap having integer color channels<p>
@since OOo 2.0
*/
struct IntegerBitmapLayout
{
/** Number of scanlines for this bitmap.
This value must not be negative
*/
long ScanLines;
/** Number of data bytes per scanline.
This value must not be negative
*/
long ScanLineBytes;
/** Byte offset between the start of two consecutive scanlines.
This value is permitted to be negative, denoting a bitmap
whose content is flipped at the x axis.
*/
long ScanLineStride;
/** Byte offset between the start of two consecutive planes.
This value is permitted to be negative. If this value is zero,
the bitmap is assumed to be in chunky format, otherwise it is
assumed to be planar. The difference between chunky and
planar layout lies in the way how color channels are
interleaved. For a chunky format, all channel data for a
single pixel lies consecutively in memory. For a planar
layout, the first channel of all pixel is stored consecutive,
followed by the second channel, and so forth.<p>
*/
long PlaneStride;
/** Color space the bitmap colors shall be interpreted within.<p>
Note that the actual pixel layout is specified at the color
space. If this layout describes a palette bitmap format, this
color space describes the index format (plus maybe an extra
alpha channel). The palette itself references another color
space, which describes the layout of the palette entries.
@see XBitmapPalette
*/
XIntegerBitmapColorSpace ColorSpace;
/** This member determines whether the bitmap data are actually
indices into a color map.<p>
When set to the nil reference, the bitmap data is assumed to
contain direct color values (to be interpreted according to
the associated color space). If this member references a valid
palette, one of the pixel components as returned by the color
space referenced from the <member>ColorSpace</member> is
required to be of type
<member>ColorComponentTag::INDEX</member>. That component is
then used to index the palette.<p>
*/
XBitmapPalette Palette;
/** This member determines the bit order (only relevant if a pixel
uses less than 8 bits, of course).<p>
When <TRUE/>, this member denotes that the leftmost pixel from
an 8 bit amount of pixel data consists of the bits starting
with the most significant bit. When <FALSE/>, it's starting
with the least significant bit.<p>
Example: for a 1bpp bitmap, each pixel is represented by
exactly one bit. If this member is <TRUE/>, the first pixel is
the MSB of the first byte, and the eighth pixel is the LSB of
the first byte. If this member is <FALSE/>, it's just the
opposite.
*/
boolean IsMsbFirst;
};
}; }; }; };
#endif
|
