ImageCodecInfo Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
The ImageCodecInfo class provides the necessary storage members and methods to retrieve all pertinent information about the installed image encoders and decoders (called codecs). Not inheritable.
public ref class ImageCodecInfo sealedpublic sealed class ImageCodecInfotype ImageCodecInfo = classPublic NotInheritable Class ImageCodecInfo- Inheritance
-
ImageCodecInfo
Remarks
GDI+ uses image encoders to convert the images stored in Bitmap objects to various file formats. Image encoders are built into GDI+ for the BMP, JPEG, GIF, TIFF, and PNG formats. An encoder is invoked when you call the Save or SaveAdd method of a Image object.
Note
In .NET 6 and later versions, the System.Drawing.Common package, which includes this type, is only supported on Windows operating systems. Use of this type in cross-platform apps causes compile-time warnings and run-time exceptions. For more information, see System.Drawing.Common only supported on Windows.
Properties
| Name | Description |
|---|---|
| Clsid |
Gets or sets a Guid structure that contains a GUID that identifies a specific codec. |
| CodecName |
Gets or sets a string that contains the name of the codec. |
| DllName |
Gets or sets string that contains the path name of the DLL that holds the codec. If the codec is not in a DLL, this pointer is |
| FilenameExtension |
Gets or sets string that contains the file name extension(s) used in the codec. The extensions are separated by semicolons. |
| Flags |
Gets or sets 32-bit value used to store additional information about the codec. This property returns a combination of flags from the ImageCodecFlags enumeration. |
| FormatDescription |
Gets or sets a string that describes the codec's file format. |
| FormatID |
Gets or sets a Guid structure that contains a GUID that identifies the codec's format. |
| MimeType |
Gets or sets a string that contains the codec's Multipurpose Internet Mail Extensions (MIME) type. |
| SignatureMasks |
Gets or sets a two dimensional array of bytes that can be used as a filter. |
| SignaturePatterns |
Gets or sets a two dimensional array of bytes that represents the signature of the codec. |
| Version |
Gets or sets the version number of the codec. |
Methods
| Name | Description |
|---|---|
| GetImageDecoders() |
Returns an array of ImageCodecInfo objects that contain information about the image decoders built into GDI+. |
| GetImageEncoders() |
Returns an array of ImageCodecInfo objects that contain information about the image encoders built into GDI+. |
