Images

DynamicPDF™ Generator for .NET has support for 9 image types and transparent images. It can read images from a file, System.IO.Stream object, or System.Drawing.Bitmap object. This section explains how to use images in a document.

Images can be added to a page using the Image Page Element or the Background Image Page Element:

[Visual Basic]
' Adds a background image and image to a page.
MyPage1.Elements.Add( New BackgroundImage( "C:\MyBackground.gif" ) )
MyPage1.Elements.Add( New Image( "C:\MyLogo.gif", 0, 0 ) )

[C#]
// Adds a background image and image to a page.
page1.Elements.Add( new BackgroundImage( @"C:\MyBackground.gif" ) );
page1.Elements.Add( new Image( @"C:\MyLogo.gif", 0, 0 ) );

NOTE: The examples in this topic show how to add an image when it is not going to be reused multiple times. For details on how to most efficiently handle images that will be used multiple times, see the Image Reuse topic.

Adding Images From A File

Images can be created from a file as follows:

[Visual Basic]
' Adds an image to a page.
MyPage1.Elements.Add( New Image( "C:\MyLogo.gif", 0, 0 ) )

[C#]
// Adds an image to a page.
page1.Elements.Add( new Image( @"C:\MyLogo.gif", 0, 0 ) );

Adding Images From A System.IO.Stream Object

Images can be created from a System.IO.Stream object as follows:

[Visual Basic]
' Adds an image to a page.
MyPage1.Elements.Add( New Image( ImageData.GetImage( MyStream ), 0, 0 ) )

[C#]
// Adds an image to a page.
page1.Elements.Add( new Image( ImageData.GetImage( stream ), 0, 0 ) );

Adding Images From A System.Drawing.Bitmap Object

Images can be created from a System.Drawing.Bitmap object as follows:

[Visual Basic]
' Adds an image to a page.
MyPage1.Elements.Add( New Image( MyBitmap, 0, 0 ) )

[C#]
// Adds an image to a page.
page1.Elements.Add( new Image( bitmap, 0, 0 ) );

Adding Images From A Byte Array

Images can be created from a database field or byte array as follows:

[Visual Basic]
' Adds an image from a byte array to a page.
MyPage1.Elements.Add( New Image( ImageData.GetImage( MyByteArray ), 0, 0 ) )

[C#]
// Adds an image from a byte array to a page.
page1.Elements.Add( new Image( ImageData.GetImage( byteArray ), 0, 0 ) );

Adding Images From A Database Field

Images can be created from a database field or byte array as follows:

[Visual Basic]
' The "MyDataReader" variable is a DataReader object.
MyPage1.Elements.Add( New Image( ImageData.GetImage( CType( MyDataReader("ImageField"), Byte() ) ), 0, 0 ) )

[C#]
// The "dataReader" variable is a DataReader object.
page1.Elements.Add( new Image( ImageData.GetImage( (byte[])dataReader["ImageField"] ), 0, 0 ) );

In This Section

Image Formats

Lists and Explains the different image formats that are supported.

Image Resolution

Explains how to set and adjust the resolution and size of images.

Tiff Images

Explains the different options for Tiff images that are supported.

Image Reuse

Explains how to most efficiently use reuse images.

See Also

BackgroundImage Class | Image Class | Image Reuse | ceTe.DynamicPDF.Imaging Namespace | Programming With Generator for .NET | DynamicPDF.Generator Assembly