is_Convert

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

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

•is_SetColorMode()

•is_SetColorConverter()

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));

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.