 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
IDSEXP is_Convert(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParam)
Beschreibung
is_Convert() ist eine allgemeine Funktion, um ein Raw-Bayer-Bild in das gewünschte Format umzuwandeln. Es lassen sich hierbei alle Parameter angeben, die bei Softwarekonvertierung von Bedeutung sind:
•Pixelformat
•Pixelkonverter (3×3, 5×5)
•Farbkorrektur
•Gamma
•Sättigung
•Kantenverstärkung
Der Zielpuffer muss zuvor mit der Funktion is_AllocImageMem() alloziert worden sein und die richtig Größe besitzen.
Ü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. |
Inhalt der Struktur BUFFER_CONVERSION_PARAMS
char* |
pSourceBuffer |
Zeiger auf den Raw-Bayer-Puffer, der über die Funktion is_AllocImageMem() angelegt wurde. |
char* |
pDestBuffer |
Zeiger auf den Zielpuffer mit den konvertierten Daten, der über die Funktion is_AllocImageMem() angelegt wurde. |
INT |
nDestPixelFormat |
Farbmodus für das Zielbild, siehe is_SetColorMode() für die möglichen Modi |
INT |
nDestPixelConverter |
Konvertierungsmodus für das Zielbild: siehe is_SetColorConverter() für die möglichen Modi |
INT |
nDestGamma |
Setzt die Gammakorrektur, siehe is_Gamma() |
INT |
nDestEdgeEnhancement |
Setzt den Kantenfilter, siehe is_EdgeEnhancement() |
INT |
nDestColorCorrectionMode |
Setzt die Farbkorrektur, siehe is_SetColorCorrection() |
INT |
nDestSaturationU |
Setzt die Farbsättigung (Sättigung-U), siehe is_SetSaturation() |
INT |
nDestSaturationV |
Setzt die Farbsättigung (Sättigung-V),siehe is_SetSaturation() |
BYTE |
reserved[32] |
reserviert |
Rückgabewert
IS_INVALID_BUFFER_SIZE |
Der Bildspeicher hat die falsche Größe um das Bild im gewünschten Format aufzunehmen. |
IS_INVALID_PARAMETER |
Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich. |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_NOT_SUPPORTED |
Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht. |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
Beispiel
BUFFER_CONVERSION_PARAMS conversionParams;
conversionParams.nDestPixelFormat = IS_CM_BGRA8_PACKED;
conversionParams.nDestPixelConverter = IS_CONV_MODE_SOFTWARE_3X3;
conversionParams.nDestColorCorrectionMode = IS_CCOR_DISABLE;
conversionParams.nDestGamma = 100;
conversionParams.nDestSaturationU = 100;
conversionParams.nDestSaturationV = 100;
conversionParams.nDestEdgeEnhancement = 0;
conversionParams.pSourceBuffer = pSourceBuffer;
conversionParams.pDestBuffer = pDestBuffer;
INT nRet = is_Convert(m_hCam, IS_CONVERT_CMD_APPLY_PARAMS_AND_CONVERT_BUFFER,
(void*)&conversionParams, sizeof(conversionParams));
