←Select platform

Reserved Property

Summary

The Reserved component of this RasterColor structure.

Syntax

C#
Objective-C
C++/CLI
Java
Python
[XmlIgnoreAttribute()] 
public byte Reserved { get; set; } 
@property (nonatomic, assign) unsigned char reserved 
public int getReserved(); 
public void setReserved( 
   int intValue 
); 
public: 
property byte Reserved { 
   byte get(); 
   void set (    byte ); 
} 
Reserved # get and set (RasterColor) 

Property Value

The reserved component of this RasterColor structure (LEADTOOLS toolkits sometimes use the Reserved component, other times the RasterColor.A component).

The Reserved component is used mostly when generating optimized palettes using Leadtools.ImageProcessing.ColorResolutionCommand to indicate whether the color is Regular, Reserved or Empty. See ColorResolutionCommand and Optimized Options for more details.

This property can be set to one of the following values:

The Reserved component will determine the value of RasterColor.IsReservedColor and RasterColor.IsEmptyColor properties. Changing the value RasterColor.IsReservedColor will change the value of RasterColor.Reserved and vice versa.

If 'color' is a RasterColor object, the following C# statements are equivalent:

Example

C#
// 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

See Also

RasterColor Structure

RasterColor Members

Help Version 22.0.2023.5.16
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.