Open XML: A Comprehensive Guide to Setting Picture Size
Introduction
Greetings, readers! Welcome to our in-depth guide on how to master picture size adjustment in Open XML documents. Whether you’re an experienced developer or just starting out, this article will provide you with all the knowledge you need to seamlessly resize images in your Open XML documents.
Understanding Picture Size in Open XML
Open XML utilizes the DrawingML namespace to store and manipulate images. Within the DrawingML hierarchy, the <pic> element represents the picture itself. To specify the size of the picture, you must modify the width and height attributes of the <pic> element. These attributes specify the width and height of the picture in points (pt), where 1 pt equals approximately 1/72 inch.
Setting Picture Size Programmatically
You can programmatically set the picture size in Open XML using various methods. Here are two popular approaches:
Using the Open XML SDK
The Open XML SDK provides a comprehensive set of classes for working with Open XML documents. To set picture size using the SDK, follow these steps:
- Open the document and locate the
<pic>element representing the picture you want to resize. - Access the
WidthandHeightproperties of the<pic>element. - Set the width and height values in points.
Using Open XML Productivity Tool
If you’re comfortable working with XML, you can directly modify the Open XML markup to set picture size. Open the document in an XML editor and locate the <pic> element. Within the <pic> element, modify the width and height attributes with the desired values.
Table: Common Picture Sizes
| Picture Size (pt) | Pixel Size (px) | Resolution (dpi) | |||
|---|---|---|---|---|---|
| 150 x 150 | 150 x 150 | 72 | |||
| 300 x 300 | 300 x 300 | 72 | |||
| 600 x 600 | 600 x 600 | 72 | |||
| 1200 x 1200 | 1200 x 1200 | 72 | |||
| 2400 x 2400 | 2400 x 2400 | 72 |
Maintaining Aspect Ratio
When resizing pictures, it’s often important to maintain the original aspect ratio to avoid distortion. To do this, you can use the scale attribute of the <pic> element. By setting scale to 1, the picture is scaled proportionally, preserving its aspect ratio.
Conclusion
Congratulations, readers! You now have a thorough understanding of how to set picture size in Open XML documents. Whether you choose to use the Open XML SDK or modify the XML markup directly, the techniques outlined in this article will empower you to precisely control the appearance of images in your documents.
Explore other articles on our website to further enhance your Open XML knowledge. Happy coding!
FAQ about Open XML – How to set picture size
How do I set the height of a picture?
The height of a picture can be set using the height attribute of the <pic:blipFill> element. The value of the height attribute is specified in English Metric Units (EMU), where 1 EMU is equal to 0.001 inch. For example, to set the height of a picture to 1 inch, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
</pic:blipFill>
How do I set the width of a picture?
The width of a picture can be set using the width attribute of the <pic:blipFill> element. The value of the width attribute is specified in English Metric Units (EMU), where 1 EMU is equal to 0.001 inch. For example, to set the width of a picture to 1 inch, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
</pic:blipFill>
How do I set the aspect ratio of a picture?
The aspect ratio of a picture can be set using the lockAspectRatio attribute of the <pic:stretch> element. When the lockAspectRatio attribute is set to true, the aspect ratio of the picture will be maintained when the picture is resized. For example, to set the aspect ratio of a picture to 16:9, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
<a:lockAspectRatio val="true"/>
</pic:blipFill>
How do I crop a picture?
A picture can be cropped using the cropLeft, cropTop, cropRight, and cropBottom attributes of the <pic:crop> element. The values of these attributes are specified in English Metric Units (EMU), where 1 EMU is equal to 0.001 inch. For example, to crop a picture from the left by 1 inch, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
<pic:crop>
<pic:cropLeft val="100000"/>
<pic:cropTop val="0"/>
<pic:cropRight val="0"/>
<pic:cropBottom val="0"/>
</pic:crop>
</pic:blipFill>
How do I rotate a picture?
A picture can be rotated using the rotation attribute of the <pic:blipFill> element. The value of the rotation attribute is specified in degrees. For example, to rotate a picture by 90 degrees, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
<a:rotation val="900000"/>
</pic:blipFill>
How do I flip a picture?
A picture can be flipped using the flipH and flipV attributes of the <pic:blipFill> element. The value of the flipH attribute is set to true to flip the picture horizontally, and the value of the flipV attribute is set to true to flip the picture vertically. For example, to flip a picture horizontally, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
<a:flipH val="true"/>
</pic:blipFill>
How do I set the transparency of a picture?
The transparency of a picture can be set using the alpha attribute of the <pic:blipFill> element. The value of the alpha attribute is specified as a percentage, where 0% is completely transparent and 100% is completely opaque. For example, to set the transparency of a picture to 50%, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
<a:alpha val="50000"/>
</pic:blipFill>
How do I add a border to a picture?
A border can be added to a picture using the <pic:border> element. The <pic:border> element has several attributes that can be used to customize the appearance of the border, including the color, width, and dashStyle attributes. For example, to add a 1-point black border to a picture, you would use the following code:
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
<a:stretchProp>
<a:fillRect/>
<a:stretchProp val="1000000"/>
</a:stretchProp>
</a:stretch>
</pic:blipFill>
<pic:border>
<pic:color rgb="FF000000"/>
<pic:width val="12700"/>
<pic:dashStyle val="solid"/>
</pic:border>
How do I group pictures?
Pictures can be grouped together using the <pic:grpSp> element. The <pic:grpSp> element can contain multiple <pic:pic> elements, and the pictures in the group can be arranged using the x and y attributes of the <pic:pic> elements. For example, to group two pictures together and arrange them side by side, you would use the following code:
<pic:grpSp>
<pic:cNvPr id="1" name="Group 1" descr="Group of two pictures"/>
<pic:cNvGrpSp>
<a:xfrm>
<a:off x="0" y="0"/>
<a:ext cx="0" cy="0"/>
</a:xfrm>
</pic:cNvGrpSp>
<pic:pic>
<pic:nvPicPr>
<pic:cNvPr id="2" name="Picture 1" descr=""/>
<pic:cNvPicPr/>
</pic:nvPicPr>
<pic:blipFill>
<a:blip r:embed="rId2"/>
<a:stretch>
<a:fillRect/>
</a:stretch>
</pic:blipFill>
<pic:spPr>
<a:xfrm>
<a:off x="0" y="0"/>
<a:ext cx="0" cy="0"/>
</a:xfrm>
</pic:spPr>
</pic>
<pic:pic>
<pic:
