Gamma#
機能を使用する#
仕組み#
カメラは、次の式(例として示すカラーカメラの赤のピクセル値(R))に従って、各画素の明るさの値にガンマ補正値(γ)を適用します。
最大ピクセル値(Rmax)は、例えば、8ビットピクセルフォーマットの場合は255、10ビットピクセルフォーマットの場合は1023に等しくなります。
Gamma補正の有効化#
ガンマ補正を有効にするには、次の手順に従います。
GammaEnable
パラメーターをtrue
に設定します(使用可能な場合)。- 最良の結果を得るには、
BlackLevel
パラメーターを0に設定します。 - パラメーターを
Gamma
パラメーターを必要な値に設定します。パラメーター値の範囲は0~約4です。- Gamma = 1:全体の明るさに変化はありません。
- Gamma < 1: The overall brightness increases.
- Gamma > 1:全体の明るさが下がります。
いずれの場合も、黒のピクセル(明るさ = 0)と白のピクセル(明るさ = 最大)は調整されません。
情報
- ガンマ補正を有効にし、ピクセルフォーマットを12ビットピクセルフォーマットに設定すると、一部の画像情報が失われます。ピクセルデータ出力は12ビットのままですが、ガンマ補正処理中にピクセル値が補間されます。
- On boA13440-17cm cameras, gamma correction can only be enabled, if the pixel format is set to an 8-bit pixel format.
追加パラメーター#
カメラのモデルに応じて、次の追加パラメーターを使用できます。
GammaEnable
:ガンマ補正を有効または無効にします。Gammaセレクター
:次のいずれかのガンマ補正モードを選択できます。User
:ガンマ補正値を必要に応じて設定できます。(デフォルト)sRGB
:カメラは自動的にガンマ補正値を約0.4に設定します。この値は、sRGBモニターでの画像表示用に最適化されます。
BslColorSpaceMode
またはBslColorSpace
:次のいずれかのガンマ補正モードを選択できます。RGB
:追加のガンマ補正値は適用されません。sRGB
:画像の輝度はsRGBモニターでの表示用に最適化されています。ガンマ補正値約0.4が適用されます。詳細については、「詳細」セクションの脚注を参照してください。
特性#
カメラモデル | 追加パラメーター |
---|---|
a2A640-240gmSWIR | None |
a2A640-240umSWIR | None |
a2A1280-80gmSWIR | None |
a2A1280-125umSWIR | None |
a2A1920-51gcBAS | BslColorSpacec |
a2A1920-51gcPRO | BslColorSpacec |
a2A1920-51gmBAS | None |
a2A1920-51gmPRO | None |
a2A1920-160ucBAS | BslColorSpacec |
a2A1920-160ucPRO | BslColorSpacec |
a2A1920-160umBAS | None |
a2A1920-160umPRO | None |
a2A1920-165g5cBAS | BslColorSpacec |
a2A1920-165g5mBAS | None |
a2A2048-35gmSWIR | None |
a2A2048-37gcBAS | BslColorSpacec |
a2A2048-37gcPRO | BslColorSpacec |
a2A2048-37gmBAS | None |
a2A2048-37gmPRO | None |
a2A2048-110umSWIR | None |
a2A2048-114g5cBAS | BslColorSpacec |
a2A2048-114g5mBAS | None |
a2A2048-114ucBAS | BslColorSpacec |
a2A2048-114ucPRO | BslColorSpacec |
a2A2048-114umBAS | None |
a2A2048-114umPRO | None |
a2A2440-98g5cBAS | BslColorSpacec |
a2A2440-98g5mBAS | None |
a2A2448-23gcBAS | BslColorSpacec |
a2A2448-23gcPRO | BslColorSpacec |
a2A2448-23gmBAS | None |
a2A2448-23gmPRO | None |
a2A2448-75ucBAS | BslColorSpacec |
a2A2448-75ucPRO | BslColorSpacec |
a2A2448-75umBAS | None |
a2A2448-75umPRO | None |
a2A2448-105g5cBAS | BslColorSpacec |
a2A2448-105g5mBAS | None |
a2A2448-120cc | BslColorSpacec |
a2A2448-120cm | None |
a2A2448-210cc | BslColorSpacec |
a2A2448-210cm | None |
a2A2560-20gmSWIR | None |
a2A2560-70umSWIR | None |
a2A2590-22gcBAS | BslColorSpacec |
a2A2590-22gcPRO | BslColorSpacec |
a2A2590-22gmBAS | None |
a2A2590-22gmPRO | None |
a2A2590-60ucBAS | BslColorSpacec |
a2A2590-60ucPRO | BslColorSpacec |
a2A2590-60umBAS | None |
a2A2590-60umPRO | None |
a2A2600-20gcBAS | BslColorSpacec |
a2A2600-20gcPRO | BslColorSpacec |
a2A2600-20gmBAS | None |
a2A2600-20gmPRO | None |
a2A2600-64ucBAS | BslColorSpacec |
a2A2600-64ucPRO | BslColorSpacec |
a2A2600-64umBAS | None |
a2A2600-64umPRO | None |
a2A2840-14gcBAS | BslColorSpacec |
a2A2840-14gcPRO | BslColorSpacec |
a2A2840-14gmBAS | None |
a2A2840-14gmPRO | None |
a2A2840-14gmUV | None |
a2A2840-48ucBAS | BslColorSpacec |
a2A2840-48ucPRO | BslColorSpacec |
a2A2840-48umBAS | None |
a2A2840-48umPRO | None |
a2A2840-48umUV | None |
a2A2840-67g5cBAS | BslColorSpacec |
a2A2840-67g5mBAS | None |
a2A2840-67g5mUV | None |
a2A2840-86cc | BslColorSpacec |
a2A2840-86cm | None |
a2A3536-9gcBAS | BslColorSpacec |
a2A3536-9gcPRO | BslColorSpacec |
a2A3536-9gmBAS | None |
a2A3536-9gmPRO | None |
a2A3536-31ucBAS | BslColorSpacec |
a2A3536-31ucPRO | BslColorSpacec |
a2A3536-31umBAS | None |
a2A3536-31umPRO | None |
a2A3536-42g5cBAS | BslColorSpacec |
a2A3536-42g5mBAS | None |
a2A3840-13gcBAS | BslColorSpacec |
a2A3840-13gcPRO | BslColorSpacec |
a2A3840-13gmBAS | None |
a2A3840-13gmPRO | None |
a2A3840-45ucBAS | BslColorSpacec |
a2A3840-45ucPRO | BslColorSpacec |
a2A3840-45umBAS | None |
a2A3840-45umPRO | None |
a2A4096-9gcBAS | BslColorSpacec |
a2A4096-9gcPRO | BslColorSpacec |
a2A4096-9gmBAS | None |
a2A4096-9gmPRO | None |
a2A4096-30ucBAS | BslColorSpacec |
a2A4096-30ucPRO | BslColorSpacec |
a2A4096-30umBAS | None |
a2A4096-30umPRO | None |
a2A4096-44g5cBAS | BslColorSpacec |
a2A4096-44g5mBAS | None |
a2A4096-67cc | BslColorSpacec |
a2A4096-67cm | None |
a2A4200-12gcBAS | BslColorSpacec |
a2A4200-12gcPRO | BslColorSpacec |
a2A4200-12gmBAS | None |
a2A4200-12gmPRO | None |
a2A4200-40ucBAS | BslColorSpacec |
a2A4200-40ucPRO | BslColorSpacec |
a2A4200-40umBAS | None |
a2A4200-40umPRO | None |
a2A4504-5gcBAS | BslColorSpacec |
a2A4504-5gcPRO | BslColorSpacec |
a2A4504-5gmBAS | None |
a2A4504-5gmPRO | None |
a2A4504-18ucBAS | BslColorSpacec |
a2A4504-18ucPRO | BslColorSpacec |
a2A4504-18umBAS | None |
a2A4504-18umPRO | None |
a2A4504-27g5cBAS | BslColorSpacec |
a2A4504-27g5mBAS | None |
a2A4504-42cc | BslColorSpacec |
a2A4504-42cm | None |
a2A4508-6gcBAS | BslColorSpacec |
a2A4508-6gcPRO | BslColorSpacec |
a2A4508-6gmBAS | None |
a2A4508-6gmPRO | None |
a2A4508-20ucBAS | BslColorSpacec |
a2A4508-20ucPRO | BslColorSpacec |
a2A4508-20umBAS | None |
a2A4508-20umPRO | None |
a2A5060-4gcBAS | BslColorSpacec |
a2A5060-4gmBAS | None |
a2A5060-15ucBAS | BslColorSpacec |
a2A5060-15umBAS | None |
a2A5060-21g5cBAS | BslColorSpacec |
a2A5060-21g5mBAS | None |
a2A5320-7gcBAS | BslColorSpacec |
a2A5320-7gcPRO | BslColorSpacec |
a2A5320-7gmBAS | None |
a2A5320-7gmPRO | None |
a2A5320-23ucBAS | BslColorSpacec |
a2A5320-23ucPRO | BslColorSpacec |
a2A5320-23umBAS | None |
a2A5320-23umPRO | None |
a2A5320-34g5cBAS | BslColorSpacec |
a2A5320-34g5mBAS | None |
a2A5320-52cc | BslColorSpacec |
a2A5320-52cm | None |
a2A5328-4gcBAS | BslColorSpacec |
a2A5328-4gcPRO | BslColorSpacec |
a2A5328-4gmBAS | None |
a2A5328-4gmPRO | None |
a2A5328-15ucBAS | BslColorSpacec |
a2A5328-15ucPRO | BslColorSpacec |
a2A5328-15umBAS | None |
a2A5328-15umPRO | None |
a2A5328-22g5cBAS | BslColorSpacec |
a2A5328-22g5mBAS | None |
a2A5328-35cc | BslColorSpacec |
a2A5328-35cm | None |
acA640-121gm | GammaEnable GammaSelector |
acA640-300gc | GammaEnable GammaSelector |
acA640-300gm | GammaEnable GammaSelector |
acA640-750uc | Nonea |
acA640-750um | Nonea |
acA720-290gc | GammaEnable GammaSelector |
acA720-290gm | GammaEnable GammaSelector |
acA720-520uc | Nonea |
acA720-520um | Nonea |
acA800-200gc | GammaEnable GammaSelector |
acA800-200gm | GammaEnable GammaSelector |
acA800-510uc | Nonea |
acA800-510um | Nonea |
acA1280-60gc | GammaEnable GammaSelector |
acA1280-60gm | GammaEnable GammaSelector |
acA1300-60gc | GammaEnable GammaSelector |
acA1300-60gm | GammaEnable GammaSelector |
acA1300-60gmNIR | GammaEnable GammaSelector |
acA1300-75gc | GammaEnable GammaSelector |
acA1300-75gm | GammaEnable GammaSelector |
acA1300-200uc | Nonea |
acA1300-200um | Nonea |
acA1440-73gc | GammaEnable GammaSelector |
acA1440-73gm | GammaEnable GammaSelector |
acA1440-220uc | Nonea |
acA1440-220um | Nonea |
acA1600-20gc | GammaEnable GammaSelector |
acA1600-20uc | Nonea |
acA1600-60gc | GammaEnable GammaSelector |
acA1600-60gm | GammaEnable GammaSelector |
acA1920-25gc | GammaEnable GammaSelector |
acA1920-25gm | GammaEnable GammaSelector |
acA1920-25uc | Nonea |
acA1920-25um | Nonea |
acA1920-40gc | GammaEnable GammaSelector |
acA1920-40gm | GammaEnable GammaSelector |
acA1920-40uc | Nonea |
acA1920-40ucMED | Nonea |
acA1920-40um | Nonea |
acA1920-40umMED | Nonea |
acA1920-48gc | GammaEnable GammaSelector |
acA1920-48gm | GammaEnable GammaSelector |
acA1920-50gc | GammaEnable GammaSelector |
acA1920-50gm | GammaEnable GammaSelector |
acA1920-150uc | Nonea |
acA1920-150um | Nonea |
acA1920-155uc | Nonea |
acA1920-155ucMED | Nonea |
acA1920-155um | Nonea |
acA1920-155umMED | Nonea |
acA2000-50gc | GammaEnable GammaSelector |
acA2000-50gm | GammaEnable GammaSelector |
acA2000-165uc | Nonea |
acA2000-165um | Nonea |
acA2040-25gc | GammaEnable GammaSelector |
acA2040-25gm | GammaEnable GammaSelector |
acA2040-25gmNIR | GammaEnable GammaSelector |
acA2040-35gc | GammaEnable GammaSelector |
acA2040-35gm | GammaEnable GammaSelector |
acA2040-55uc | Nonea |
acA2040-55um | Nonea |
acA2040-90uc | Nonea |
acA2040-90um | Nonea |
acA2040-90umNIR | Nonea |
acA2040-120uc | Nonea |
acA2040-120um | Nonea |
acA2440-20gc | GammaEnable GammaSelector |
acA2440-20gm | GammaEnable GammaSelector |
acA2440-35uc | Nonea |
acA2440-35ucMED | Nonea |
acA2440-35um | Nonea |
acA2440-35umMED | Nonea |
acA2440-75uc | Nonea |
acA2440-75ucMED | Nonea |
acA2440-75um | Nonea |
acA2440-75umMED | Nonea |
acA2500-14gc | GammaEnable GammaSelector |
acA2500-14gm | GammaEnable GammaSelector |
acA2500-14uc | Nonea |
acA2500-14um | Nonea |
acA2500-20gc | GammaEnable GammaSelector |
acA2500-20gcMED | GammaEnable GammaSelector |
acA2500-20gm | GammaEnable GammaSelector |
acA2500-20gmMED | GammaEnable GammaSelector |
acA2500-60uc | Nonea |
acA2500-60um | Nonea |
acA3088-16gc | GammaEnable GammaSelector |
acA3088-16gm | GammaEnable GammaSelector |
acA3088-57uc | Nonea |
acA3088-57ucMED | Nonea |
acA3088-57um | Nonea |
acA3088-57umMED | Nonea |
acA3800-10gc | GammaEnable GammaSelector |
acA3800-10gm | GammaEnable GammaSelector |
acA3800-14uc | Nonea |
acA3800-14um | Nonea |
acA4024-8gc | GammaEnable GammaSelector |
acA4024-8gm | GammaEnable GammaSelector |
acA4024-29uc | Nonea |
acA4024-29um | Nonea |
acA4096-11gc | GammaEnable GammaSelector |
acA4096-11gm | GammaEnable GammaSelector |
acA4096-30uc | Nonea |
acA4096-30ucMED | Nonea |
acA4096-30um | Nonea |
acA4096-30umMED | Nonea |
acA4096-40uc | Nonea |
acA4096-40ucMED | Nonea |
acA4096-40um | Nonea |
acA4096-40umMED | Nonea |
acA4112-8gc | GammaEnable GammaSelector |
acA4112-8gm | GammaEnable GammaSelector |
acA4112-20uc | Nonea |
acA4112-20ucMED | Nonea |
acA4112-20um | Nonea |
acA4112-20umMED | Nonea |
acA4112-30uc | Nonea |
acA4112-30ucMED | Nonea |
acA4112-30um | Nonea |
acA4112-30umMED | Nonea |
acA5472-5gc | GammaEnable GammaSelector |
acA5472-5gm | GammaEnable GammaSelector |
acA5472-17uc | Nonea |
acA5472-17ucMED | Nonea |
acA5472-17um | Nonea |
acA5472-17umMED | Nonea |
boA1936-400cc | BslColorSpacec |
boA1936-400cm | None |
boA2448-250cc | BslColorSpacec |
boA2448-250cm | None |
boA2832-190cc | BslColorSpacec |
boA2832-190cm | None |
boA4096-93cc | BslColorSpacec |
boA4096-93cm | None |
boA4096-180cc | BslColorSpacec |
boA4096-180cm | None |
boA4112-68cc | BslColorSpacec |
boA4112-68cm | None |
boA4500-45cc | BslColorSpacec |
boA4500-45cm | None |
boA4504-100cc | BslColorSpacec |
boA4504-100cm | None |
boA5120-150cc | Gamma機能はサポートされていません |
boA5120-150cm | Gamma機能はサポートされていません |
boA5120-230cc | Gamma機能はサポートされていません |
boA5120-230cm | Gamma機能はサポートされていません |
boA5320-150cc | BslColorSpacec |
boA5320-150cm | None |
boA5328-100cc | BslColorSpacec |
boA5328-100cm | None |
boA6500-36cc | BslColorSpacec |
boA6500-36cm | None |
boA8100-16cc | BslColorSpacec |
boA8100-16cm | None |
boA9344-30cc | Gamma機能はサポートされていません |
boA9344-30cm | Gamma機能はサポートされていません |
boA9344-70cc | Gamma機能はサポートされていません |
boA9344-70cm | Gamma機能はサポートされていません |
boA13440-17cm | None |
daA720-520uc | BslColorSpacea |
daA720-520um | None |
daA1280-54uc | BslColorSpaceModeb |
daA1280-54um | None |
daA1440-220uc | BslColorSpacea |
daA1440-220um | None |
daA1600-60uc | BslColorSpaceModeb |
daA1600-60um | None |
daA1920-15um | None |
daA1920-30uc | BslColorSpaceModeb |
daA1920-30um | None |
daA1920-160uc | BslColorSpacea |
daA1920-160um | None |
daA2448-70uc | BslColorSpacea |
daA2448-70um | None |
daA2500-14uc | BslColorSpaceModeb |
daA2500-14um | None |
daA3840-45uc | BslColorSpacea |
daA3840-45um | None |
dmA720-290gc | BslColorSpacec |
dmA720-290gm | None |
dmA1440-73gc | BslColorSpacec |
dmA1440-73gm | None |
dmA1920-51gc | BslColorSpacec |
dmA1920-51gm | None |
dmA2048-37gc | BslColorSpacec |
dmA2048-37gm | None |
dmA2448-23gc | BslColorSpacec |
dmA2448-23gm | None |
dmA2840-14gc | BslColorSpacec |
dmA2840-14gm | None |
dmA3536-9gc | BslColorSpacec |
dmA3536-9gm | None |
dmA4096-9gc | BslColorSpacec |
dmA4096-9gm | None |
puA1280-54uc | BslColorSpaceModeb |
puA1280-54um | None |
puA1600-60uc | BslColorSpaceModeb |
puA1600-60um | None |
puA1920-30uc | BslColorSpaceModeb |
puA1920-30um | None |
puA2500-14uc | BslColorSpaceModeb |
puA2500-14um | None |
r2L2048-29gc | BslColorSpacec |
r2L2048-58gm | None |
r2L2048-62cc | BslColorSpacec |
r2L2048-62g5c | BslColorSpacec |
r2L2048-172cm | None |
r2L2048-172g5m | None |
r2L4096-14gc | BslColorSpacec |
r2L4096-29gm | None |
r2L4096-42cc | BslColorSpacec |
r2L4096-42g5c | BslColorSpacec |
r2L4096-84cm | None |
r2L4096-84g5m | None |
r2L8192-200cm | None |
r2L16384-120cm | None |
-
光源の初期値を選択すると、約0.4の追加ガンマ補正値(sRGBガンマ補正)が適用されます。この値は個別に適用され、
Gamma
パラメーター値には含まれません。Example:光源の初期値をタングステンに設定し、Gamma
パラメーター値を1.2に設定したとします。まず、ピクセル値に約0.4の自動補正値が適用されます。その後、ガンマ補正値1.2が結果のピクセル値に適用されます。 -
ピクセルフォーマットがYCbCr422またはRGB8に設定されている場合にのみ使用できます。
-
カラースペースが
sRGB
に設定されている場合は、ガンマ補正値約0.4が適用されます。この値は個別に適用され、Gamma
パラメーター値には含まれません。Example:カラースペースをsRGBに設定し、Gamma
パラメーターを1.2に設定したとます。まず、ピクセル値に約0.4の自動補正値が適用されます。その後、ガンマ補正値1.2が結果のピクセル値に適用されます。
Light Source Presetを選択した場合、カラースペースをsRGB
に設定すると、Balance White、Color Adjustment、およびColor Transformationの各機能にも影響します。 -
カラースペースが
sRGB
に設定されている場合、ガンマ補正値が約0.4に適用され、Gamma
パラメーターは読み取り専用になり、Gamma
パラメーター値は無視されます。
サンプルコード#
ace 2, boost, and dart R Cameras#
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK; /* Return value of pylon methods */
/* Set the Gamma value to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "Gamma", 1.2);
CHECK(errRes);
/* Set the color space to sRGB */
errRes = PylonDeviceFeatureFromString(hdev, "BslColorSpace", "sRGB");
CHECK(errRes);
ace Classic/U/L GigEカメラ#
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK; /* Return value of pylon methods */
/* Enable the Gamma feature */
errRes = PylonDeviceSetBooleanFeature(hdev, "GammaEnable", 1);
CHECK(errRes);
/* Set the gamma type to User */
errRes = PylonDeviceFeatureFromString(hdev, "GammaSelector", "User");
CHECK(errRes);
/* Set the Gamma value to 1.2 */
errRes = PylonDeviceSetFloatFeature(hdev, "Gamma", 1.2);
CHECK(errRes);
その他のカメラ#
pylon Viewerを使用して、パラメーターを簡単に設定することもできます。