Class ImageStamper
Stamps images onto PDF pages for logos, signatures, watermarks, and visual elements. Supports various image formats and flexible positioning/sizing options.
// Company logo:
var logo = new ImageStamper("logo.png") {
Width = new Length(100, MeasurementUnit.Pixel),
Height = new Length(50, MeasurementUnit.Pixel),
HorizontalAlignment = HorizontalAlignment.Right,
VerticalAlignment = VerticalAlignment.Top
};
pdf.ApplyStamp(logo);
// Signature on last page:
var signature = new ImageStamper("signature.jpg") {
HorizontalOffset = new Length(400, MeasurementUnit.Pixel),
VerticalOffset = new Length(100, MeasurementUnit.Pixel)
};
pdf.ApplyStamp(signature, pdf.PageCount - 1);
// Semi-transparent watermark:
var watermark = new ImageStamper("watermark.png") {
Opacity = 30,
Layer = StampLayer.BehindExistingPDFContent,
HorizontalAlignment = HorizontalAlignment.Center,
VerticalAlignment = VerticalAlignment.Middle
};
pdf.ApplyStamp(watermark);
// From bitmap (requires disposal):
using (var stamper = new ImageStamper(myBitmap)) {
pdf.ApplyStamp(stamper);
}Supports PNG, JPG, GIF, BMP, TIFF, WEBP formats
Always dispose when using AnyBitmap constructor
See: https://ironpdf.com/how-to/stamping/#image-stamper
Implements
Inherited Members
Namespace: IronPdf.Editing
Assembly: IronPdf.dll
Syntax
public class ImageStamper : Stamper, IDisposableConstructors
ImageStamper(AnyBitmap)
Initializes a new instance of the ImageStamper class.
Declaration
public ImageStamper(AnyBitmap bitmap)Parameters
| Type | Name | Description |
|---|---|---|
| IronSoftware.Drawing.AnyBitmap | bitmap | The image to be stamped by this stamper |
Remarks
Creates a temporary file that will be automatically deleted when disposed.
For proper cleanup, always use this constructor within a 'using' statement or call Dispose() when done.
ImageStamper(String)
Initializes a new instance of the ImageStamper class.
Declaration
public ImageStamper(string imagePath)Parameters
| Type | Name | Description |
|---|---|---|
| System.String | imagePath | The path of the image to be stamped by this stamper |
ImageStamper(Uri)
Initializes a new instance of the ImageStamper class.
Declaration
public ImageStamper(Uri imageUri)Parameters
| Type | Name | Description |
|---|---|---|
| System.Uri | imageUri | The uri of the image to be stamped by this stamper |
Properties
ImageUri
The path of the image to be stamped by this stamper
Declaration
public Uri ImageUri { get; set; }Property Value
| Type | Description |
|---|---|
| System.Uri |
Methods
CleanupTempFile()
Manually clean up the temporary file created from AnyBitmap.
Declaration
public void CleanupTempFile()Dispose()
Releases all resources used by the ImageStamper.
Declaration
public void Dispose()Dispose(Boolean)
Releases the unmanaged resources used by the ImageStamper and optionally releases the managed resources.
Declaration
protected virtual void Dispose(bool disposing)Parameters
| Type | Name | Description |
|---|---|---|
| System.Boolean | disposing | true to release both managed and unmanaged resources; false to release only unmanaged resources. |
Finalize()
Finalizer to ensure unmanaged resources are cleaned up even if Dispose is not called explicitly.
Declaration
protected override void Finalize()