IDS Software Suite 4.96.1

Syntax

INT is_IO(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)

Beschreibung

Für die Pulsweitenmodulation können Sie entweder den Blitzausgang oder die zusätzlichen digitalen Ausgänge (GPIO) einiger uEye Modelle verwenden. Informationen zur Beschaltung der GPIO finden Sie im Kapitel D: Spezifikation.

Die Pulsweitenmodulation wird unterstützt von allen GigE uEye Kameras, USB 3 uEye Kameras und uEye SE USB 3.1 Gen 1 Kameras. Sie wird nicht unterstützt von UI-359xLE Rev. 1 sowie uEye LE USB 3.1 Gen 1.

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.

Übergabeparameter

Inhalte der Struktur IO_PWM_PARAMS

Beispiel 1

INT nRet = IS_SUCCESS;
 
// Get all GPIOs that can be used as flash output
UINT nGPIOs_Flash = 0;
INT nRet = is_IO(m_hCam, IS_IO_CMD_FLASH_GET_SUPPORTED_GPIOS, (void*)&nGPIOs_Flash, sizeof(nGPIOs_Flash));
 
// Get all GPIOs that can be used for the PWM
UINT nGPIOs_PWM = 0;
INT nRet = is_IO(m_hCam, IS_IO_CMD_PWM_GET_SUPPORTED_GPIOS, (void*)&nGPIOs_PWM, sizeof(nGPIOs_PWM));

Beispiel 2

INT nRet = IS_SUCCESS;
 
// Set GPIO1 as PWM output
UINT nMode = IO_GPIO_1;
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_SET_MODE, (void*)&nMode, sizeof(nMode));
 
// Set GPIO1, GPIO2 and the flash pin as PWM output
nMode = IO_GPIO_1 | IO_GPIO_2 | IS_FLASH_MODE_PWM;
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_SET_MODE, (void*)&nMode, sizeof(nMode));
 
// Get the current PWM mode
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_GET_MODE, (void*)&nMode, sizeof(nMode));

Beispiel 3

INT nRet = IS_SUCCESS;
 
IO_PWM_PARAMS m_pwmParams;
 
// Get the minimum values of the PWM parameters
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_GET_PARAMS_MIN, (void*)&m_pwmParams, sizeof(m_pwmParams));
if (nRet == IS_SUCCESS)
{
  double dblFrequencyMin = m_pwmParams.dblFrequency_Hz;
  double dblDutyCycleMin = m_pwmParams.dblDutyCycle;
}
 
// Get the maximum values of the PWM parameters
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_GET_PARAMS_MAX, (void*)&m_pwmParams, sizeof(m_pwmParams));
if (nRet == IS_SUCCESS)
{
  double dblFrequencyMax = m_pwmParams.dblFrequency_Hz;
  double dblDutyCycleMax = m_pwmParams.dblDutyCycle;
}
 
// Get the increment of the PWM parameters
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_GET_PARAMS_INC, (void*)&m_pwmParams, sizeof(m_pwmParams));
if (nRet == IS_SUCCESS)
{
  double dblFrequencyInc = m_pwmParams.dblFrequency_Hz;
  double dblDutyCycleInc = m_pwmParams.dblDutyCycle;
}
 
// Get the current values of the PWM parameters
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_GET_PARAMS, (void*)&m_pwmParams, sizeof(m_pwmParams));
if (nRet == IS_SUCCESS)
{
  double dblFrequency = m_pwmParams.dblFrequency_Hz;
  double dblDutyCycle = m_pwmParams.dblDutyCycle;
}
 
// Set the current values of the PWM parameters (1 KHz, 50% duty cycle)
m_pwmParams.dblFrequency_Hz = 1000;
m_pwmParams.dblDutyCycle = 0.5;
nRet = is_IO(m_hCam, IS_IO_CMD_PWM_SET_PARAMS, (void*)&m_pwmParams, sizeof(m_pwmParams));