• Overview
• Pictures
  • Overview
  • Image Properties
    • Image Data
    • Tile or Stretch Image to Fill
    • Effects
  • Non-Visual Properties
  • Shape Properties
• Shapes
  • Overview
  • Non-Visual Properties
  • Visual Properties
    • Size of Bounding Box
    • Location of Bounding Box
    • Geometry
      • Preset
      • Custom
    • Shape Fill
      • Solid Fill
      • Picture Fill
      • Gradient Fill
      • Pattern Fill
      • Group Fill
    • Effects
    • Outline Style
    • 2D Transforms
    • 3-D
      • Shape Properties
      • Scene Properties
  • Styles
  • Text
    • Text Body Properties
      • Positioning and Insets
      • Fit, Wrap, Warp and 3D
      • Columns, Vertical Text and Rotation
    • Paragraphs
      • Paragraph Properties
        • Bullets and Numbering
        • Spacing, Indent and Margins
        • Alignment, Tabs, Other
      • Run Properties
    • List Properties
• Connectors
  • Non-Visual Properties
• Text
• Charts
• Diagrams
• Tables
  • Defining Structure
  • Rows, Cells, Cell Content
  • Cell Properties
    • Alignment, Margins, Direction
    • Borders and Fill
  • Table Styles and Properties
• Placement within Docs
  • Overview
  • Inline Objects
  • Floating Objects
    • Positioning
    • Text Wrapping
• Placement within Spreadsheets
  • Overview
  • Absolute Anchoring
  • One Cell Anchoring
  • Two Cell Anchoring
• Placement within Presentations

DrawingML Pictures

Displaying a Portion of the Image (Cropping)

The <a:srcRect> element within the <pic:blipFill> element specifies the portion of the blip or image that is used for the fill. If no attributes are specified, this indicates that the image has not been cropped. Otherwise, the b (bottom), l (left), r (right), and t (top) attributes specify the cropping for the rectangle. Each edge of the image is defined by a percentage offset from the edge of the bounding box. A positive percentage specifies an inset and a negative percentage specifies an outset. So, for example, a left offset of 25% specifies that the left edge of the image is located to the right of the bounding box's left edge by 25% of the bounding box's width.

Stretching the Image

An image can be stretched to fill the target rectangle with a <a:stretch> element within the <pic:blipFill> element. The <a:stretch> contains a <a:fillRect> element that specifies a fill rectangle. Each edge of the fill rectangle is defined by a perentage offset from the corresponding edge of the picture's bounding box. A positive percentage specifies an inset and a negative percentage specifies an outset.

The <a:fillRect> element has the same attributes as the <a:srcRect> element above.

Below are examples without stretching, with stretching but without offset or outset, and stretching with inset. Stretching an image is in relation to the image's bounding box. In the examples, the bounding box (cx="3438400" cy="2828800") is larger than the image (cx="2438400" cy="1828800"). The first sample has no stretching.

The second has stretching, with no offset or inset.

The third has stretching, with a 25% inset in the left.

Tiling the Image

Tiling of an image to fill the bounding box is specified with the <a:tile> element within the <pic:blipFill> element. The <a:tile> element defines a tile or rectangle within the bounding box, and the rectangle is tiled across the bounding box to fill the entire area.

The <a:tile> element has the following attributes.

Below is an example of tiling. The first tile is in the bottom right corner. The image is not flipped in either direction, but the image is scaled to 20% horizontally and 50% vertically.