EncoderParameters Constructors

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Initializes a new instance of the EncoderParameters class that can contain the specified number of EncoderParameter objects.

Overloads

EncoderParameters()	Initializes a new instance of the EncoderParameters class that can contain one EncoderParameter object.
EncoderParameters(Int32)	Initializes a new instance of the EncoderParameters class that can contain the specified number of EncoderParameter objects.

EncoderParameters()

Initializes a new instance of the EncoderParameters class that can contain one EncoderParameter object.

public EncoderParameters ();

Examples

The following code example demonstrates how to create and use a EncoderParameters object. To run this example, paste the code into a Windows Form and call the VaryQualityLevel method from the form's constructor. This example requires an image file named TestPhoto.jpg located at c:\.

private void VaryQualityLevel()
{
    // Get a bitmap.
    Bitmap bmp1 = new Bitmap(@"c:\TestPhoto.jpg");
    ImageCodecInfo jpgEncoder = GetEncoder(ImageFormat.Jpeg);

    // Create an Encoder object based on the GUID
    // for the Quality parameter category.
    System.Drawing.Imaging.Encoder myEncoder =
        System.Drawing.Imaging.Encoder.Quality;

    // Create an EncoderParameters object.
    // An EncoderParameters object has an array of EncoderParameter
    // objects. In this case, there is only one
    // EncoderParameter object in the array.
    EncoderParameters myEncoderParameters = new EncoderParameters(1);

    EncoderParameter myEncoderParameter = new EncoderParameter(myEncoder, 50L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityFifty.jpg", jpgEncoder, myEncoderParameters);

    myEncoderParameter = new EncoderParameter(myEncoder, 100L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityHundred.jpg", jpgEncoder, myEncoderParameters);

    // Save the bitmap as a JPG file with zero quality level compression.
    myEncoderParameter = new EncoderParameter(myEncoder, 0L);
    myEncoderParameters.Param[0] = myEncoderParameter;
    bmp1.Save(@"c:\TestPhotoQualityZero.jpg", jpgEncoder, myEncoderParameters);
}

private ImageCodecInfo GetEncoder(ImageFormat format)
{
    ImageCodecInfo[] codecs = ImageCodecInfo.GetImageEncoders();

    foreach (ImageCodecInfo codec in codecs)
    {
        if (codec.FormatID == format.Guid)
        {
            return codec;
        }
    }
    
    return null;
}

Remarks

Some of the Save and SaveAdd methods receive an EncoderParameters object as an argument. The GetEncoderParameterList method returns an EncoderParameters object.

EncoderParameters(Int32)

Initializes a new instance of the EncoderParameters class that can contain the specified number of EncoderParameter objects.

public EncoderParameters (int count);

Parameters

count

Int32

An integer that specifies the number of EncoderParameter objects that the EncoderParameters object can contain.