ImageSize
Contents
[
Hide
]ImageSize class
Contains information about image size and resolution.
To learn more, visit the Working with Images documentation article.
public class ImageSize
Constructors
Name | Description |
---|---|
ImageSize(int, int) | Initializes width and height to the given values in pixels. Initializes resolution to 96 dpi. |
ImageSize(int, int, double, double) | Initializes width, height and resolution to the given values. |
Properties
Name | Description |
---|---|
HeightPixels { get; } | Gets the height of the image in pixels. |
HeightPoints { get; } | Gets the height of the image in points. 1 point is 1/72 inch. |
HorizontalResolution { get; } | Gets the horizontal resolution in DPI. |
VerticalResolution { get; } | Gets the vertical resolution in DPI. |
WidthPixels { get; } | Gets the width of the image in pixels. |
WidthPoints { get; } | Gets the width of the image in points. 1 point is 1/72 inch. |
Examples
Shows how to resize a shape with an image.
// When we insert an image using the "InsertImage" method, the builder scales the shape that displays the image so that,
// when we view the document using 100% zoom in Microsoft Word, the shape displays the image in its actual size.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertImage(ImageDir + "Logo.jpg");
// A 400x400 image will create an ImageData object with an image size of 300x300pt.
ImageSize imageSize = shape.ImageData.ImageSize;
Assert.AreEqual(300.0d, imageSize.WidthPoints);
Assert.AreEqual(300.0d, imageSize.HeightPoints);
// If a shape's dimensions match the image data's dimensions,
// then the shape is displaying the image in its original size.
Assert.AreEqual(300.0d, shape.Width);
Assert.AreEqual(300.0d, shape.Height);
// Reduce the overall size of the shape by 50%.
shape.Width *= 0.5;
// Scaling factors apply to both the width and the height at the same time to preserve the shape's proportions.
Assert.AreEqual(150.0d, shape.Width);
Assert.AreEqual(150.0d, shape.Height);
// When we resize the shape, the size of the image data remains the same.
Assert.AreEqual(300.0d, imageSize.WidthPoints);
Assert.AreEqual(300.0d, imageSize.HeightPoints);
// We can reference the image data dimensions to apply a scaling based on the size of the image.
shape.Width = imageSize.WidthPoints * 1.1;
Assert.AreEqual(330.0d, shape.Width);
Assert.AreEqual(330.0d, shape.Height);
doc.Save(ArtifactsDir + "Image.ScaleImage.docx");
See Also
- property ImageSize
- namespace Aspose.Words.Drawing
- assembly Aspose.Words