diff options
Diffstat (limited to 'offapi/com/sun/star/rendering/StrokeAttributes.idl')
-rw-r--r-- | offapi/com/sun/star/rendering/StrokeAttributes.idl | 132 |
1 files changed, 132 insertions, 0 deletions
diff --git a/offapi/com/sun/star/rendering/StrokeAttributes.idl b/offapi/com/sun/star/rendering/StrokeAttributes.idl new file mode 100644 index 000000000..3e551e75b --- /dev/null +++ b/offapi/com/sun/star/rendering/StrokeAttributes.idl @@ -0,0 +1,132 @@ +/* -*- 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 __com_sun_star_rendering_StrokeAttributes_idl__ +#define __com_sun_star_rendering_StrokeAttributes_idl__ + +module com { module sun { module star { module rendering { + +/** This structure contains all attributes required for path stroking.<p> + + Path stroking is the process of drawing a polygon with a thick + pen. The various attributes contained in this structure can be + used to customize that process.<p> + */ +struct StrokeAttributes +{ + /** Defines the width of the stroke, measured in user + coordinate space. + + This value must be positive (or 0.0) + */ + double StrokeWidth; + + + /** Determines the maximal length of the diagonal in mitered + corners.<p> + + This attribute is only used when + StrokeAttributes::JoinType is set to + PathJoinType::MITER. Should the length of a + corner's diagonal exceed this limit, a beveled join is used + instead. This value must be positive (or 0.0, which is + equivalent to setting + StrokeAttributes::JoinType to + PathJoinType::BEVEL.<p> + + Before performing the actual comparison, implementations will + multiply the MiterLimit with the current StrokeWidth, such + that, with phi being the angle between the two joining + segments, MiterLimit=1/sin(phi/2.0).<p> + */ + double MiterLimit; + + + /** Array of ink on and off lengths, measured in user coordinate + space.<p> + + The first element specifies the length of the first "on" + segment of the dashing, the second element the length of the + first "off" segment, and so forth. Give zero elements here for + solid strokes. This array always have an even number of + elements, with zero, as usual, counting as even + here. Furthermore, each entry in this array must have a value + that is positive (or 0.0)<p> + */ + sequence<double> DashArray; + + + /** Array of line widths and spacings for multiple-line + strokes.<p> + + The entries here are relative to the + StrokeAttributes::StrokeWidth attribute + above, i.e. the total width of all lines and spacings will + always equal + StrokeAttributes::StrokeWidth. The first + element specifies the width of the rightmost line, when + traveling from the start point of the path to the end + point. The second element specifies the space between the + first line and the second line, and so forth. If the array + ends with a spacing, this spacing is included in the total + width of the multiple-line stroke. That is, the stroke becomes + asymmetric.<p> + */ + sequence<double> LineArray; + + + /** The start shape of the stroke.<p> + + The start point is the first point of every polygon of the + path poly-polygon.<p> + + @see PathCapType + */ + byte StartCapType; + + + /** The end shape of the stroke.<p> + + The end point is the last point of every polygon of the path + poly-polygon.<p> + + @see PathCapType + */ + byte EndCapType; + + + /** The join shape of the stroke.<p> + + After every sub-stroke, i.e. after every line or curve segment + within a single path polygon, a shape of this type is inserted + into the stroke to glue the segments together. Please note + that distinct polygons within the path poly-polygon are not + connected, and therefore also not joined via the shape + specified here.<p> + + @see PathJoinType + */ + byte JoinType; + +}; + +}; }; }; }; + +#endif + +/* vim:set shiftwidth=4 softtabstop=4 expandtab: */ |