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

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

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

Reference

AutoColorLevelCommand Class

AutoColorLevelCommand Members

Download our FREE evaluation

Help Version 23.0.2024.3.3

Leadtools.ImageProcessing.Color Assembly

Introduction

Getting Started

Namespaces

Leadtools.ImageProcessing.Color Namespace

Assemblies