# OfficeSvgFormatting

Shared SVG formatting helpers used by OfficeIMO renderers.

Class 

`OfficeIMO.Drawing`

**Namespace**

`OfficeIMO.Drawing`

**Assembly**

`OfficeIMO.Core`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[OfficeSvgFormatting.cs:19](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L19)

**Modifiers**

static

Shared SVG formatting helpers used by OfficeIMO renderers.

## Inheritance

- object
- OfficeSvgFormatting

Filter members 

Show inherited

## Methods

`public static StringBuilder AppendAttribute(StringBuilder builder, string attributeName, string? value)` [#](#method-appendattribute-text-stringbuilder-string-string)

[OfficeSvgFormatting.cs:94](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L94)

Appends an escaped SVG attribute to a markup builder.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**attributeName string required**

Attribute name.

**value string? required**

Attribute value.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendCircleElement 2 overloads

`public static StringBuilder AppendCircleElement(StringBuilder builder, double cx, double cy, double radius, string? attributes = null)` [#](#method-appendcircleelement-text-stringbuilder-double-double-double-string)

[OfficeSvgFormatting.cs:518](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L518)

Appends a complete SVG circle element using shared numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**cx double required**

Circle center x-coordinate.

**cy double required**

Circle center y-coordinate.

**radius double required**

Circle radius.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the geometry.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendCircleElement(StringBuilder builder, double cx, double cy, double radius, OfficeColor fill)` [#](#method-appendcircleelement-text-stringbuilder-double-double-double-officeimo-officecolor)

[OfficeSvgFormatting.cs:540](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L540)

Appends a complete filled SVG circle element using shared paint formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**cx double required**

Circle center x-coordinate.

**cy double required**

Circle center y-coordinate.

**radius double required**

Circle radius.

**fill OfficeIMO.OfficeColor required**

Circle fill color.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendClipPathReference(StringBuilder builder, string clipPathId)` [#](#method-appendclippathreference-text-stringbuilder-string)

[OfficeSvgFormatting.cs:343](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L343)

Appends an SVG clip-path reference attribute for the supplied clip path identifier.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**clipPathId string required**

Clip path identifier without the leading #.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendEllipseElement 2 overloads

`public static StringBuilder AppendEllipseElement(StringBuilder builder, double cx, double cy, double rx, double ry, string? attributes = null)` [#](#method-appendellipseelement-text-stringbuilder-double-double-double-double-string)

[OfficeSvgFormatting.cs:560](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L560)

Appends a complete SVG ellipse element using shared numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**cx double required**

Ellipse center x-coordinate.

**cy double required**

Ellipse center y-coordinate.

**rx double required**

Horizontal radius.

**ry double required**

Vertical radius.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the geometry.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendEllipseElement(StringBuilder builder, double cx, double cy, double rx, double ry, OfficeColor fill)` [#](#method-appendellipseelement-text-stringbuilder-double-double-double-double-officeimo-officecolor)

[OfficeSvgFormatting.cs:584](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L584)

Appends a complete filled SVG ellipse element using shared paint formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**cx double required**

Ellipse center x-coordinate.

**cy double required**

Ellipse center y-coordinate.

**rx double required**

Horizontal radius.

**ry double required**

Vertical radius.

**fill OfficeIMO.OfficeColor required**

Ellipse fill color.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendHatchPatternRectangle(StringBuilder builder, double x, double y, double width, double height, OfficeColor color, double step, double lineWidth, OfficeHatchPatternKind pattern)` [#](#method-appendhatchpatternrectangle-text-stringbuilder-double-double-double-double-officeimo-officecolor-double-double-officeimo-drawing-officehatchpatternkind)

[OfficeSvgFormatting.HatchPatterns.cs:13](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.HatchPatterns.cs#L13)

Appends SVG elements for a shared hatch pattern over the supplied rectangle.

Parameters

**builder System.Text.StringBuilder required**

**x double required**

**y double required**

**width double required**

**height double required**

**color OfficeIMO.OfficeColor required**

**step double required**

**lineWidth double required**

**pattern OfficeIMO.Drawing.OfficeHatchPatternKind required**

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendLinearGradientDefinition(StringBuilder builder, string id, OfficeLinearGradient gradient)` [#](#method-appendlineargradientdefinition-text-stringbuilder-string-officeimo-drawing-officelineargradient)

[OfficeSvgFormatting.Gradients.cs:14](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.Gradients.cs#L14)

Appends a reusable SVG linear-gradient definition.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**id string required**

Gradient identifier.

**gradient OfficeIMO.Drawing.OfficeLinearGradient required**

Gradient definition.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendLineElement 2 overloads

`public static StringBuilder AppendLineElement(StringBuilder builder, double x1, double y1, double x2, double y2, string? attributes = null)` [#](#method-appendlineelement-text-stringbuilder-double-double-double-double-string)

[OfficeSvgFormatting.cs:657](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L657)

Appends a complete SVG line element using shared numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x1 double required**

Line start x-coordinate.

**y1 double required**

Line start y-coordinate.

**x2 double required**

Line end x-coordinate.

**y2 double required**

Line end y-coordinate.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the coordinates.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendLineElement(StringBuilder builder, double x1, double y1, double x2, double y2, OfficeColor stroke, double strokeWidth, OfficeStrokeDashStyle dashStyle = Solid, OfficeStrokeLineCap? lineCap = null)` [#](#method-appendlineelement-text-stringbuilder-double-double-double-double-officeimo-officecolor-double-officeimo-drawing-officestrokedashstyle-nullable-officeimo-drawing-officestrokelinecap)

[OfficeSvgFormatting.cs:684](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L684)

Appends a complete stroked SVG line element using shared paint, dash, and cap formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x1 double required**

Line start x-coordinate.

**y1 double required**

Line start y-coordinate.

**x2 double required**

Line end x-coordinate.

**y2 double required**

Line end y-coordinate.

**stroke OfficeIMO.OfficeColor required**

Stroke color.

**strokeWidth double required**

Stroke width.

**dashStyle OfficeIMO.Drawing.OfficeStrokeDashStyle = Solid optional**

Stroke dash style.

**lineCap OfficeIMO.Drawing.OfficeStrokeLineCap? = null optional**

Optional stroke line cap.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendMatrixTransformAttribute(StringBuilder builder, OfficeTransform transform, double placementX = 0, double placementY = 0)` [#](#method-appendmatrixtransformattribute-text-stringbuilder-officeimo-drawing-officetransform-double-double)

[OfficeSvgFormatting.cs:399](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L399)

Appends an SVG matrix transform attribute using shared invariant numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**transform OfficeIMO.Drawing.OfficeTransform required**

Affine transform matrix.

**placementX double = 0 optional**

Additional x placement offset applied to the transform.

**placementY double = 0 optional**

Additional y placement offset applied to the transform.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendMoveLinePathData(StringBuilder builder, IReadOnlyList<OfficePoint> points, bool closePath = false)` [#](#method-appendmovelinepathdata-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepoint-boolean)

[OfficeSvgFormatting.cs:841](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L841)

Appends SVG path data for a move/line polyline or polygon using shared invariant numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**points System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePoint> required**

Points to serialize.

**closePath bool = false optional**

When true, appends a close-path command after at least one point.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendNestedSvg 2 overloads

`public static StringBuilder AppendNestedSvg(StringBuilder builder, double x, double y, double width, double height, string innerContent)` [#](#method-appendnestedsvg-text-stringbuilder-double-double-double-double-string)

[OfficeSvgFormatting.cs:223](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L223)

Appends a nested SVG viewport with the supplied inner content.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x double required**

Nested viewport x-coordinate.

**y double required**

Nested viewport y-coordinate.

**width double required**

Nested viewport width.

**height double required**

Nested viewport height.

**innerContent string required**

SVG content to place inside the nested viewport.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendNestedSvg(StringBuilder builder, double x, double y, double width, double height, double viewBoxWidth, double viewBoxHeight, string innerContent)` [#](#method-appendnestedsvg-text-stringbuilder-double-double-double-double-double-double-string)

[OfficeSvgFormatting.cs:241](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L241)

Appends a nested SVG viewport with explicit local coordinate bounds and the supplied inner content.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x double required**

Nested viewport x-coordinate.

**y double required**

Nested viewport y-coordinate.

**width double required**

Nested viewport width.

**height double required**

Nested viewport height.

**viewBoxWidth double required**

Nested viewport local coordinate width.

**viewBoxHeight double required**

Nested viewport local coordinate height.

**innerContent string required**

SVG content to place inside the nested viewport.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendNestedSvgEnd(StringBuilder builder)` [#](#method-appendnestedsvgend-text-stringbuilder)

[OfficeSvgFormatting.cs:208](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L208)

Appends the end tag for a nested SVG viewport.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendNestedSvgStart 2 overloads

`public static StringBuilder AppendNestedSvgStart(StringBuilder builder, double x, double y, double width, double height)` [#](#method-appendnestedsvgstart-text-stringbuilder-double-double-double-double)

[OfficeSvgFormatting.cs:177](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L177)

Appends the start tag for a nested SVG viewport.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x double required**

Nested viewport x-coordinate.

**y double required**

Nested viewport y-coordinate.

**width double required**

Nested viewport width.

**height double required**

Nested viewport height.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendNestedSvgStart(StringBuilder builder, double x, double y, double width, double height, double viewBoxWidth, double viewBoxHeight)` [#](#method-appendnestedsvgstart-text-stringbuilder-double-double-double-double-double-double)

[OfficeSvgFormatting.cs:192](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L192)

Appends the start tag for a nested SVG viewport with an explicit local coordinate space.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x double required**

Nested viewport x-coordinate.

**y double required**

Nested viewport y-coordinate.

**width double required**

Nested viewport width.

**height double required**

Nested viewport height.

**viewBoxWidth double required**

Nested viewport local coordinate width.

**viewBoxHeight double required**

Nested viewport local coordinate height.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendNumberAttribute(StringBuilder builder, string attributeName, double value)` [#](#method-appendnumberattribute-text-stringbuilder-string-double)

[OfficeSvgFormatting.cs:110](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L110)

Appends a numeric SVG attribute using shared invariant formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**attributeName string required**

Attribute name.

**value double required**

Numeric attribute value.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendPaintAttribute(StringBuilder builder, string attributeName, OfficeColor color)` [#](#method-appendpaintattribute-text-stringbuilder-string-officeimo-officecolor)

[OfficeSvgFormatting.cs:254](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L254)

Appends an SVG paint attribute and matching opacity attribute when the color is transparent.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**attributeName string required**

Paint attribute name, such as fill or stroke.

**color OfficeIMO.OfficeColor required**

Office color.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendParallelLineElements(StringBuilder builder, double x1, double y1, double x2, double y2, OfficeColor stroke, double strokeWidth, double separation, OfficeStrokeDashStyle dashStyle = Solid, OfficeStrokeLineCap? lineCap = null)` [#](#member-dd4b8214b4cbc573ac99dd41)

[OfficeSvgFormatting.cs:726](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L726)

Appends two complete parallel SVG line elements using shared paint, dash, and cap formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x1 double required**

Source line start X coordinate.

**y1 double required**

Source line start Y coordinate.

**x2 double required**

Source line end X coordinate.

**y2 double required**

Source line end Y coordinate.

**stroke OfficeIMO.OfficeColor required**

Stroke color.

**strokeWidth double required**

Stroke width.

**separation double required**

Distance between the two parallel line centers.

**dashStyle OfficeIMO.Drawing.OfficeStrokeDashStyle = Solid optional**

Stroke dash style.

**lineCap OfficeIMO.Drawing.OfficeStrokeLineCap? = null optional**

Optional stroke line cap.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendPathData(StringBuilder builder, IReadOnlyList<OfficePathCommand> commands, double offsetX = 0, double offsetY = 0)` [#](#method-appendpathdata-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepathcommand-double-double)

[OfficeSvgFormatting.PathData.cs:29](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.PathData.cs#L29)

Appends SVG path data for shared Office path commands using invariant numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**commands System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePathCommand> required**

Path commands to serialize.

**offsetX double = 0 optional**

Additional x offset applied to command points.

**offsetY double = 0 optional**

Additional y offset applied to command points.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendPathElement 2 overloads

`public static StringBuilder AppendPathElement(StringBuilder builder, string pathData, string? attributes = null)` [#](#method-appendpathelement-text-stringbuilder-string-string)

[OfficeSvgFormatting.cs:783](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L783)

Appends a complete SVG path element using shared attribute escaping.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**pathData string required**

SVG path data.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the path data.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendPathElement(StringBuilder builder, IReadOnlyList<OfficePathCommand> commands, double offsetX = 0, double offsetY = 0, string? attributes = null)` [#](#method-appendpathelement-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepathcommand-double-double-string)

[OfficeSvgFormatting.cs:803](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L803)

Appends a complete SVG path element from shared Office path commands.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**commands System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePathCommand> required**

Path commands to serialize.

**offsetX double = 0 optional**

Additional x offset applied to command points.

**offsetY double = 0 optional**

Additional y offset applied to command points.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the path data.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendPointsAttribute(StringBuilder builder, IReadOnlyList<OfficePoint> points)` [#](#method-appendpointsattribute-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepoint)

[OfficeSvgFormatting.cs:477](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L477)

Appends an SVG points attribute for point-list based elements.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**points System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePoint> required**

Point list.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendPolygonElement 2 overloads

`public static StringBuilder AppendPolygonElement(StringBuilder builder, IReadOnlyList<OfficePoint> points, string? attributes = null)` [#](#method-appendpolygonelement-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepoint-string)

[OfficeSvgFormatting.cs:743](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L743)

Appends a complete SVG polygon element using shared point-list formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**points System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePoint> required**

Polygon points.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after points.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendPolygonElement(StringBuilder builder, IReadOnlyList<OfficePoint> points, OfficeColor fill, OfficeColor? stroke = null, double strokeWidth = 0)` [#](#method-appendpolygonelement-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepoint-officeimo-officecolor-nullable-officeimo-officecolor-double)

[OfficeSvgFormatting.cs:763](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L763)

Appends a complete SVG polygon element with shared fill/stroke formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**points System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePoint> required**

Polygon points.

**fill OfficeIMO.OfficeColor required**

Polygon fill color.

**stroke OfficeIMO.OfficeColor? = null optional**

Optional polygon stroke color.

**strokeWidth double = 0 optional**

Optional polygon stroke width.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendPolylineElement(StringBuilder builder, IReadOnlyList<OfficePoint> points, string? attributes = null)` [#](#method-appendpolylineelement-text-stringbuilder-collections-generic-ireadonlylist-officeimo-drawing-officepoint-string)

[OfficeSvgFormatting.cs:498](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L498)

Appends a complete SVG polyline element using shared point-list formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**points System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePoint> required**

Polyline points.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append before points.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendRadialGradientDefinition(StringBuilder builder, string id, OfficeRadialGradient gradient)` [#](#method-appendradialgradientdefinition-text-stringbuilder-string-officeimo-drawing-officeradialgradient)

[OfficeSvgFormatting.Gradients.cs:75](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.Gradients.cs#L75)

Appends a reusable SVG radial-gradient definition.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**id string required**

Gradient identifier.

**gradient OfficeIMO.Drawing.OfficeRadialGradient required**

Gradient definition.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendRectClipPathDefinition(StringBuilder builder, string clipPathId, double x, double y, double width, double height, bool wrapInDefs = false)` [#](#method-appendrectclippathdefinition-text-stringbuilder-string-double-double-double-double-boolean)

[OfficeSvgFormatting.cs:450](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L450)

Appends an SVG rectangular clip path definition.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**clipPathId string required**

Clip path identifier.

**x double required**

Clip rectangle left coordinate.

**y double required**

Clip rectangle top coordinate.

**width double required**

Clip rectangle width.

**height double required**

Clip rectangle height.

**wrapInDefs bool = false optional**

When true, wraps the clip path in a defs element.

Returns

`StringBuilder` The supplied builder for call chaining.

AppendRectElement 2 overloads

`public static StringBuilder AppendRectElement(StringBuilder builder, double x, double y, double width, double height, string? attributes = null)` [#](#method-appendrectelement-text-stringbuilder-double-double-double-double-string)

[OfficeSvgFormatting.cs:605](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L605)

Appends a complete SVG rectangle element using shared numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x double required**

Rectangle x-coordinate.

**y double required**

Rectangle y-coordinate.

**width double required**

Rectangle width.

**height double required**

Rectangle height.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the geometry.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendRectElement(StringBuilder builder, double x, double y, double width, double height, double rx, double ry, string? attributes = null)` [#](#method-appendrectelement-text-stringbuilder-double-double-double-double-double-double-string)

[OfficeSvgFormatting.cs:631](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L631)

Appends a complete SVG rounded rectangle element using shared numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**x double required**

Rectangle x-coordinate.

**y double required**

Rectangle y-coordinate.

**width double required**

Rectangle width.

**height double required**

Rectangle height.

**rx double required**

Horizontal corner radius.

**ry double required**

Vertical corner radius.

**attributes string? = null optional**

Optional already-formatted SVG attributes to append after the geometry.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendRotateTransformAttribute(StringBuilder builder, double degrees, double centerX, double centerY)` [#](#method-appendrotatetransformattribute-text-stringbuilder-double-double-double)

[OfficeSvgFormatting.cs:372](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L372)

Appends an SVG rotate transform attribute using shared invariant numeric formatting.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**degrees double required**

Rotation angle in degrees.

**centerX double required**

Rotation center x-coordinate.

**centerY double required**

Rotation center y-coordinate.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendStrokeDashArrayAttribute(StringBuilder builder, string? dashArray)` [#](#method-appendstrokedasharrayattribute-text-stringbuilder-string)

[OfficeSvgFormatting.cs:319](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L319)

Appends an SVG stroke-dasharray attribute when a dash pattern is present.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**dashArray string? required**

SVG dash-array value, or null for solid strokes.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendStrokeDashStyleAttribute(StringBuilder builder, OfficeStrokeDashStyle dashStyle, double strokeWidth)` [#](#method-appendstrokedashstyleattribute-text-stringbuilder-officeimo-drawing-officestrokedashstyle-double)

[OfficeSvgFormatting.cs:334](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L334)

Appends an SVG stroke-dasharray attribute for a shared Office stroke dash style.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**dashStyle OfficeIMO.Drawing.OfficeStrokeDashStyle required**

Office stroke dash style.

**strokeWidth double required**

Rendered stroke width.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendStrokeLineCapAttribute(StringBuilder builder, OfficeStrokeLineCap cap)` [#](#method-appendstrokelinecapattribute-text-stringbuilder-officeimo-drawing-officestrokelinecap)

[OfficeSvgFormatting.cs:301](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L301)

Appends an SVG stroke-linecap attribute.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**cap OfficeIMO.Drawing.OfficeStrokeLineCap required**

Stroke line cap.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static StringBuilder AppendStrokeLineJoinAttribute(StringBuilder builder, OfficeStrokeLineJoin join)` [#](#method-appendstrokelinejoinattribute-text-stringbuilder-officeimo-drawing-officestrokelinejoin)

[OfficeSvgFormatting.cs:310](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L310)

Appends an SVG stroke-linejoin attribute.

Parameters

**builder System.Text.StringBuilder required**

Markup builder.

**join OfficeIMO.Drawing.OfficeStrokeLineJoin required**

Stroke line join.

Returns

`StringBuilder` The supplied builder for call chaining.

`public static string Escape(string? value)` [#](#method-escape-string)

[OfficeSvgFormatting.cs:42](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L42)

Escapes text for XML/SVG attribute or element content.

Parameters

**value string? required**

Text to escape.

Returns

`string` Escaped text, or an empty string for null.

`public static string ExtractSvgInner(string svg)` [#](#method-extractsvginner-string)

[OfficeSvgFormatting.cs:118](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L118)

Extracts the content inside an SVG root element.

Parameters

**svg string required**

SVG markup, or already-inner SVG content.

Returns

`string` Inner SVG markup when a root SVG element is found; otherwise the original value.

`public static string? FormatImageFrameTransform(OfficeImageFrameTransform transform)` [#](#method-formatimageframetransform-officeimo-drawing-officeimageframetransform)

[OfficeSvgFormatting.cs:407](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L407)

Formats an SVG image frame transform using shared projection rotation and mirror semantics.

Parameters

**transform OfficeIMO.Drawing.OfficeImageFrameTransform required**

Image frame transform.

Returns

`string?` SVG transform value, or null when the frame transform is identity.

`public static string FormatMatrixTransform(OfficeTransform transform, double placementX = 0, double placementY = 0)` [#](#method-formatmatrixtransform-officeimo-drawing-officetransform-double-double)

[OfficeSvgFormatting.cs:382](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L382)

Formats an SVG matrix transform using shared invariant numeric formatting.

Parameters

**transform OfficeIMO.Drawing.OfficeTransform required**

Affine transform matrix.

**placementX double = 0 optional**

Additional x placement offset applied to the transform.

**placementY double = 0 optional**

Additional y placement offset applied to the transform.

Returns

`string` SVG matrix transform value.

`public static string FormatMoveLinePathData(IReadOnlyList<OfficePoint> points, bool closePath = false)` [#](#method-formatmovelinepathdata-collections-generic-ireadonlylist-officeimo-drawing-officepoint-boolean)

[OfficeSvgFormatting.cs:828](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L828)

Formats SVG path data for a move/line polyline or polygon using shared invariant numeric formatting.

Parameters

**points System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePoint> required**

Points to serialize.

**closePath bool = false optional**

When true, appends a close-path command after at least one point.

Returns

`string` SVG path data, or an empty string when no points are supplied.

`public static string FormatNumber(double value)` [#](#method-formatnumber-double)

[OfficeSvgFormatting.cs:19](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L19)

Formats a numeric SVG attribute value using invariant culture and compact precision.

Parameters

**value double required**

Numeric value to format.

Returns

`string` Formatted SVG number.

`public static string FormatPathData(IReadOnlyList<OfficePathCommand> commands, double offsetX = 0, double offsetY = 0)` [#](#method-formatpathdata-collections-generic-ireadonlylist-officeimo-drawing-officepathcommand-double-double)

[OfficeSvgFormatting.PathData.cs:15](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.PathData.cs#L15)

Formats SVG path data for shared Office path commands using invariant numeric formatting.

Parameters

**commands System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficePathCommand> required**

Path commands to serialize.

**offsetX double = 0 optional**

Additional x offset applied to command points.

**offsetY double = 0 optional**

Additional y offset applied to command points.

Returns

`string` SVG path data, or an empty string when no commands are supplied.

FormatRotateTransform 2 overloads

`public static string FormatRotateTransform(double degrees, double centerX, double centerY)` [#](#method-formatrotatetransform-double-double-double)

[OfficeSvgFormatting.cs:353](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L353)

Formats an SVG rotate transform using shared invariant numeric formatting.

Parameters

**degrees double required**

Rotation angle in degrees.

**centerX double required**

Rotation center x-coordinate.

**centerY double required**

Rotation center y-coordinate.

Returns

`string` SVG rotate transform value.

`public static string FormatRotateTransform(double degrees)` [#](#method-formatrotatetransform-double)

[OfficeSvgFormatting.cs:361](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L361)

Formats an SVG rotate transform around the current transform origin using shared invariant numeric formatting.

Parameters

**degrees double required**

Rotation angle in degrees.

Returns

`string` SVG rotate transform value.

`public static string FormatStrokeLineCap(OfficeStrokeLineCap cap)` [#](#method-formatstrokelinecap-officeimo-drawing-officestrokelinecap)

[OfficeSvgFormatting.cs:270](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L270)

Converts a stroke line cap value to an SVG attribute value.

Parameters

**cap OfficeIMO.Drawing.OfficeStrokeLineCap required**

Stroke line cap.

Returns

`string` SVG stroke-linecap value.

`public static string FormatStrokeLineJoin(OfficeStrokeLineJoin join)` [#](#method-formatstrokelinejoin-officeimo-drawing-officestrokelinejoin)

[OfficeSvgFormatting.cs:286](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L286)

Converts a stroke line join value to an SVG attribute value.

Parameters

**join OfficeIMO.Drawing.OfficeStrokeLineJoin required**

Stroke line join.

Returns

`string` SVG stroke-linejoin value.

`public static string ToCssColor(OfficeColor color)` [#](#method-tocsscolor-officeimo-officecolor)

[OfficeSvgFormatting.cs:77](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L77)

Converts an Office color to a CSS RGB hex color for SVG paint attributes.

Parameters

**color OfficeIMO.OfficeColor required**

Office color.

Returns

`string` CSS color in #RRGGBB form.

`public static double ToOpacity(OfficeColor color)` [#](#method-toopacity-officeimo-officecolor)

[OfficeSvgFormatting.cs:84](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L84)

Converts an Office color alpha channel to an SVG opacity value.

Parameters

**color OfficeIMO.OfficeColor required**

Office color.

Returns

`double` Opacity between 0 and 1.

`public static void WriteColorAttribute(XmlWriter writer, string attributeName, OfficeColor color)` [#](#method-writecolorattribute-xml-xmlwriter-string-officeimo-officecolor)

[OfficeSvgFormatting.cs:882](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L882)

Writes an SVG color attribute and matching opacity attribute when transparency is present.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving SVG attributes.

**attributeName string required**

SVG paint attribute name, such as fill or stroke.

**color OfficeIMO.OfficeColor required**

Office color.

`public static void WriteNumberAttribute(XmlWriter writer, string attributeName, double value)` [#](#method-writenumberattribute-xml-xmlwriter-string-double)

[OfficeSvgFormatting.cs:862](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L862)

Writes a numeric SVG attribute using shared invariant formatting.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**attributeName string required**

Attribute name.

**value double required**

Numeric attribute value.

`public static void WriteRotateTransformAttribute(XmlWriter writer, double degrees, double centerX, double centerY)` [#](#method-writerotatetransformattribute-xml-xmlwriter-double-double-double)

[OfficeSvgFormatting.cs:932](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L932)

Writes an SVG rotate transform attribute using shared invariant numeric formatting.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**degrees double required**

Rotation angle in degrees.

**centerX double required**

Rotation center x-coordinate.

**centerY double required**

Rotation center y-coordinate.

`public static void WriteStrokeDashArrayAttribute(XmlWriter writer, string? dashArray)` [#](#method-writestrokedasharrayattribute-xml-xmlwriter-string)

[OfficeSvgFormatting.cs:910](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L910)

Writes an SVG stroke-dasharray attribute when a dash pattern is present.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**dashArray string? required**

SVG dash-array value, or null for solid strokes.

`public static void WriteStrokeDashStyleAttribute(XmlWriter writer, OfficeStrokeDashStyle dashStyle, double strokeWidth)` [#](#method-writestrokedashstyleattribute-xml-xmlwriter-officeimo-drawing-officestrokedashstyle-double)

[OfficeSvgFormatting.cs:922](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L922)

Writes an SVG stroke-dasharray attribute for a shared Office stroke dash style.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**dashStyle OfficeIMO.Drawing.OfficeStrokeDashStyle required**

Office stroke dash style.

**strokeWidth double required**

Rendered stroke width.

`public static void WriteStrokeLineCapAttribute(XmlWriter writer, OfficeStrokeLineCap cap)` [#](#method-writestrokelinecapattribute-xml-xmlwriter-officeimo-drawing-officestrokelinecap)

[OfficeSvgFormatting.cs:894](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L894)

Writes an SVG stroke-linecap attribute.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**cap OfficeIMO.Drawing.OfficeStrokeLineCap required**

Stroke line cap.

`public static void WriteStrokeLineJoinAttribute(XmlWriter writer, OfficeStrokeLineJoin join)` [#](#method-writestrokelinejoinattribute-xml-xmlwriter-officeimo-drawing-officestrokelinejoin)

[OfficeSvgFormatting.cs:902](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L902)

Writes an SVG stroke-linejoin attribute.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**join OfficeIMO.Drawing.OfficeStrokeLineJoin required**

Stroke line join.

`public static void WriteViewBoxAttribute(XmlWriter writer, double minX, double minY, double width, double height)` [#](#method-writeviewboxattribute-xml-xmlwriter-double-double-double-double)

[OfficeSvgFormatting.cs:873](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeSvgFormatting.cs#L873)

Writes an SVG viewBox attribute using shared invariant numeric formatting.

Parameters

**writer System.Xml.XmlWriter required**

XML writer receiving the attribute.

**minX double required**

Minimum x-coordinate.

**minY double required**

Minimum y-coordinate.

**width double required**

ViewBox width.

**height double required**

ViewBox height.

## Inherited Methods

`public virtual bool Equals(object? obj)` [#](#method-equals-object)

Inherited from object

Parameters

**obj object? required**

Returns

`bool`

`public virtual int GetHashCode()` [#](#method-gethashcode)

Inherited from object

Returns

`int`

`public Type GetType()` [#](#method-gettype)

Inherited from object

Returns

`Type`

`public virtual string? ToString()` [#](#method-tostring)

Inherited from object

Returns

`string?`

<!-- PowerForge markdown artifact sha256:1C94934E764DD87C5C9AE2D5AAC77F32D0B1FD5009C93BBDD9590D013DF66D29 -->
