Encoder Class

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

An Encoder object encapsulates a globally unique identifier (GUID) that identifies the category of an image encoder parameter.

public ref class Encoder sealed

public sealed class Encoder

type Encoder = class

Public NotInheritable Class Encoder

Inheritance

Object

Encoder

Remarks

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.

When you pass a parameter to an image encoder, the parameter is encapsulated in an EncoderParameter object. One of the fields of the EncoderParameter object is a GUID that specifies the category of the parameter. Use the static fields of the Encoder class to retrieve an Encoder that contains parameters of the desired category.

The image encoders that are built into GDI+ receive parameters that belong to several categories. The following table lists all the categories and the GUID associated with each category.

Category	GUID
ChrominanceTable	f2e455dc-09b3-4316-8260-676ada32481c
ColorDepth	66087055-ad66-4c7c-9a18-38a2310b8337
Compression	e09d739d-ccd4-44ee-8eba-3fbf8be4fc58
LuminanceTable	edb33bce-0266-4a77-b904-27216099e717
Quality	1d5be4b5-fa4a-452d-9cdd-5db35105e7eb
RenderMethod	6d42c53a-229a-4825-8bb7-5c99e2b9a8b8
SaveFlag	292266fc-ac40-47bf-8cfc-a85b89a655de
ScanMethod	3a4e2661-3109-4e56-8536-42c156e7dcfa
Transformation	8d0eb2d1-a58e-4ea8-aa14-108074b7b6f9
Version	24d18c76-814a-41a4-bf53-1c219cccf797

Constructors

Encoder(Guid)

Initializes a new instance of the Encoder class from the specified globally unique identifier (GUID). The GUID specifies an image encoder parameter category.

Fields

ChrominanceTable	An Encoder object that is initialized with the globally unique identifier for the chrominance table parameter category.
ColorDepth	An Encoder object that is initialized with the globally unique identifier for the color depth parameter category.
ColorSpace	Represents an encoder that's initialized with the globally unique identifier for the color space category.
Compression	An Encoder object that is initialized with the globally unique identifier for the compression parameter category.
ImageItems	Represents an encoder that's initialized with the globally unique identifier for the image items category.
LuminanceTable	Represents an Encoder object that is initialized with the globally unique identifier for the luminance table parameter category.
Quality	Gets an Encoder object that is initialized with the globally unique identifier for the quality parameter category.
RenderMethod	Represents an Encoder object that is initialized with the globally unique identifier for the render method parameter category.
SaveAsCmyk	Represents an encoder that's initialized with the globally unique identifier for the save as CMYK category.
SaveFlag	Represents an Encoder object that is initialized with the globally unique identifier for the save flag parameter category.
ScanMethod	Represents an Encoder object that is initialized with the globally unique identifier for the scan method parameter category.
Transformation	Represents an Encoder object that is initialized with the globally unique identifier for the transformation parameter category.
Version	Represents an Encoder object that is initialized with the globally unique identifier for the version parameter category.

Properties

Guid	Gets a globally unique identifier (GUID) that identifies an image encoder parameter category.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

See also

• Using Image Encoders and Decoders in Managed GDI+