# OfficeDrawing

Dependency-free vector drawing canvas shared by OfficeIMO document packages.

Class 

`OfficeIMO.Drawing`

**Namespace**

`OfficeIMO.Drawing`

**Assembly**

`OfficeIMO.Core`

**Source revision**

`ba882f6b0d07` with working tree changes

**Source**

[OfficeDrawing.cs:10](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L10)

**Modifiers**

sealed

Dependency-free vector drawing canvas shared by OfficeIMO document packages. Coordinates are expressed in the caller's layout unit and use a local top-left origin.

## Inheritance

- object
- OfficeDrawing

## Usage

Explore 58 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

### Returned or exposed by 38

- Method [OfficeChartDrawingRenderer.Render](/api/core/officeimo-drawing-officechartdrawingrenderer/#method-render-officeimo-drawing-officechartsnapshot-boolean)
- Property [OfficeChartRenderingResult.Drawing](/api/core/officeimo-drawing-officechartrenderingresult/#property-drawing)
- Method [OfficeConicGradient.CreateDrawing](/api/core/officeimo-drawing-officeconicgradient/#method-createdrawing-double-double-int32)
- Method [OfficeDrawing.AddActualTextDrawing](/api/core/officeimo-drawing-officedrawing/#method-addactualtextdrawing-string-officeimo-drawing-officedrawing-double-double)
- Method [OfficeDrawing.AddBorderBox](/api/core/officeimo-drawing-officedrawing/#method-addborderbox-double-double-double-double-nullable-officeimo-officecolor-officeimo-drawing-officeborderbox-nullable-officeimo-drawing-officetransform)
- Method [OfficeDrawing.AddClippedDrawing](/api/core/officeimo-drawing-officedrawing/#method-addclippeddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath)
- Method [OfficeDrawing.AddClippedImage](/api/core/officeimo-drawing-officedrawing/#method-addclippedimage-byte-string-officeimo-drawing-officeimageprojection-double-double-officeimo-drawing-officeclippath-string-double)
- Method [OfficeDrawing.AddClippedImageWithInterpolation](/api/core/officeimo-drawing-officedrawing/#method-addclippedimagewithinterpolation-byte-string-officeimo-drawing-officeimageprojection-boolean-double-double-officeimo-drawing-officeclippath-string-double)
- Method [OfficeDrawing.AddClippedPositionedText](/api/core/officeimo-drawing-officedrawing/#method-addclippedpositionedtext-string-double-double-double-double-double-double-officeimo-drawing-officeclippath-officeimo-drawing-officeimageframetransform-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double-nullable-system-double)
- Method [OfficeDrawing.AddClippedText](/api/core/officeimo-drawing-officedrawing/#method-addclippedtext-string-double-double-double-double-double-double-officeimo-drawing-officeclippath-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double-officeimo-drawing-officetextverticalalignment-double-nullable-system-double-nullable-system-double-boolean-boolean-boolean-boolean-boolean-nullable-officeimo-drawing-officetextpadding-nullable-officeimo-drawing-officetextparagraphindent)
- Method [OfficeDrawing.AddDrawing](/api/core/officeimo-drawing-officedrawing/#method-adddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeimageframetransform)
- Method [OfficeDrawing.AddEffectDrawing](/api/core/officeimo-drawing-officedrawing/#method-addeffectdrawing-officeimo-drawing-officedrawing-officeimo-drawing-officetransform-officeimo-drawing-officeblendmode-officeimo-drawing-officedrawingsoftmask-double)
- Method [OfficeDrawing.AddFont](/api/core/officeimo-drawing-officedrawing/#method-addfont-string-byte-officeimo-drawing-officefontstyle)
- Method [OfficeDrawing.AddImage](/api/core/officeimo-drawing-officedrawing/#method-addimage-byte-string-officeimo-drawing-officeimageprojection-string-double)
- Method [OfficeDrawing.AddImageBehindContent](/api/core/officeimo-drawing-officedrawing/#method-addimagebehindcontent-byte-string-officeimo-drawing-officeimageprojection-string-double)
- Method [OfficeDrawing.AddImagePattern](/api/core/officeimo-drawing-officedrawing/#method-addimagepattern-byte-string-officeimo-drawing-officeimagepatternlayout-int32-double)
- Method [OfficeDrawing.AddImageWithInterpolation](/api/core/officeimo-drawing-officedrawing/#method-addimagewithinterpolation-byte-string-officeimo-drawing-officeimageprojection-boolean-string-double)
- Method [OfficeDrawing.AddLink](/api/core/officeimo-drawing-officedrawing/#method-addlink-string-double-double-double-double-string)
- Method [OfficeDrawing.AddPositionedText](/api/core/officeimo-drawing-officedrawing/#method-addpositionedtext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double-nullable-system-double-officeimo-drawing-officetextdecorationstyle-officeimo-drawing-officetextdecorationstyle-officeimo-drawing-officetextbaseline-int32)
- Method [OfficeDrawing.AddRichText](/api/core/officeimo-drawing-officedrawing/#method-addrichtext-collections-generic-ireadonlylist-officeimo-drawing-officerichtextrun-double-double-double-double-officeimo-drawing-officetextalignment-nullable-system-double-officeimo-drawing-officetextverticalalignment-double-nullable-system-double-nullable-system-double-boolean-boolean-boolean-boolean-nullable-officeimo-drawing-officetextpadding-nullable-officeimo-drawing-officetextparagraphindent)
- Method [OfficeDrawing.AddRichTextBehindContent](/api/core/officeimo-drawing-officedrawing/#method-addrichtextbehindcontent-collections-generic-ireadonlylist-officeimo-drawing-officerichtextrun-double-double-double-double-officeimo-drawing-officetextalignment-nullable-system-double-officeimo-drawing-officetextverticalalignment-double-nullable-system-double-nullable-system-double-boolean-boolean-boolean-boolean-nullable-officeimo-drawing-officetextpadding-nullable-officeimo-drawing-officetextparagraphindent)
- Method [OfficeDrawing.AddRichTextParagraphs](/api/core/officeimo-drawing-officedrawing/#method-addrichtextparagraphs-collections-generic-ireadonlylist-officeimo-drawing-officerichtextparagraph-double-double-double-double-officeimo-drawing-officetextareaalignment-officeimo-drawing-officetextverticalalignment-boolean-nullable-officeimo-drawing-officetextpadding)
- Method [OfficeDrawing.AddShape](/api/core/officeimo-drawing-officedrawing/#method-addshape-officeimo-drawing-officeshape-double-double)
- Method [OfficeDrawing.AddShapeBehindContent](/api/core/officeimo-drawing-officedrawing/#method-addshapebehindcontent-officeimo-drawing-officeshape-double-double)
- Method [OfficeDrawing.AddStyledText](/api/core/officeimo-drawing-officedrawing/#method-addstyledtext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double-officeimo-drawing-officetextverticalalignment-double-nullable-system-double-nullable-system-double-boolean-boolean-boolean-boolean-boolean-nullable-officeimo-drawing-officetextpadding-nullable-officeimo-drawing-officetextparagraphindent-officeimo-drawing-officetextdecorationstyle-officeimo-drawing-officetextdecorationstyle-officeimo-drawing-officetextbaseline)
- Method [OfficeDrawing.AddText](/api/core/officeimo-drawing-officedrawing/#method-addtext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double-officeimo-drawing-officetextverticalalignment-double-nullable-system-double-nullable-system-double-boolean-boolean-boolean-boolean-boolean-nullable-officeimo-drawing-officetextpadding-nullable-officeimo-drawing-officetextparagraphindent)
- Method [OfficeDrawing.AddTextBehindContent](/api/core/officeimo-drawing-officedrawing/#method-addtextbehindcontent-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double-officeimo-drawing-officetextverticalalignment-double-nullable-system-double-nullable-system-double-boolean-boolean-boolean-boolean-boolean-nullable-officeimo-drawing-officetextpadding-nullable-officeimo-drawing-officetextparagraphindent)
- Method [OfficeDrawing.AddTilingPattern](/api/core/officeimo-drawing-officedrawing/#method-addtilingpattern-officeimo-drawing-officedrawing-officeimo-drawing-officeimageplacement-double-double-boolean-boolean-nullable-officeimo-drawing-officetransform-double-double-int32-double)
- Method [OfficeDrawing.AddVerticalText](/api/core/officeimo-drawing-officedrawing/#method-addverticaltext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor)
- Method [OfficeDrawing.Clone](/api/core/officeimo-drawing-officedrawing/#method-clone)
- Property [OfficeDrawingEffectGroup.Drawing](/api/core/officeimo-drawing-officedrawingeffectgroup/#property-drawing)
- Property [OfficeDrawingGroup.Drawing](/api/core/officeimo-drawing-officedrawinggroup/#property-drawing)
- Property [OfficeDrawingSoftMask.Drawing](/api/core/officeimo-drawing-officedrawingsoftmask/#property-drawing)
- Property [OfficeDrawingTilingPattern.Tile](/api/core/officeimo-drawing-officedrawingtilingpattern/#property-tile)
- Method [OfficeInkRenderer.Render](/api/core/officeimo-drawing-officeinkrenderer/#method-render-officeimo-drawing-officeinkdocument-double-double-officeimo-drawing-officeinkrenderoptions)
- Method [OfficeMathRenderer.Render](/api/core/officeimo-drawing-officemathrenderer/#method-render-officeimo-drawing-officemathexpression-officeimo-drawing-officemathrenderoptions)
- Method [OfficeSvgForeignObjectRenderer.EndInvoke](/api/core/officeimo-drawing-officesvgforeignobjectrenderer/#method-endinvoke-iasyncresult)
- Method [OfficeSvgForeignObjectRenderer.Invoke](/api/core/officeimo-drawing-officesvgforeignobjectrenderer/#method-invoke-officesvgforeignobjectcontext)

### Accepted by parameters 20

- Constructor [OfficeChartRenderingResult.OfficeChartRenderingResult](/api/core/officeimo-drawing-officechartrenderingresult/#constructor-ctor-officeimo-drawing-officedrawing-officeimo-drawing-officedrawingqualityreport) parameter `drawing`
- Method [OfficeDrawing.AddActualTextDrawing](/api/core/officeimo-drawing-officedrawing/#method-addactualtextdrawing-string-officeimo-drawing-officedrawing-double-double) parameter `drawing`
- Method [OfficeDrawing.AddClippedDrawing](/api/core/officeimo-drawing-officedrawing/#method-addclippeddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath) parameter `drawing`
- Method [OfficeDrawing.AddDrawing](/api/core/officeimo-drawing-officedrawing/#method-adddrawing-officeimo-drawing-officedrawing-double-double) parameter `drawing`
- Method [OfficeDrawing.AddEffectDrawing](/api/core/officeimo-drawing-officedrawing/#method-addeffectdrawing-officeimo-drawing-officedrawing-officeimo-drawing-officetransform-double) parameter `drawing`
- Method [OfficeDrawing.AddTilingPattern](/api/core/officeimo-drawing-officedrawing/#method-addtilingpattern-officeimo-drawing-officedrawing-officeimo-drawing-officeimageplacement-double-double-boolean-boolean-nullable-officeimo-drawing-officetransform-double-double-int32-double) parameter `tile`
- Constructor [OfficeDrawingEffectGroup.OfficeDrawingEffectGroup](/api/core/officeimo-drawing-officedrawingeffectgroup/#constructor-ctor-officeimo-drawing-officedrawing-officeimo-drawing-officetransform-double) parameter `drawing`
- Constructor [OfficeDrawingGroup.OfficeDrawingGroup](/api/core/officeimo-drawing-officedrawinggroup/#constructor-ctor-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath) parameter `drawing`
- Method [OfficeDrawingPortableExporter.TryExportJson](/api/core/officeimo-drawing-officedrawingportableexporter/#method-tryexportjson-officeimo-drawing-officedrawing-officeimo-drawing-officedrawingportableoptions-string-collections-generic-ireadonlylist-officeimo-officediagnostic) parameter `drawing`
- Method [OfficeDrawingQualityAnalyzer.Analyze](/api/core/officeimo-drawing-officedrawingqualityanalyzer/#method-analyze-officeimo-drawing-officedrawing-officeimo-drawing-officedrawingqualityoptions) parameter `drawing`
- Method [OfficeDrawingRasterRenderer.Render](/api/core/officeimo-drawing-officedrawingrasterrenderer/#method-render-officeimo-drawing-officedrawing-double-nullable-officeimo-officecolor) parameter `drawing`
- Method [OfficeDrawingRasterRenderer.ToPng](/api/core/officeimo-drawing-officedrawingrasterrenderer/#method-topng-officeimo-drawing-officedrawing-officeimo-drawing-officedrawingrasterrenderoptions) parameter `drawing`
- Constructor [OfficeDrawingSoftMask.OfficeDrawingSoftMask](/api/core/officeimo-drawing-officedrawingsoftmask/#constructor-ctor-officeimo-drawing-officedrawing-officeimo-drawing-officesoftmaskmode-nullable-officeimo-drawing-officetransform-nullable-officeimo-officecolor) parameter `drawing`
- Method [OfficeDrawingSoftMask.CreateWithLuminosityStandard](/api/core/officeimo-drawing-officedrawingsoftmask/#method-createwithluminositystandard-officeimo-drawing-officedrawing-officeimo-drawing-officesoftmaskluminositystandard-officeimo-drawing-officesoftmaskmode-nullable-officeimo-drawing-officetransform-nullable-officeimo-officecolor) parameter `drawing`
- Method [OfficeDrawingSvgExporter.ToSvg](/api/core/officeimo-drawing-officedrawingsvgexporter/#method-tosvg-officeimo-drawing-officedrawing-double-officeimo-drawing-officesvgsizeunit-officeimo-drawing-iofficerasterimagecodec-string) parameter `drawing`
- Method [OfficeDrawingSvgExporter.ToSvgBytes](/api/core/officeimo-drawing-officedrawingsvgexporter/#method-tosvgbytes-officeimo-drawing-officedrawing-double-officeimo-drawing-officesvgsizeunit-officeimo-drawing-iofficerasterimagecodec-string-threading-cancellationtoken) parameter `drawing`
- Constructor [OfficeDrawingTilingPattern.OfficeDrawingTilingPattern](/api/core/officeimo-drawing-officedrawingtilingpattern/#constructor-ctor-officeimo-drawing-officedrawing-officeimo-drawing-officeimageplacement-double-double-nullable-officeimo-drawing-officetransform-double-double-int32-double) parameter `tile`
- Method [OfficeInkRenderer.AddToDrawing](/api/core/officeimo-drawing-officeinkrenderer/#method-addtodrawing-officeimo-drawing-officedrawing-officeimo-drawing-officeinkdocument-double-double-officeimo-drawing-officeinkrenderoptions) parameter `drawing`
- Method [OfficeMathRenderer.AddToDrawing](/api/core/officeimo-drawing-officemathrenderer/#method-addtodrawing-officeimo-drawing-officedrawing-officeimo-drawing-officemathexpression-double-double-officeimo-drawing-officemathrenderoptions) parameter `drawing`
- Method [OfficeSvgDrawingReader.TryRead](/api/core/officeimo-drawing-officesvgdrawingreader/#method-tryread-byte-officeimo-drawing-officedrawing-int32) parameter `drawing`

Filter members 

Show inherited

## Constructors

`public OfficeDrawing(double width, double height)` [#](#constructor-ctor-double-double)

[OfficeDrawing.cs:10](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L10)

Creates a drawing canvas.

Parameters

**width double required**

**height double required**

## Methods

`public OfficeDrawing AddActualTextDrawing(string actualText, OfficeDrawing drawing, double actualTextAnchorX, double actualTextAnchorY)` [#](#method-addactualtextdrawing-string-officeimo-drawing-officedrawing-double-double)

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

Adds vector paint that represents one logical text string. The paint remains native while PDF and SVG exporters can expose the string once for extraction and accessibility.

Parameters

**actualText string required**

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**actualTextAnchorX double required**

**actualTextAnchorY double required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddBorderBox(double x, double y, double width, double height, OfficeColor? fillColor, OfficeBorderBox borders, OfficeTransform? transform = null)` [#](#method-addborderbox-double-double-double-double-nullable-officeimo-officecolor-officeimo-drawing-officeborderbox-nullable-officeimo-drawing-officetransform)

[OfficeDrawing.BorderBox.cs:8](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.BorderBox.cs#L8)

Adds a filled rectangle and independent edge borders in paint order.

Parameters

**x double required**

**y double required**

**width double required**

**height double required**

**fillColor OfficeIMO.OfficeColor? required**

**borders OfficeIMO.Drawing.OfficeBorderBox required**

**transform OfficeIMO.Drawing.OfficeTransform? = null optional**

Returns

`OfficeDrawing`

AddClippedDrawing 4 overloads

`public OfficeDrawing AddClippedDrawing(OfficeDrawing drawing, double x, double y, OfficeClipPath clipPath)` [#](#method-addclippeddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath)

[OfficeDrawing.cs:606](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L606)

Adds another drawing as a clipped nested group at a local destination offset.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**x double required**

**y double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddClippedDrawing(OfficeDrawing drawing, double x, double y, OfficeClipPath clipPath, OfficeImageFrameTransform frameTransform)` [#](#method-addclippeddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath-officeimo-drawing-officeimageframetransform)

[OfficeDrawing.cs:611](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L611)

Adds another drawing as a clipped nested group at a local destination offset with a shared frame transform.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**x double required**

**y double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**frameTransform OfficeIMO.Drawing.OfficeImageFrameTransform required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddClippedDrawing(OfficeDrawing drawing, double x, double y, OfficeClipPath clipPath, double contentOffsetX, double contentOffsetY)` [#](#method-addclippeddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath-double-double)

[OfficeDrawing.cs:616](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L616)

Adds another drawing as a clipped group with an independent content offset.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**x double required**

**y double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**contentOffsetX double required**

**contentOffsetY double required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddClippedDrawing(OfficeDrawing drawing, double x, double y, OfficeClipPath clipPath, double contentOffsetX, double contentOffsetY, OfficeImageFrameTransform frameTransform)` [#](#method-addclippeddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeclippath-double-double-officeimo-drawing-officeimageframetransform)

[OfficeDrawing.cs:621](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L621)

Adds another drawing as a clipped group with independent content offset and frame transform.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**x double required**

**y double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**contentOffsetX double required**

**contentOffsetY double required**

**frameTransform OfficeIMO.Drawing.OfficeImageFrameTransform required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddClippedImage(byte[] bytes, string? contentType, OfficeImageProjection projection, double clipX, double clipY, OfficeClipPath clipPath, string? alternativeText = null, double opacity = 1)` [#](#method-addclippedimage-byte-string-officeimo-drawing-officeimageprojection-double-double-officeimo-drawing-officeclippath-string-double)

[OfficeDrawing.cs:391](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L391)

Adds an image clipped by a drawing-local clipping path.

Parameters

**bytes byte[] required**

**contentType string? required**

**projection OfficeIMO.Drawing.OfficeImageProjection required**

**clipX double required**

**clipY double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**alternativeText string? = null optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddClippedImageWithInterpolation(byte[] bytes, string? contentType, OfficeImageProjection projection, bool interpolate, double clipX, double clipY, OfficeClipPath clipPath, string? alternativeText = null, double opacity = 1)` [#](#method-addclippedimagewithinterpolation-byte-string-officeimo-drawing-officeimageprojection-boolean-double-double-officeimo-drawing-officeclippath-string-double)

[OfficeDrawing.cs:396](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L396)

Adds an image with explicit scaling interpolation behavior, clipped by a drawing-local path.

Parameters

**bytes byte[] required**

**contentType string? required**

**projection OfficeIMO.Drawing.OfficeImageProjection required**

**interpolate bool required**

**clipX double required**

**clipY double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**alternativeText string? = null optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

AddClippedPositionedText 2 overloads

`public OfficeDrawing AddClippedPositionedText(string text, double x, double y, double width, double height, double clipX, double clipY, OfficeClipPath clipPath, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, double? textAdvanceWidth = null)` [#](#member-3fda8911e0a1df6c6c9dc16c)

[OfficeDrawing.cs:488](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L488)

Adds an already-positioned single text run clipped by a drawing-local clipping path. The clipping frame is independent from the resolved glyph advance retained for rendering.

Parameters

**text string required**

Text content to draw.

**x double required**

Horizontal frame position in drawing units.

**y double required**

Vertical frame position in drawing units.

**width double required**

Text frame width in drawing units.

**height double required**

Text frame height in drawing units.

**clipX double required**

Horizontal clip position in drawing units.

**clipY double required**

Vertical clip position in drawing units.

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

Clip path relative to clipX and clipY.

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

Optional font descriptor.

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

Optional text color.

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

Horizontal alignment inside the frame.

**lineHeight double? = null optional**

Optional resolved line height.

**textAdvanceWidth double? = null optional**

Resolved horizontal glyph advance, or null to use width.

Returns

`OfficeDrawing` The current drawing.

`public OfficeDrawing AddClippedPositionedText(string text, double x, double y, double width, double height, double clipX, double clipY, OfficeClipPath clipPath, OfficeImageFrameTransform frameTransform, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, double? textAdvanceWidth = null)` [#](#member-bab6ad6ec77dc5a445804526)

[OfficeDrawing.PositionedText.cs:135](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.PositionedText.cs#L135)

Adds a transformed source text run inside a drawing-local clip path, retaining the resolved glyph advance and complete source text.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**clipX double required**

**clipY double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**frameTransform OfficeIMO.Drawing.OfficeImageFrameTransform required**

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

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

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**textAdvanceWidth double? = null optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddClippedText(string text, double x, double y, double width, double height, double clipX, double clipY, OfficeClipPath clipPath, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, OfficeTextVerticalAlignment verticalAlignment = Top, double rotationDegrees = 0, double? rotationCenterX = null, double? rotationCenterY = null, bool wrapText = false, bool shrinkToFit = false, bool stackedText = false, bool flipHorizontal = false, bool flipVertical = false, OfficeTextPadding? padding = null, OfficeTextParagraphIndent? paragraphIndent = null)` [#](#member-050d053545179b0fe2a0d3fd)

[OfficeDrawing.cs:417](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L417)

Adds text clipped by a drawing-local clipping path.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**clipX double required**

**clipY double required**

**clipPath OfficeIMO.Drawing.OfficeClipPath required**

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

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

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**rotationDegrees double = 0 optional**

**rotationCenterX double? = null optional**

**rotationCenterY double? = null optional**

**wrapText bool = false optional**

**shrinkToFit bool = false optional**

**stackedText bool = false optional**

**flipHorizontal bool = false optional**

**flipVertical bool = false optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? = null optional**

Returns

`OfficeDrawing`

AddDrawing 2 overloads

`public OfficeDrawing AddDrawing(OfficeDrawing drawing, double x, double y)` [#](#method-adddrawing-officeimo-drawing-officedrawing-double-double)

[OfficeDrawing.cs:564](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L564)

Adds all elements from another drawing at a local destination offset and returns this drawing.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**x double required**

**y double required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddDrawing(OfficeDrawing drawing, double x, double y, OfficeImageFrameTransform frameTransform)` [#](#method-adddrawing-officeimo-drawing-officedrawing-double-double-officeimo-drawing-officeimageframetransform)

[OfficeDrawing.cs:569](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L569)

Adds all elements from another drawing at a local destination offset with a shared frame transform.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**x double required**

**y double required**

**frameTransform OfficeIMO.Drawing.OfficeImageFrameTransform required**

Returns

`OfficeDrawing`

AddEffectDrawing 2 overloads

`public OfficeDrawing AddEffectDrawing(OfficeDrawing drawing, OfficeTransform transform, double opacity = 1)` [#](#method-addeffectdrawing-officeimo-drawing-officedrawing-officeimo-drawing-officetransform-double)

[OfficeDrawing.cs:574](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L574)

Adds another drawing as one affine-transformed, isolated opacity group.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**transform OfficeIMO.Drawing.OfficeTransform required**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddEffectDrawing(OfficeDrawing drawing, OfficeTransform transform, OfficeBlendMode blendMode, OfficeDrawingSoftMask? softMask = null, double opacity = 1)` [#](#method-addeffectdrawing-officeimo-drawing-officedrawing-officeimo-drawing-officetransform-officeimo-drawing-officeblendmode-officeimo-drawing-officedrawingsoftmask-double)

[OfficeDrawing.cs:587](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L587)

Adds another drawing as one affine-transformed group with managed blending and an optional vector soft mask.

Parameters

**drawing OfficeIMO.Drawing.OfficeDrawing required**

**transform OfficeIMO.Drawing.OfficeTransform required**

**blendMode OfficeIMO.Drawing.OfficeBlendMode required**

**softMask OfficeIMO.Drawing.OfficeDrawingSoftMask? = null optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddFont(string familyName, byte[] data, OfficeFontStyle style = Regular)` [#](#method-addfont-string-byte-officeimo-drawing-officefontstyle)

[OfficeDrawing.Fonts.cs:21](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.Fonts.cs#L21)

Adds or replaces a scoped TrueType face and returns this drawing.

Parameters

**familyName string required**

**data byte[] required**

**style OfficeIMO.Drawing.OfficeFontStyle = Regular optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddImage(byte[] bytes, string? contentType, OfficeImageProjection projection, string? alternativeText = null, double opacity = 1)` [#](#method-addimage-byte-string-officeimo-drawing-officeimageprojection-string-double)

[OfficeDrawing.cs:369](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L369)

Adds an image using a shared placement/crop/transform projection and returns this drawing.

Parameters

**bytes byte[] required**

**contentType string? required**

**projection OfficeIMO.Drawing.OfficeImageProjection required**

**alternativeText string? = null optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddImageBehindContent(byte[] bytes, string? contentType, OfficeImageProjection projection, string? alternativeText = null, double opacity = 1)` [#](#method-addimagebehindcontent-byte-string-officeimo-drawing-officeimageprojection-string-double)

[OfficeDrawing.cs:543](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L543)

Adds an image behind existing foreground content while keeping an initial page background underneath it.

Parameters

**bytes byte[] required**

**contentType string? required**

**projection OfficeIMO.Drawing.OfficeImageProjection required**

**alternativeText string? = null optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddImagePattern(byte[] bytes, string? contentType, OfficeImagePatternLayout layout, int maximumTileCount = 16384, double opacity = 1)` [#](#method-addimagepattern-byte-string-officeimo-drawing-officeimagepatternlayout-int32-double)

[OfficeDrawing.ImagePatterns.cs:11](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.ImagePatterns.cs#L11)

Adds a clipped repeating image pattern and returns this drawing.

Parameters

**bytes byte[] required**

**contentType string? required**

**layout OfficeIMO.Drawing.OfficeImagePatternLayout required**

**maximumTileCount int = 16384 optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddImageWithInterpolation(byte[] bytes, string? contentType, OfficeImageProjection projection, bool interpolate, string? alternativeText = null, double opacity = 1)` [#](#method-addimagewithinterpolation-byte-string-officeimo-drawing-officeimageprojection-boolean-string-double)

[OfficeDrawing.cs:374](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L374)

Adds an image using explicit scaling interpolation behavior.

Parameters

**bytes byte[] required**

**contentType string? required**

**projection OfficeIMO.Drawing.OfficeImageProjection required**

**interpolate bool required**

**alternativeText string? = null optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddLink(string uri, double x, double y, double width, double height, string? alternativeText = null)` [#](#method-addlink-string-double-double-double-double-string)

[OfficeDrawing.cs:596](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L596)

Adds a non-painting interactive link rectangle to the drawing scene.

Parameters

**uri string required**

**x double required**

**y double required**

**width double required**

**height double required**

**alternativeText string? = null optional**

Returns

`OfficeDrawing`

AddPositionedText 5 overloads

`public OfficeDrawing AddPositionedText(string text, double x, double y, double width, double height, OfficeFontInfo? font, OfficeColor? color, OfficeTextAlignment alignment, double? lineHeight)` [#](#method-addpositionedtext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double)

[OfficeDrawing.cs:234](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L234)

Adds an already-positioned single text run. The frame width may be clipped independently from the resolved glyph advance retained for backend-consistent positioning.

Parameters

**text string required**

Text content to draw.

**x double required**

Horizontal frame position in drawing units.

**y double required**

Vertical frame position in drawing units.

**width double required**

Clipping frame width in drawing units.

**height double required**

Clipping frame height in drawing units.

**font OfficeIMO.Drawing.OfficeFontInfo? required**

Optional font descriptor.

**color OfficeIMO.OfficeColor? required**

Optional text color.

**alignment OfficeIMO.Drawing.OfficeTextAlignment required**

Horizontal alignment inside the frame.

**lineHeight double? required**

Optional resolved line height.

Returns

`OfficeDrawing` The current drawing.

`public OfficeDrawing AddPositionedText(string text, double x, double y, double width, double height, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, double? textAdvanceWidth = null)` [#](#member-75bb9e4664148aedec53d0fa)

[OfficeDrawing.cs:251](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L251)

Adds an already-positioned single text run with an explicit resolved glyph advance.

Parameters

**text string required**

Text content to draw.

**x double required**

Horizontal frame position in drawing units.

**y double required**

Vertical frame position in drawing units.

**width double required**

Clipping frame width in drawing units.

**height double required**

Clipping frame height in drawing units.

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

Optional font descriptor.

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

Optional text color.

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

Horizontal alignment inside the frame.

**lineHeight double? = null optional**

Optional resolved line height.

**textAdvanceWidth double? = null optional**

Resolved horizontal glyph advance, or null to use width.

Returns

`OfficeDrawing` The current drawing.

`public OfficeDrawing AddPositionedText(string text, double x, double y, double width, double height, OfficeFontInfo? font, OfficeColor? color, OfficeTextAlignment alignment, double? lineHeight, double? textAdvanceWidth, OfficeTextDecorationStyle underlineStyle, OfficeTextDecorationStyle strikethroughStyle, OfficeTextBaseline baseline)` [#](#member-50cf02dcd323e2edae6d8b78)

[OfficeDrawing.cs:268](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L268)

Adds an already-positioned text run with typed decoration and baseline styling.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? required**

**color OfficeIMO.OfficeColor? required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment required**

**lineHeight double? required**

**textAdvanceWidth double? required**

**underlineStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**strikethroughStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**baseline OfficeIMO.Drawing.OfficeTextBaseline required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddPositionedText(string text, double x, double y, double width, double height, OfficeFontInfo? font, OfficeColor? color, OfficeTextAlignment alignment, double? lineHeight, double? textAdvanceWidth, OfficeTextDecorationStyle underlineStyle, OfficeTextDecorationStyle strikethroughStyle, OfficeTextBaseline baseline, int baselineLevel)` [#](#member-3d717d25a8918abaefd6e21e)

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

Adds an already-positioned text run with typed decoration and a cumulative script nesting level.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? required**

**color OfficeIMO.OfficeColor? required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment required**

**lineHeight double? required**

**textAdvanceWidth double? required**

**underlineStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**strikethroughStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**baseline OfficeIMO.Drawing.OfficeTextBaseline required**

**baselineLevel int required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddPositionedText(string text, double x, double y, double width, double height, OfficeImageFrameTransform frameTransform, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, double? textAdvanceWidth = null)` [#](#member-08e8bbbd8fca5fbdf6fce20a)

[OfficeDrawing.PositionedText.cs:121](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.PositionedText.cs#L121)

Adds a resolved source text run with its glyph advance and a destination-space rotation or mirror transform. Source text is clipped, never shortened with an ellipsis.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**frameTransform OfficeIMO.Drawing.OfficeImageFrameTransform required**

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

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

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**textAdvanceWidth double? = null optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddRichText(IReadOnlyList<OfficeRichTextRun> runs, double x, double y, double width, double height, OfficeTextAlignment alignment = Left, double? lineHeight = null, OfficeTextVerticalAlignment verticalAlignment = Top, double rotationDegrees = 0, double? rotationCenterX = null, double? rotationCenterY = null, bool wrapText = true, bool shrinkToFit = false, bool flipHorizontal = false, bool flipVertical = false, OfficeTextPadding? padding = null, OfficeTextParagraphIndent? paragraphIndent = null)` [#](#member-f0822504e78734e453a0b1b9)

[OfficeDrawing.cs:347](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L347)

Adds rich text inside a local drawing rectangle and returns this drawing.

Parameters

**runs System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficeRichTextRun> required**

**x double required**

**y double required**

**width double required**

**height double required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**rotationDegrees double = 0 optional**

**rotationCenterX double? = null optional**

**rotationCenterY double? = null optional**

**wrapText bool = true optional**

**shrinkToFit bool = false optional**

**flipHorizontal bool = false optional**

**flipVertical bool = false optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? = null optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddRichTextBehindContent(IReadOnlyList<OfficeRichTextRun> runs, double x, double y, double width, double height, OfficeTextAlignment alignment = Left, double? lineHeight = null, OfficeTextVerticalAlignment verticalAlignment = Top, double rotationDegrees = 0, double? rotationCenterX = null, double? rotationCenterY = null, bool wrapText = true, bool shrinkToFit = false, bool flipHorizontal = false, bool flipVertical = false, OfficeTextPadding? padding = null, OfficeTextParagraphIndent? paragraphIndent = null)` [#](#member-7da9ca541f692e21b5226407)

[OfficeDrawing.cs:358](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L358)

Adds rich text behind existing foreground content while keeping an initial page background underneath it.

Parameters

**runs System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficeRichTextRun> required**

**x double required**

**y double required**

**width double required**

**height double required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**rotationDegrees double = 0 optional**

**rotationCenterX double? = null optional**

**rotationCenterY double? = null optional**

**wrapText bool = true optional**

**shrinkToFit bool = false optional**

**flipHorizontal bool = false optional**

**flipVertical bool = false optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? = null optional**

Returns

`OfficeDrawing`

AddRichTextParagraphs 2 overloads

`public OfficeDrawing AddRichTextParagraphs(IReadOnlyList<OfficeRichTextParagraph> paragraphs, double x, double y, double width, double height, OfficeTextVerticalAlignment verticalAlignment = Top, bool wrapText = true, OfficeTextPadding? padding = null)` [#](#member-91b6f3a35266dd16044169f8)

[OfficeDrawing.Paragraphs.cs:9](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.Paragraphs.cs#L9)

Adds paragraphs with independent styles and render-time font measurement inside one text frame.

Parameters

**paragraphs System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficeRichTextParagraph> required**

**x double required**

**y double required**

**width double required**

**height double required**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**wrapText bool = true optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddRichTextParagraphs(IReadOnlyList<OfficeRichTextParagraph> paragraphs, double x, double y, double width, double height, OfficeTextAreaAlignment areaAlignment, OfficeTextVerticalAlignment verticalAlignment = Top, bool wrapText = true, OfficeTextPadding? padding = null)` [#](#member-8b4177acbed7b201d246d125)

[OfficeDrawing.Paragraphs.cs:17](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.Paragraphs.cs#L17)

Adds independently aligned paragraphs in an intrinsically sized text area inside one drawing frame.

Parameters

**paragraphs System.Collections.Generic.IReadOnlyList<OfficeIMO.Drawing.OfficeRichTextParagraph> required**

**x double required**

**y double required**

**width double required**

**height double required**

**areaAlignment OfficeIMO.Drawing.OfficeTextAreaAlignment required**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**wrapText bool = true optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddShape(OfficeShape shape, double x, double y)` [#](#method-addshape-officeimo-drawing-officeshape-double-double)

[OfficeDrawing.cs:54](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L54)

Adds a shape at a local top-left coordinate and returns this drawing.

Parameters

**shape OfficeIMO.Drawing.OfficeShape required**

**x double required**

**y double required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddShapeBehindContent(OfficeShape shape, double x, double y)` [#](#method-addshapebehindcontent-officeimo-drawing-officeshape-double-double)

[OfficeDrawing.cs:79](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L79)

Adds a shape behind existing foreground content while keeping an initial page background underneath it.

Parameters

**shape OfficeIMO.Drawing.OfficeShape required**

**x double required**

**y double required**

Returns

`OfficeDrawing`

AddStyledText 2 overloads

`public OfficeDrawing AddStyledText(string text, double x, double y, double width, double height, OfficeFontInfo? font, OfficeColor? color, OfficeTextAlignment alignment, double? lineHeight, OfficeTextVerticalAlignment verticalAlignment, double rotationDegrees, double? rotationCenterX, double? rotationCenterY, bool wrapText, bool shrinkToFit, bool stackedText, bool flipHorizontal, bool flipVertical, OfficeTextPadding? padding, OfficeTextParagraphIndent? paragraphIndent, OfficeTextDecorationStyle underlineStyle, OfficeTextDecorationStyle strikethroughStyle, OfficeTextBaseline baseline)` [#](#member-45ce9f894ba6740a904f8ecc)

[OfficeDrawing.cs:175](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L175)

Adds text with typed decoration and baseline styling inside a local drawing rectangle.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? required**

**color OfficeIMO.OfficeColor? required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment required**

**lineHeight double? required**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment required**

**rotationDegrees double required**

**rotationCenterX double? required**

**rotationCenterY double? required**

**wrapText bool required**

**shrinkToFit bool required**

**stackedText bool required**

**flipHorizontal bool required**

**flipVertical bool required**

**padding OfficeIMO.Drawing.OfficeTextPadding? required**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? required**

**underlineStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**strikethroughStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**baseline OfficeIMO.Drawing.OfficeTextBaseline required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddStyledText(string text, double x, double y, double width, double height, OfficeFontInfo? font, OfficeColor? color, OfficeTextAlignment alignment, double? lineHeight, OfficeTextVerticalAlignment verticalAlignment, double rotationDegrees, double? rotationCenterX, double? rotationCenterY, bool wrapText, bool shrinkToFit, bool stackedText, bool flipHorizontal, bool flipVertical, OfficeTextPadding? padding, OfficeTextParagraphIndent? paragraphIndent, OfficeTextDecorationStyle underlineStyle, OfficeTextDecorationStyle strikethroughStyle, OfficeTextBaseline baseline, int baselineLevel)` [#](#member-260630137abaeb728a918d33)

[OfficeDrawing.cs:203](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L203)

Adds text with typed decoration and a cumulative script nesting level.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? required**

**color OfficeIMO.OfficeColor? required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment required**

**lineHeight double? required**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment required**

**rotationDegrees double required**

**rotationCenterX double? required**

**rotationCenterY double? required**

**wrapText bool required**

**shrinkToFit bool required**

**stackedText bool required**

**flipHorizontal bool required**

**flipVertical bool required**

**padding OfficeIMO.Drawing.OfficeTextPadding? required**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? required**

**underlineStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**strikethroughStyle OfficeIMO.Drawing.OfficeTextDecorationStyle required**

**baseline OfficeIMO.Drawing.OfficeTextBaseline required**

**baselineLevel int required**

Returns

`OfficeDrawing`

AddText 2 overloads

`public OfficeDrawing AddText(string text, double x, double y, double width, double height, OfficeFontInfo? font, OfficeColor? color, OfficeTextAlignment alignment, double? lineHeight)` [#](#method-addtext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor-officeimo-drawing-officetextalignment-nullable-system-double)

[OfficeDrawing.cs:104](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L104)

Adds unrotated text using the original public text-box contract.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? required**

**color OfficeIMO.OfficeColor? required**

**alignment OfficeIMO.Drawing.OfficeTextAlignment required**

**lineHeight double? required**

Returns

`OfficeDrawing`

`public OfficeDrawing AddText(string text, double x, double y, double width, double height, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, OfficeTextVerticalAlignment verticalAlignment = Top, double rotationDegrees = 0, double? rotationCenterX = null, double? rotationCenterY = null, bool wrapText = false, bool shrinkToFit = false, bool stackedText = false, bool flipHorizontal = false, bool flipVertical = false, OfficeTextPadding? padding = null, OfficeTextParagraphIndent? paragraphIndent = null)` [#](#member-fd87696b0205f0b152236a4d)

[OfficeDrawing.cs:128](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L128)

Adds text inside a local drawing rectangle and returns this drawing.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

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

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**rotationDegrees double = 0 optional**

**rotationCenterX double? = null optional**

**rotationCenterY double? = null optional**

**wrapText bool = false optional**

**shrinkToFit bool = false optional**

**stackedText bool = false optional**

**flipHorizontal bool = false optional**

**flipVertical bool = false optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? = null optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddTextBehindContent(string text, double x, double y, double width, double height, OfficeFontInfo? font = null, OfficeColor? color = null, OfficeTextAlignment alignment = Left, double? lineHeight = null, OfficeTextVerticalAlignment verticalAlignment = Top, double rotationDegrees = 0, double? rotationCenterX = null, double? rotationCenterY = null, bool wrapText = false, bool shrinkToFit = false, bool stackedText = false, bool flipHorizontal = false, bool flipVertical = false, OfficeTextPadding? padding = null, OfficeTextParagraphIndent? paragraphIndent = null)` [#](#member-6a02bcd20f21d48414ce8100)

[OfficeDrawing.cs:336](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L336)

Adds text behind existing foreground content while keeping an initial page background underneath it.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

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

**alignment OfficeIMO.Drawing.OfficeTextAlignment = Left optional**

**lineHeight double? = null optional**

**verticalAlignment OfficeIMO.Drawing.OfficeTextVerticalAlignment = Top optional**

**rotationDegrees double = 0 optional**

**rotationCenterX double? = null optional**

**rotationCenterY double? = null optional**

**wrapText bool = false optional**

**shrinkToFit bool = false optional**

**stackedText bool = false optional**

**flipHorizontal bool = false optional**

**flipVertical bool = false optional**

**padding OfficeIMO.Drawing.OfficeTextPadding? = null optional**

**paragraphIndent OfficeIMO.Drawing.OfficeTextParagraphIndent? = null optional**

Returns

`OfficeDrawing`

AddTilingPattern 2 overloads

`public OfficeDrawing AddTilingPattern(OfficeDrawing tile, OfficeImagePlacement area, double horizontalStep, double verticalStep, OfficeTransform? transform = null, double originX = 0, double originY = 0, int maximumTileCount = 16384, double opacity = 1)` [#](#method-addtilingpattern-officeimo-drawing-officedrawing-officeimo-drawing-officeimageplacement-double-double-nullable-officeimo-drawing-officetransform-double-double-int32-double)

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

Adds a clipped, transform-aware vector tiling pattern.

Parameters

**tile OfficeIMO.Drawing.OfficeDrawing required**

**area OfficeIMO.Drawing.OfficeImagePlacement required**

**horizontalStep double required**

**verticalStep double required**

**transform OfficeIMO.Drawing.OfficeTransform? = null optional**

**originX double = 0 optional**

**originY double = 0 optional**

**maximumTileCount int = 16384 optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddTilingPattern(OfficeDrawing tile, OfficeImagePlacement area, double horizontalStep, double verticalStep, bool repeatX, bool repeatY, OfficeTransform? transform = null, double originX = 0, double originY = 0, int maximumTileCount = 16384, double opacity = 1)` [#](#method-addtilingpattern-officeimo-drawing-officedrawing-officeimo-drawing-officeimageplacement-double-double-boolean-boolean-nullable-officeimo-drawing-officetransform-double-double-int32-double)

[OfficeDrawing.TilingPatterns.cs:30](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.TilingPatterns.cs#L30)

Adds a clipped, transform-aware vector tiling pattern with independent axis repetition.

Parameters

**tile OfficeIMO.Drawing.OfficeDrawing required**

**area OfficeIMO.Drawing.OfficeImagePlacement required**

**horizontalStep double required**

**verticalStep double required**

**repeatX bool required**

**repeatY bool required**

**transform OfficeIMO.Drawing.OfficeTransform? = null optional**

**originX double = 0 optional**

**originY double = 0 optional**

**maximumTileCount int = 16384 optional**

**opacity double = 1 optional**

Returns

`OfficeDrawing`

`public OfficeDrawing AddVerticalText(string text, double x, double y, double width, double height, OfficeFontInfo? font = null, OfficeColor? color = null)` [#](#method-addverticaltext-string-double-double-double-double-nullable-officeimo-drawing-officefontinfo-nullable-officeimo-officecolor)

[OfficeDrawing.cs:133](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L133)

Adds top-to-bottom text whose glyph substitutions and advances come from the selected shaping provider.

Parameters

**text string required**

**x double required**

**y double required**

**width double required**

**height double required**

**font OfficeIMO.Drawing.OfficeFontInfo? = null optional**

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

Returns

`OfficeDrawing`

`public OfficeDrawing Clone()` [#](#method-clone)

[OfficeDrawing.cs:1053](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L1053)

Creates a detached copy of this drawing and all positioned elements.

Returns

`OfficeDrawing`

`public OfficeImageExportResult ToImage(OfficeImageExportFormat format, OfficeImageExportOptions? options = null, CancellationToken cancellationToken = default)` [#](#method-toimage-officeimo-drawing-officeimageexportformat-officeimo-drawing-officeimageexportoptions-threading-cancellationtoken)

[OfficeDrawing.ExportImage.cs:6](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.ExportImage.cs#L6)

Exports a detached drawing through the shared density, encoding, font, diagnostic and safety contracts. Options define the drawing's logical units per inch.

Parameters

**format OfficeIMO.Drawing.OfficeImageExportFormat required**

**options OfficeIMO.Drawing.OfficeImageExportOptions? = null optional**

**cancellationToken System.Threading.CancellationToken = default optional**

Returns

`OfficeImageExportResult`

## 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?`

## Properties

`public double Width { get; }` [#](#property-width)

[OfficeDrawing.cs:22](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L22)

Drawing width in the caller's layout unit.

`public double Height { get; }` [#](#property-height)

[OfficeDrawing.cs:25](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L25)

Drawing height in the caller's layout unit.

`public IReadOnlyList<OfficeDrawingShape> Shapes { get; }` [#](#property-shapes)

[OfficeDrawing.cs:28](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L28)

Positioned shapes in paint order.

`public IReadOnlyList<OfficeDrawingImage> Images { get; }` [#](#property-images)

[OfficeDrawing.cs:31](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L31)

Positioned images in paint order.

`public IReadOnlyList<OfficeDrawingImagePattern> ImagePatterns { get; }` [#](#property-imagepatterns)

[OfficeDrawing.cs:34](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L34)

Clipped image patterns in paint order.

`public IReadOnlyList<OfficeDrawingElement> Elements { get; }` [#](#property-elements)

[OfficeDrawing.cs:37](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.cs#L37)

Positioned drawing elements in paint order.

`public OfficeFontFaceCollection Fonts { get; private set; }` [#](#property-fonts)

[OfficeDrawing.Fonts.cs:12](https://github.com/EvotecIT/OfficeIMO/blob/ba882f6b0d07acddd884b5e7d3086b0cfff0a05a/OfficeIMO.Core/OfficeDrawing.Fonts.cs#L12)

Scoped TrueType faces embedded or rasterized with this drawing.

<!-- PowerForge markdown artifact sha256:88E1155009FDB4B6337A617723B8769A82740B4F891685726ACC7E2FE14B87BB -->
