Saturation Property

Summary

Gets or sets a value that represents the percentage amount to change saturation, in tenths of percent.

Syntax

Objective-C

C++/CLI

Java

Python

public int Saturation { get; set; }

@property (nonatomic, assign) NSInteger saturation;

public int getSaturation(); 
public void setSaturation( 
   int intValue 
);

public: 
property int Saturation { 
   int get(); 
   void set (    int ); 
}

Saturation # get and set (ChangeHueSaturationIntensityCommand)

Property Value

Percentage amount to change saturation, in tenths of a percent. Valid values range from -1000 through 1000. This value is divided internally by 10. Negative values decrease the saturation of colors. Positive values increase the saturation. The saturation level is increased or decreased by a percentage of its present saturation level. For example, an increase of 20 of the current saturation level "L" will raise the new saturation level "L1" to a value L = 0.20 * L. Likewise, increasing the saturation level 100 doubles the saturation level (L1 = L + 1.0 * L). Decreasing the saturation level 100 will set the new saturation level to 0. This process is carried out for every pixel. The saturation is set to 1000 (maximum value) if the new value exceeds 1000).

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.Color; 
 
 
public void ChangeHueSaturationIntensityCommandExample() 
{ 
   // 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 
   ChangeHueSaturationIntensityCommand command = new ChangeHueSaturationIntensityCommand(); 
   ChangeHueSaturationIntensityCommandData[] data = new ChangeHueSaturationIntensityCommandData[1]; 
   data[0] = new ChangeHueSaturationIntensityCommandData(); 
   data[0].Hue = 18000; 
   data[0].Saturation = 0; 
   data[0].Intensity = 0; 
   data[0].OuterLow = 315; 
   data[0].OuterHigh = 45; 
   data[0].InnerLow = 345; 
   data[0].InnerHigh = 15; 
   command.Data = data; 
   command.Hue = 0; 
   command.Saturation = 0; 
   command.Intensity = 0; 
 
   command.Run(image); 
   codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24); 
 
} 
 
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.Test; 
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 changeHueSaturationIntensityCommandExample() { 
 
    final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
 
    // Load an image 
    RasterCodecs codecs = new RasterCodecs(); 
    codecs.setThrowExceptionsOnInvalidImages(true); 
 
    RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "Image1.jpg")); 
 
    // Prepare the command 
    ChangeHueSaturationIntensityCommand command = new ChangeHueSaturationIntensityCommand(); 
    ChangeHueSaturationIntensityCommandData[] data = new ChangeHueSaturationIntensityCommandData[1]; 
    data[0] = new ChangeHueSaturationIntensityCommandData(); 
    data[0].setHue(18000); 
    data[0].setSaturation(0); 
    data[0].setIntensity(0); 
    data[0].setOuterLow(315); 
    data[0].setOuterHigh(45); 
    data[0].setInnerLow(345); 
    data[0].setInnerHigh(15); 
    command.setData(data); 
    command.setHue(0); 
    command.setSaturation(0); 
    command.setIntensity(0); 
 
    command.run(image); 
 
    // Save the image 
    codecs.save(image, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 24); 
    String outputFileName = combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"); 
 
    assertTrue(new File(outputFileName).exists()); 
    System.out.println("Command run and file exported to: " + combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")); 
 
}

Requirements

Target Platforms

Reference

ChangeHueSaturationIntensityCommand Class

ChangeHueSaturationIntensityCommand 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