imgSaturation

内容

  1. 1 メニュー情報
  2. 2 概要
  3. 3 コマンドラインでの使用法
  4. 4 変数
  5. 5 説明
  6. 6 サンプル
  7. 7 アルゴリズム
  8. 8 参考文献
  9. 9 関連のXファンクション

メニュー情報

鮮やかさ

概要

画像の鮮やかさを調整します。

コマンドラインでの使用法

1. imgSaturation a:=30;

2. imgSaturation a:=-30 img:=mat(1) oimg:=mat(2);

変数

表示
名		 変数
名		 I/O
と
データ型		 デフォルト
値		 説明
鮮やかさを調整 a

入力

double

0

鮮やかさに対する変化のパーセンテージを指定します。値は、 [-100, 100]の間で指定します。負の値は鮮やかさを落とし、正の値は鮮やかにします。
入力イメージ img

入力

Image

<active>

操作する画像を指定します。デフォルトの入力はアクティブイメージです。
出力イメージ oimg

出力

Image

<input>

出力画像を指定します。デフォルトで、出力画像は入力画像と同じです。

説明

鮮やかさは、ある色の種類の強度を参照します。 imgSaturation 関数は、画像の鮮やかさを調整するのに使用することができ、色を暗くまたは明るくすることができます。Xファンクションでは、鮮やかさの変更は画像の元の鮮やかさのレベルに基づいています。 Adjust Saturation 変数の入力値が変更するパーセンテージであるということです。変更は、負または正のどちらかにできます。負の値は、鮮やかさを少なくし、色を明るくします。一方、正の値は、鮮やかさを大きくし、色を暗くします。

サンプル

この例では、imgSaturation 関数を使って、入力画像の色をより明るくします。

  1. 入力画像がアクティブなときに、「イメージ：調整：鮮やかさ」を選択します。これはXファンクションのダイアログを開きます。
  2. Xファンクションダイアログで、下の図のように設定を変更して、OK ボタンをクリックしてダイアログを閉じます。

    新しい画像が作成されます。色が明るくなったのが分かります。

Image:imgSaturation_help_English_files_image004.jpg

Image:imgSaturation_help_English_files_image006.jpg

元の画像

出力画像


アルゴリズム

鮮やかさレベルの値は、次の式で変更されます。

Image:imgSaturation_help_English_files_image008.gif
ここで Image:imgSaturation_help_English_files_image010.gifは出力される鮮やかさで、 Image:imgSaturation_help_English_files_image012.gifは、入力の鮮やかさ、change は、Adjust Saturation 変数で指定されます。

計算には、LEADTOOLS Main APIのL_ChangeBitmapSaturation() を使用しています。詳細は、LEADTOOLS Main API Version 14 ヘルプファイルを参照し、トピックL_ChangeBitmapSaturationを読んでください。

参考文献

LEADTOOLS Main API Help file, Version 14

関連のXファンクション

imgBrightness, imgContrast, imgHue, imgGamma