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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef OOX_VML_VMLFORMATTING_HXX
#define OOX_VML_VMLFORMATTING_HXX
#include "oox/helper/helper.hxx"
#include "oox/dllapi.h"
#include <com/sun/star/awt/Point.hpp>
#include <com/sun/star/drawing/PolyPolygonBezierCoords.hpp>
#include <vector>
namespace oox {
class GraphicHelper;
namespace drawingml { class Color; }
namespace drawingml { class ShapePropertyMap; }
}
namespace oox {
namespace vml {
// ============================================================================
typedef ::std::pair< sal_Int32, sal_Int32 > Int32Pair;
typedef ::std::pair< double, double > DoublePair;
// ============================================================================
class OOX_DLLPUBLIC ConversionHelper
{
public:
/** Returns two values contained in rValue separated by cSep.
*/
static bool separatePair(
OUString& orValue1, OUString& orValue2,
const OUString& rValue, sal_Unicode cSep );
/** Returns the boolean value from the passed string of a VML attribute.
Supported values: 'f', 't', 'false', 'true'. False for anything else.
*/
static bool decodeBool( const OUString& rValue );
/** Converts the passed VML percentage measure string to a normalized
floating-point value.
@param rValue The VML percentage value. This is a floating-point value
with optional following '%' or 'f' sign. If the sign is missing, the
floating point value will be returned unmodified. If the '%' sign
is present, the value will be divided by 100. If the 'f' sign is present,
the value will be divided by 65536.
*/
static double decodePercent(
const OUString& rValue,
double fDefValue );
/** Converts the passed VML measure string to EMU (English Metric Units).
@param rGraphicHelper The graphic helper needed to perform pixel
conversion according to the current output device.
@param rValue The VML measure value. This is a floating-point value
with optional measure string following the value.
@param nRefValue Reference value needed for percentage measure.
@param bPixelX Set to true if the value is oriented horizontally (e.g.
X coordinates, widths). Set to false if the value is oriented
vertically (e.g. Y coordinates, heights). This is needed because
output devices may specify different width and height for a pixel.
@param bDefaultAsPixel Set to true if omitted measure unit means
pixel. Set to false if omitted measure unit means EMU.
*/
static sal_Int64 decodeMeasureToEmu(
const GraphicHelper& rGraphicHelper,
const OUString& rValue,
sal_Int32 nRefValue,
bool bPixelX,
bool bDefaultAsPixel );
/** Converts the passed VML measure string to 1/100 mm.
@param rGraphicHelper See above.
@param rValue See above.
@param nRefValue See above.
@param bPixelX See above.
@param bDefaultAsPixel See above.
*/
static sal_Int32 decodeMeasureToHmm(
const GraphicHelper& rGraphicHelper,
const OUString& rValue,
sal_Int32 nRefValue,
bool bPixelX,
bool bDefaultAsPixel );
/** Converts VML color attributes to a DrawingML color.
@param roVmlColor The VML string representation of the color. If
existing, this can be a 3-digit or 6-digit hexadecimal RGB value
with leading '#' character, a predefined color name (e.g. 'black',
'red', etc.), the index into an application defined color palette
in brackets with leading color name (e.g. 'red [9]' or
'windowColor [64]'), or a color modifier used in one-color
gradients (e.g. 'fill darken(128)' or 'fill lighten(0)').
@param roVmlOpacity The opacity of the color. If existing, this should
be a floating-point value in the range [0.0;1.0].
@param nDefaultRgb Deafult RGB color used if the parameter roVmlColor
is empty.
@param nPrimaryRgb If set to something else than API_RGB_TRANSPARENT,
specifies the color to be used to resolve the color modifiers used
in one-color gradients.
@return The resulting DrawingML color.
*/
static ::oox::drawingml::Color decodeColor(
const GraphicHelper& rGraphicHelper,
const OptValue< OUString >& roVmlColor,
const OptValue< double >& roVmlOpacity,
sal_Int32 nDefaultRgb,
sal_Int32 nPrimaryRgb = API_RGB_TRANSPARENT );
/** Converts VML path string into point and flag vectors.
@param rPoints The point vector to fill with coordinates.
@param rFlags The flag vector to fill. PolygonFlags_NORMAL indicates
a corresponding plain shape coordinate in rPoints and
PolygonFlags_CONTROL indicates a bezier curve control point.
@param rPath The VML path string.
@param rGraphicHelper See above.
*/
static void decodeVmlPath(
::std::vector< ::std::vector< ::com::sun::star::awt::Point > >& rPoints,
::std::vector< ::std::vector< ::com::sun::star::drawing::PolygonFlags > >& rFlags,
const OUString& rPath );
private:
ConversionHelper();
~ConversionHelper();
};
// ============================================================================
/** The stroke arrow model structure contains all properties for an line end arrow. */
struct StrokeArrowModel
{
OptValue< sal_Int32 > moArrowType;
OptValue< sal_Int32 > moArrowWidth;
OptValue< sal_Int32 > moArrowLength;
void assignUsed( const StrokeArrowModel& rSource );
};
// ============================================================================
/** The stroke model structure contains all shape border properties. */
struct StrokeModel
{
OptValue< bool > moStroked; ///< Shape border line on/off.
StrokeArrowModel maStartArrow; ///< Start line arrow style.
StrokeArrowModel maEndArrow; ///< End line arrow style.
OptValue< OUString > moColor; ///< Solid line color.
OptValue< double > moOpacity; ///< Solid line color opacity.
OptValue< OUString > moWeight; ///< Line width.
OptValue< OUString > moDashStyle; ///< Line dash (predefined or manually).
OptValue< sal_Int32 > moLineStyle; ///< Line style (single, double, ...).
OptValue< sal_Int32 > moEndCap; ///< Type of line end cap.
OptValue< sal_Int32 > moJoinStyle; ///< Type of line join.
void assignUsed( const StrokeModel& rSource );
/** Writes the properties to the passed property map. */
void pushToPropMap(
::oox::drawingml::ShapePropertyMap& rPropMap,
const GraphicHelper& rGraphicHelper ) const;
};
// ============================================================================
/** The fill model structure contains all shape fill properties. */
struct OOX_DLLPUBLIC FillModel
{
OptValue< bool > moFilled; ///< Shape fill on/off.
OptValue< OUString > moColor; ///< Solid fill color.
OptValue< double > moOpacity; ///< Solid fill color opacity.
OptValue< OUString > moColor2; ///< End color of gradient.
OptValue< double > moOpacity2; ///< End color opacity of gradient.
OptValue< sal_Int32 > moType; ///< Fill type.
OptValue< sal_Int32 > moAngle; ///< Gradient rotation angle.
OptValue< double > moFocus; ///< Linear gradient focus of second color.
OptValue< DoublePair > moFocusPos; ///< Rectangular gradient focus position of second color.
OptValue< DoublePair > moFocusSize; ///< Rectangular gradient focus size of second color.
OptValue< OUString > moBitmapPath; ///< Path to fill bitmap fragment.
OptValue< bool > moRotate; ///< True = rotate gradient/bitmap with shape.
void assignUsed( const FillModel& rSource );
/** Writes the properties to the passed property map. */
void pushToPropMap(
::oox::drawingml::ShapePropertyMap& rPropMap,
const GraphicHelper& rGraphicHelper ) const;
};
// ============================================================================
/** The shadow model structure contains all shape shadow properties. */
struct OOX_DLLPUBLIC ShadowModel
{
bool mbHasShadow; ///< Is a v:shadow element seen?
OptValue<bool> moShadowOn; ///< Is the element turned on?
OptValue<OUString> moColor; ///< Specifies the color of the shadow.
OptValue<OUString> moOffset; ///< Specifies the shadow's offset from the shape's location.
OptValue<double> moOpacity; ///< Specifies the opacity of the shadow.
ShadowModel();
/** Writes the properties to the passed property map. */
void pushToPropMap(oox::drawingml::ShapePropertyMap& rPropMap, const GraphicHelper& rGraphicHelper) const;
};
} // namespace vml
} // namespace oox
#endif
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
