Exposure Time#

Exposure Time カメラ機能は、画像取得中に画像センサーが露光する時間を指定します。

露光時間を自動的に設定するには、Exposure Auto機能を使用します。

機能を使用する#

Exposure Timeの確認#

現在の露光時間をマイクロ秒単位で決定するには：

• On ace 2, boost R, and dart R/M cameras, get the value of the BslEffectiveExposureTime parameter. This parameter is read-only. It takes factors like internal offsets or clock speed requirements into account that may cause the exposure time to differ from the exposure time set.
• 他のカメラでは、ExposureTimeパラメーターの値を取得します。センサーのタイプとその固有の特性によっては、この値が有効露光時間と多少異なる場合があることに注意してください。

Exposure Autoオートファンクションが有効になっていて、自動的に調整された露光時間を取得する場合などに、露光時間を決定すると便利です。

Exposure Time Mode#

On some camera models, the ExposureTimeMode parameter is available. It allows you to choose between exposure time modes that provide different exposure time ranges. Depending on your camera model, you can also set individual exposure times for different regions on the sensor, e.g., for two sensor lines or for red and green pixels.

ExposureTimeModeパラメーターは、次のいずれかの値に設定できます。

• Common or Standard: Enables the Common or Standard exposure time mode. This is the default setting.
• Individual: Allows you to specify different exposure times for individual regions on the image sensor. This can be useful, if you want to define different exposure times, e.g., for two sensor lines.
• Short: Allows you to set a short exposure time within the value range available.
• UltraShort: Allows you to set an ultra short exposure time within the value range available.

Exposure Time Selector#

On some camera models, the ExposureTimeSelector parameter is available. It allows you to expose either the entire image sensor for the exposure time specified or individual regions on the image sensor.

You can set the ExposureTimeSelector parameter to one of the following values:

• Common: The entire image sensor is exposed for the exposure time specified.
• Stage 1 to Stage 4: The selected stage is exposed for the exposure time specified. A stage is a predefined region on the image sensor.
  Note: The number of stages available depends on your camera model.

Exposure Timeの設定#

露光時間を設定するには、次の手順に従います。

1. ExposureModeパラメーターをTimedに設定します。
2. If available, set the ExposureAuto parameter to Off.
3. Set the ExposureTimeMode parameter (if available) to the desired exposure time mode.

4. Set the ExposureTimeSelector parameter (if available) to the sensor region that should be exposed.

   情報

   To be able to specify exposure times for different regions, the ExposureTimeMode parameter must be set to Individual.

5. ExposureTime パラメーターを目的の露光時間（マイクロ秒単位）に設定します。

6. If necessary, repeat steps 4 and 5 for every region for which you want to specify individual exposure times.

最小/最大露光時間は、カメラモデルによって異なります。

特性#

すべてのカメラモデルを表示します

ace Classicカメラの追加情報#

表1#

次の表は、8ビットピクセルフォーマットを使用したacA2040-90uc/um/umNIRおよびacA2000-165uc/um/umNIRカメラに適用されます。

表2#

次の表は、Global Reset Releaseシャッターモードで操作した場合に、示されているカメラモデルに適用されます。

Example: Assume you are operating an acA3800-10gm camera in Global Reset Release shutter mode. You set the exposure time to 1000 µs. The effective exposure time is 1000 + 5218 = 6218 µs.

サンプルコード#

ace Classic/U/L GigEカメラ#

// Determine the current exposure time
double d = camera.ExposureTimeAbs.GetValue();
// Set the exposure time to 3500 microseconds
camera.ExposureTimeAbs.SetValue(3500.0);

INodeMap& nodemap = camera.GetNodeMap();
// Determine the current exposure time
double d = CFloatParameter(nodemap, "ExposureTimeAbs").GetValue();
// Set the exposure time to 3500 microseconds
CFloatParameter(nodemap, "ExposureTimeAbs").SetValue(3500.0);

// Determine the current exposure time
double d = camera.Parameters[PLCamera.ExposureTimeAbs].GetValue();
// Set the exposure time to 3500 microseconds
camera.Parameters[PLCamera.ExposureTimeAbs].SetValue(3500.0);

/* 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 */
double d = 0;
/* Determine the current exposure time */
errRes = PylonDeviceGetFloatFeature(hdev, "ExposureTimeAbs", &d);
CHECK(errRes);
/* Set the exposure time to 3500 microseconds */
errRes = PylonDeviceSetFloatFeature(hdev, "ExposureTimeAbs", 3500.0);
CHECK(errRes);

# Determine the current exposure time
d = camera.ExposureTimeAbs.Value
# Set the exposure time to 3500 microseconds
camera.ExposureTimeAbs.Value = 3500.0

ace 2, boost, and dart M/R Cameras#

// Determine the current exposure time using Exposure Time
double d = camera.ExposureTime.GetValue();
// Determine the current exposure time using Effective Exposure Time
double d = camera.BslEffectiveExposureTime.GetValue();
// Set the exposure time mode to Common
camera.ExposureTimeMode.SetValue(ExposureTimeMode_Common);
// Set the exposure time to 3500 microseconds
camera.ExposureTime.SetValue(3500.0);

INodeMap& nodemap = camera.GetNodeMap();
// Determine the current exposure time using Exposure Time
double d = CFloatParameter(nodemap, "ExposureTime").GetValue();
// Determine the current exposure time using Effective Exposure Time
d = CFloatParameter(nodemap, "BslEffectiveExposureTime").GetValue();
// Set the exposure time mode to Common
CEnumParameter(nodemap, "ExposureTimeMode").SetValue("Common");
// Set the exposure time to 3500 microseconds
CFloatParameter(nodemap, "ExposureTime").SetValue(3500.0);

// Determine the current exposure time using Exposure Time
double d = camera.Parameters[PLCamera.ExposureTime].GetValue();
// Determine the current exposure time using Effective Exposure Time
d = camera.Parameters[PLCamera.BslEffectiveExposureTime].GetValue();
// Set the exposure time mode to Common
camera.Parameters[PLCamera.ExposureTimeMode].SetValue(PLCamera.ExposureTimeMode.Common);
// Set the exposure time to 3500 microseconds
camera.Parameters[PLCamera.ExposureTime].SetValue(3500.0);

/* 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 */
double d = 0;
/* Determine the current exposure time using Exposure Time */
errRes = PylonDeviceGetFloatFeature(hdev, "ExposureTime", &d);
CHECK(errRes);
/* Determine the current exposure time using Effective Exposure Time */
errRes = PylonDeviceGetFloatFeature(hdev, "BslEffectiveExposureTime", &d);
CHECK(errRes);
/* Set the exposure time mode to Common */
errRes = PylonDeviceFeatureFromString(hdev, "ExposureTimeMode", "Common");
CHECK(errRes);
/* Set the exposure time to 3500 microseconds */
errRes = PylonDeviceSetFloatFeature(hdev, "ExposureTime", 3500.0);
CHECK(errRes);

# Determine the current exposure time using Exposure Time
d = camera.ExposureTime.Value
# Determine the current exposure time using Effective Exposure Time
d = camera.BslEffectiveExposureTime.Value
# Set the exposure time mode to Common
camera.ExposureTimeMode.Value = "Common"
# Set the exposure time to 3500 microseconds
camera.ExposureTime.Value = 3500.0

その他のカメラ#

// Determine the current exposure time
double d = camera.ExposureTime.GetValue();
// Set the exposure time to 3500 microseconds
camera.ExposureTime.SetValue(3500.0);

INodeMap& nodemap = camera.GetNodeMap();
// Determine the current exposure time
double d = CFloatParameter(nodemap, "ExposureTime").GetValue();
// Set the exposure time to 3500 microseconds
CFloatParameter(nodemap, "ExposureTime").SetValue(3500.0);

// Determine the current exposure time
double d = camera.Parameters[PLCamera.ExposureTime].GetValue();
// Set the exposure time to 3500 microseconds
camera.Parameters[PLCamera.ExposureTime].SetValue(3500.0);

/* 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 */
double d = 0;
/* Determine the current exposure time */
errRes = PylonDeviceGetFloatFeature(hdev, "ExposureTime", &d);
CHECK(errRes);
/* Set the exposure time to 3500 microseconds */
errRes = PylonDeviceSetFloatFeature(hdev, "ExposureTime", 3500.0);
CHECK(errRes);

# Determine the current exposure time
d = camera.ExposureTime.Value
# Set the exposure time to 3500 microseconds
camera.ExposureTime.Value = 3500.0

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。