Document Solutions for Word
Features / Shapes / Picture Format
In This Topic
    Picture Format
    In This Topic

    DsWord allows you to enhance the look of a picture by customizing the picture formats using EmbeddedImageData and ImageData classes. ImageData class enables you to apply effects, adjust brightness, contrast, sharpness, etc., and change the color to a preset color or a custom color.

    Apply Picture Effects

    DsWord allows you to enhance your picture by adding picture effects, such as blur, grayscale, tint, duo tone, fill overlay, etc using Effects property of ImageData class.

    Refer to the following example code to add grayscale effect to the picture:

    C#
    Copy Code 
    // Initialize GcWordDocument.
GcWordDocument doc = new GcWordDocument();

// Read PNG image from a file.
var bytes = File.ReadAllBytes(@"image.png");
            
// Add PNG picture into the document.
var picture = doc.Body.AddParagraph().AddRun().AddPicture(bytes, @"image/png", 300f, 300f);

// Add grayscale to the picture.
picture.ImageData.Effects.AddGrayscale();
            
// Save the Word document.
doc.Save(@"picture-effects.docx");
    Original Grayscale Effect

    Adjust Picture Settings

    DsWord allows you to enhance your picture by adjusting the picture settings, such as brightness, contrast, temperature, saturation, and sharpness, using ImageData property of Picture class.

    Refer to the following example code to adjust the brightness and contrast of a picture:

    C#
    Copy Code 
    // Initialize GcWordDocument.
GcWordDocument doc = new GcWordDocument();

// Read PNG image from a file.
var bytes = File.ReadAllBytes(@"image.png");

// Add PNG picture into the document.
var picture = doc.Body.AddParagraph().AddRun().AddPicture(bytes, @"image/png", 300f, 300f);

// Increase the picture brightness.
picture.ImageData.Brightness = 0.5f;

// Decrease the picture contrast.
picture.ImageData.Contrast = -0.5f;

// Save the Word document.
doc.Save(@"picture-settings.docx");
    Original Brightness and Contrast Adjusted

    Change Picture Color

    DsWord allows you to enhance your picture by adjusting the picture color to a preset color or desired colors using Recolor method of ImageData class and AddColorChange method of ImageEffectList class.

    Refer to the following example code to adjust the picture color to a preset color:

    C#
    Copy Code 
    // Initialize GcWordDocument.
GcWordDocument doc = new GcWordDocument();

// Read PNG image from a file.
var bytes = File.ReadAllBytes(@"image.png");

// Add PNG picture into the document.
var picture = doc.Body.AddParagraph().AddRun().AddPicture(bytes, @"image/png", 300f, 300f);

// Recolor the picture to grayscale.
picture.ImageData.Recolor(RecolorType.Accent1Light);

// Save the Word document.
doc.Save(@"recolor-preset.docx");
    Original Preset Color: Accent1Light

    Refer to the following example code to adjust the picture color to the desired color:

    C#
    Copy Code 
    // Initialize GcWordDocument.
GcWordDocument doc = new GcWordDocument();

// Read JPEG image from a file.
var bytes = File.ReadAllBytes(@"image.png");

// Add JPEG picture into the document.
var picture = doc.Body.AddParagraph().AddRun().AddPicture(bytes, @"image/png", 300f, 300f);

// Change blue to green color in the picture.
picture.ImageData.Effects.AddColorChange(new UserColor(Color.FromArgb(15,17,19)), new UserColor(Color.Green));

// Save the Word document.
doc.Save(@"recolor-desired-color.docx");

     

    Original Picture Color Adjusted

     

    Set Picture Color Transparency

    DsWord allows you to set picture color transparency using SetColorTransparent method of ImageData class.

    Refer to the following example code to set the black color to transparent:

    C#
    Copy Code 
    // Initialize GcWordDocument.
GcWordDocument doc = new GcWordDocument();

// Read PNG image from a file.
var bytes = File.ReadAllBytes(@"image.png");

// Add PNG picture into the document.
var picture = doc.Body.AddParagraph().AddRun().AddPicture(bytes, @"image/png", 300f, 300f);

// Set black color transparent in the picture.
picture.ImageData.SetColorTransparent(new UserColor(Color.FromArgb(15, 17, 19)));

// Save the Word document.
doc.Save(@"set-transparent-color.docx");

     

    Original Black Color- Transparent

     

    Limitations

    DsWord does not support picture effects in exporting to PDF and images at this time.