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

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:\LEADTOOLS22\Resources\Images"; 
}

Requirements

Target Platforms

Reference

AutoColorLevelCommand Class

AutoColorLevelCommand Members

Download our FREE evaluation

Help Version 22.0.2023.3.31

Leadtools.ImageProcessing.Color Assembly

Introduction

Getting Started

Namespaces

Leadtools.ImageProcessing.Color Namespace

Assemblies