Exposure Time#

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

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

機能を使用する#

Exposure Timeの確認#

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

• その 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.
• その other cameras, get the value of the ExposureTime parameter. Note that depending on the sensor type and its specific characteristics, this value may differ slightly from the effective exposure time.

Determining the exposure time can be useful, for example, if the Exposure Auto auto function is enabled and you want to retrieve the automatically adjusted exposure time.

Exposure Time Mode#

その 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.

You can set the ExposureTimeMode パラメーターを次のいずれかの値に設定します。

• 共通 または 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#

その 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 パラメーターを次のいずれかの値に設定します。

• 共通: The entire image sensor is exposed for the exposure time specified.
• Stage 1: Stage 1 is exposed for the exposure time specified. Stage 1 is a predefined region on the image sensor.
• Stage 2: Stage 2 is exposed for the exposure time specified. Stage 2 is a predefined region on the image sensor.

Exposure Timeの設定#

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

1. パラメーターを ExposureMode parameter to Timed.
2. 利用可能な場合、を設定 ExposureAuto parameter to Off.
3. パラメーターを ExposureTimeMode parameter (（使用している場合）に設定します) to the desired exposure time mode.

4. パラメーターを ExposureTimeSelector parameter (（使用している場合）に設定します) 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 parameter to the desired exposure time in microseconds.

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を使用して、パラメーターを簡単に設定することもできます。