The DrawingML Main namespace of the Office Open XML defines all of the base constructs for all kinds of DrawingML objects (charts, diagrams, shapes, pictures, and so on). Within a WordprocessingML document, it is possible to include graphical DrawingML objects:

• Pictures
• Locked Canvases
• Diagrams
• Charts

 

The following objects are supported by ImageGear:

Object	Supported Types	Comment
Picture	Embedded picture	ImageGear supports only embedded into WordprocessingML package images – no any external links.
Line	Following line types are supported: Line Arrow Double Arrow Elbow Connector Elbow Arrow Connector Elbow Double Arrow Connector
Basic Shape	Following basic Shapes are supported: Text Box Rectangle Parallelogram Trapezoid Diamond Rounded Rectangle Octagon Isosceles Triangle Right Triangle Oval Hexagon Cross Regular Pentagon Lightning Bolt	Currently ImageGear doesn't support curves and composite path segments for the drawing - the shape is drawn with cut corner instead of the folded corner.
Block Arrow	Following Block Arrows are supported: Right Arrow Left Arrow Down Arrow Up Arrow Left-Right Arrow Up-Down Arrow Quad Arrow Left-Right-Up Arrow Left-Up Arrow Bent-Up Arrow Notched Right Arrow Pentagon Chevron Right Arrow Callout Down Arrow Callout Left Arrow Callout Up Arrow Callout Left Right Arrow Callout Quad Arrow Callout	The following arrow styles are supported: Begin style: arrow, open arrow, oval arrow. End style: arrow, open arrow, oval arrow. The diamond arrow style is drawn as oval arrow style.
Flow Chart	Following Flow Charts are supported: Process Decision Data Preparation Manual Input Manual Operation Off-page connector Card Collate Extract Merge
Stars and Banners	Following Stars and Banners are supported: Explosion 1 Explosion 2 4-Point Star 5-Point Star 8-Point Star 16-Point Star 24-Point Star 32-Point Star

 

ImageGear supports Solid, Linear Gradient and Radial Gradient fills for Drawing Shapes. For Gradients, there are a few limitations that should be considered:

• For Linear Gradients - ImageGear does not support arbitrary angle of the Gradient; it will be rendered either vertically or horizontally.
• For Radial Gradients - ImageGear does not support adjustment of the Gradient according to the shape’s outline. For example, Microsoft Word adjusts the Radial Gradient to repeat the outline of the shape: e.g. for rectangular shapes it becomes rectangular, for star-like shapes it becomes star-like. ImageGear renders Radial Gradients in the traditional way – circularly for any shape.

Positioning of Drawing Objects

Within a WordprocessingML document, drawing objects can exist in two states:

• Inline - The drawing object is in line with the text, and affects the line height and layout of its line (like a character glyph of similar size).
• Floating - The drawing object is anchored within the text, but can be absolutely positioned in the document relative to the page.

ImageGear supports both states. For inline drawings there are no issues, but for floating objects there are few limitations that should be considered:

Horizontal positioning:

ImageGear supports all "relative to"/"to the right of" objects, except "Inside Margin" and "Outside Margin".

Vertical positioning:

ImageGear supports all "relative to"/"below" objects, except "Inside Margin" and "Outside Margin". Additionally, if the absolute positioning is below Paragraph or below Line, only positive values are supported for position value. Negative values will lead to incorrect layout of the page. In this case, adjust the anchor of the drawing object to avoid a negative value.

Supported Wrapping styles:

• In line with text
• Square
• Top and bottom
• Behind text
• In front of text