 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_ParameterSet(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
Die Funktion is_ParameterSet() speichert den aktuellen Parametersatz einer Kamera in eine Datei oder in den Benutzerspeicher der Kamera und lädt diesen aus einer Datei bzw. aus dem Benutzerspeicher.
Beachten Sie, dass folgende Einstellungen nicht im Benutzerspeicher der Kamera gespeichert werden sondern nur in einer Parameterdatei:
•Einstellungen zur Langzeitbelichtung
•Einstellungen zum Farbmodus
Es können nur kameraspezifische ini-Dateien geladen werden. Das Kapitel uEye Parameterdatei im Anhang beschreibt den Aufbau einer uEye ini-Datei.
|
Durch das geänderte Verhalten der USB 3 uEye CP Rev. 2 ab Treiberversion 4.80 kann der interne Bildspeicher nur noch aktiviert oder deaktiviert werden, wenn die Kamera geschlossen ist. Daher müssen Parameterdateien überarbeitet werden, wenn sie mit einer vorherigen Treiberversion erstellt wurden. |
|
Beim Laden einer ini-Datei ist zu berücksichtigen, dass bereits allozierter Speicher mit den Parametern der ini-Datei in Bezug auf Bildgröße (AOI) und Farbtiefe übereinstimmt. Wenn das nicht der Fall ist, kann es zu Darstellungsfehlern kommen. |
Ü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
hCam |
Handle auf Kamera |
pParam |
Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist. |
cbSizeOfParam |
Größe des Speicherbereichs in Byte, auf den pParam verweist. |
Rückgabewert
IS_INCOMPATIBLE_SETTING |
Die Funktion ist nicht möglich, da andere Einstellungen nicht kompatibel sind. |
IS_INVALID_CAMERA_TYPE |
Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_LOAD_EEPROM, NULL, NULL);
// Load parameters from file (open filebox)
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_LOAD_FILE, NULL, NULL);
// Load parameters from specified file using an absolute path
nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_LOAD_FILE, L"D:\\Camera\\Settings\\file.ini", NULL);
// Load parameters from specified file using a relative path
nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_LOAD_FILE, L"file.ini", NULL);
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_SAVE_EEPROM, NULL, NULL);
// Save parameters to file (open filebox)
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_SAVE_FILE, NULL, NULL);
// Save parameters to specified file
nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_SAVE_FILE, L"file.ini", NULL);
// Get the number of supported parameter sets in the camera's user memory
UINT nNumber;
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_GET_NUMBER_SUPPORTED, (void*) &nNumber, sizeof(nNumber));
// Check if parameter set in the user memory is supported by the camera
UINT nSupportedHWParameterSet;
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_GET_HW_PARAMETERSET_AVAILABLE,
(void*)&nSupportedHWParameterSet, sizeof(nSupportedHWParameterSet));
if (nRet == IS_SUCCESS)
{
if (nSupportedHWParameterSet == 1)
{
// supported
}
}
// Delete parameter set in user memory
INT nRet = is_ParameterSet(m_hCam, IS_PARAMETERSET_CMD_ERASE_HW_PARAMETERSET, NULL, NULL);
