←Select platform

Master Property

Summary
Gets the color leveling information for the Master channel when the Type property is set to either AutoColorLevelCommandType.Contrast or AutoColorLevelCommandType.Intensity.
Syntax
C#
Objective-C
C++/CLI
Java
Python
public ColorLevelCommandData Master { get; } 
@property (nonatomic, strong, readonly) LTColorLevelCommandData *master; 
public ColorLevelCommandData getMaster(); 
public: 
property ColorLevelCommandData^ Master { 
   ColorLevelCommandData^ get(); 
} 
Master # get  (AutoColorLevelCommand) 

Property Value

The color leveling information for the Master channel. If AutoColorLevelCommandFlags.NoProcess is not set in Flag property, you can set the value of this property as null. If AutoColorLevelCommandFlags.NoProcess is set in Flag property, then this property cannot be null.

Remarks

If Flag property is set to AutoColorLevelCommandType.Level, then the value of this property is unchanged. The AutoColorLevelCommand command updates the value of this property.

In order to speed up widely used image processing filters in LEADTOOLS, the grayscale value (master channel) of a colored image is calculated using the following formulas:

#define CalcGrayValue(r, g, b) ((L_UCHAR)(((L_UCHAR) (((2 * (L_UINT) (r)) + (5 * (L_UINT) (g)) + (L_UINT) (b) + 4) / 8)))) 
#define CalcGrayValue16(r, g, b) ((L_UINT16) (((2 * (L_UINT32) (r)) + (5 * (L_UINT32) (g)) + (L_UINT32) (b) + 4) / 8)) 
#define CalcGrayValue32(r, g, b) ((L_UINT32) (((2 * (L_UINT32) (r)) + (5 * (L_UINT32) (g)) + (L_UINT32) (b) + 4) / 8)) 
Example
C#
Java
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
 
public void FlagPropertyExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, @"ImageProcessingDemo\Image1.jpg")); 
 
   // Prepare the command 
   AutoColorLevelCommand command = new AutoColorLevelCommand(); 
   command.Flag = AutoColorLevelCommandFlags.NoProcess; 
   command.Type = AutoColorLevelCommandType.Level; 
 
   // Apply "Auto Leveling" to the image. 
   command.Run(image); 
 
   MessageBox.Show("Master Leveling Value: \n Gamma: " + command.Master.Gamma + "\n" + 
      " Minimum Input: " + command.Master.MinimumInput + "\n" + 
      " Minimum Input: " + command.Master.MaximumInput + "\n" + 
      " Minimum Input: " + command.Master.MinimumOutput + "\n" + 
      " Minimum Input: " + command.Master.MaximumOutput); 
 
   MessageBox.Show("Red Leveling Value: \n Gamma: " + command.Red.Gamma + "\n" + 
      " Minimum Input: " + command.Red.MinimumInput + "\n" + 
      " Minimum Input: " + command.Red.MaximumInput + "\n" + 
      " Minimum Input: " + command.Red.MinimumOutput + "\n" + 
      " Minimum Input: " + command.Red.MaximumOutput); 
 
   MessageBox.Show("Green Leveling Value: \n Gamma: " + command.Green.Gamma + "\n" + 
      " Minimum Input: " + command.Green.MinimumInput + "\n" + 
      " Minimum Input: " + command.Green.MaximumInput + "\n" + 
      " Minimum Input: " + command.Green.MinimumOutput + "\n" + 
      " Minimum Input: " + command.Green.MaximumOutput); 
 
   MessageBox.Show("Blue Leveling Value: \n Gamma: " + command.Blue.Gamma + "\n" + 
      " Minimum Input: " + command.Blue.MinimumInput + "\n" + 
      " Minimum Input: " + command.Blue.MaximumInput + "\n" + 
      " Minimum Input: " + command.Blue.MinimumOutput + "\n" + 
      " Minimum Input: " + command.Blue.MaximumOutput); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
} 
 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.color.*; 
 
 
public void autoColorLevelFlagExample() { 
 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   final String outputFilePath = combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"); 
 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.setThrowExceptionsOnInvalidImages(true); 
 
   RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Image1.jpg")); 
 
   // Prepare the command 
   AutoColorLevelCommand command = new AutoColorLevelCommand(); 
   command.setFlag(AutoColorLevelCommandFlags.NO_PROCESS.getValue()); 
   command.setType(AutoColorLevelCommandType.LEVEL); 
 
   // Apply "Auto Leveling" to the image. 
   command.run(image); 
 
   System.out.println("Master Leveling Value: \n Gamma: " + command.getMaster().getGamma() + "\n" + 
         " Minimum Input: " + command.getMaster().getMinimumInput() + "\n" + 
         " Minimum input: " + command.getMaster().getMaximumInput() + "\n" + 
         " Minimum Input: " + command.getMaster().getMinimumOutput() + "\n" + 
         " Minimum Input: " + command.getMaster().getMaximumOutput()); 
 
   System.out.println("Red Leveling Value: \n Gamma: " + command.getRed().getGamma() + "\n" + 
         " Minimum Input: " + command.getRed().getMinimumInput() + "\n" + 
         " Minimum Input: " + command.getRed().getMaximumInput() + "\n" + 
         " Minimum Input: " + command.getRed().getMinimumOutput() + "\n" + 
         " Minimum Input: " + command.getRed().getMaximumOutput()); 
 
   System.out.println("Green Leveling Value: \n Gamma: " + command.getGreen().getGamma() + "\n" + 
         " Minimum Input: " + command.getGreen().getMinimumInput() + "\n" + 
         " Minimum Input: " + command.getGreen().getMaximumInput() + "\n" + 
         " Minimum Input: " + command.getGreen().getMinimumOutput() + "\n" + 
         " Minimum Input: " + command.getGreen().getMaximumOutput()); 
 
   System.out.println("Blue Leveling Value: \n Gamma: " + command.getBlue().getGamma() + "\n" + 
         " Minimum Input: " + command.getBlue().getMinimumInput() + "\n" + 
         " Minimum Input: " + command.getBlue().getMaximumInput() + "\n" + 
         " Minimum Input: " + command.getBlue().getMinimumOutput() + "\n" + 
         " Minimum Input: " + command.getBlue().getMaximumOutput()); 
 
   codecs.save(image, outputFilePath, RasterImageFormat.JPEG, 24); 
 
   assertTrue(new File(outputFilePath).exists()); 
   System.out.println("Command run and image saved to " + outputFilePath); 
 
} 
Requirements

Target Platforms

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

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