IsEmptyColor Property

Summary

This property indicates whether RasterColor.EmptyColor is set to 2. Setting this property to true sets RasterColor.EmptyColor to 2 (or RasterColor.EmptyColor)

Syntax

C++/CLI

Python

[XmlIgnoreAttribute()] 
public bool IsEmptyColor { get; set; }

public:  
   [XmlIgnoreAttribute] 
   property bool IsEmptyColor 
   { 
      bool get() 
      void set(bool value) 
   }

IsEmptyColor # get and set (RasterColor)

Property Value

true if RasterColor.EmptyColor is 2. false if RasterColor.EmptyColor is not 2.

Remarks

This is the same as checking whether RasterColor.Reserved == 2 (or RasterColor.Reserved == RasterColor.EmptyColor).

Example

// This C# example assumes 'image' is a 24/32/48/64-bit bitmap. It converts it to an optimized palette of 255 colors.  
// In this case, pick a color for 'palette[0]' and let the other 255 entries be filled by ColorResolutionCommand.  
 
private static void TestCustomOptimizedPalette(RasterImage image) 
{ 
   RasterColor[] palette = new RasterColor[256]; 
 
   // Pick a color for the first palette entry (for example, a bitmap with a transparent color). 
   // In this case, set this entry to a color that is not in the image and then fill the transparent area with this color.  
 
   palette[0] = new RasterColor(1, 1, 1); 
   palette[0].IsReservedColor = true;  // Mark this color as reserved 
 
   // Mark all the other palette entries as empty, so ColorResolutionCommand will fill them  
   for (int i = 1; i <= 255; i++) 
      palette[i].IsEmptyColor = true; // Mark all remaining palette entries as empty 
 
   ColorResolutionCommand cmd = 
   new ColorResolutionCommand(ColorResolutionCommandMode.InPlace, 
                              8, 
                              RasterByteOrder.Rgb, 
                              RasterDitheringMethod.FloydStein, 
                              ColorResolutionCommandPaletteFlags.Optimized, 
                              null); 
   cmd.SetPalette(palette); 
 
   cmd.Run(image); 
    
   // Now 'image' is an 8-bit image with a palette. If you do 'RasterColor[] imagePalette = image.GetPalette()': 
   //   - imagePalette[0] should be the selected color 
   //   - imagePalette[1], imagePalette[2], ... imagePalette[255] should be various colors chosen by the ColorResolution command 
    
}

Requirements

Target Platforms

Reference

RasterColor Class

RasterColor Members

Leadtools Namespace

Download our FREE evaluation

Help Version 22.0.2023.5.16

Leadtools Assembly

Introduction

Getting Started

Namespaces

Leadtools Namespace

Leadtools.ImageProcessing Namespace

Assemblies