Edit

Share via


EncoderParameters Constructors

Definition

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()

Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs

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.

Applies to

.NET 10 (package-provided) and other versions
Product Versions
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

EncoderParameters(Int32)

Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs
Source:
EncoderParameters.cs

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.

Applies to

.NET 10 (package-provided) and other versions
Product Versions
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10