is_SetColorMode

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_SetColorMode (HIDS hCam, INT Mode)

Beschreibung

is_SetColorMode() stellt den Farbmodus ein, mit dem die Bilddaten übertragen bzw. in der Grafikkarte dargestellt werden. Dazu muss der allozierte Bildspeicher je nach Farbmodus ausreichend groß sein. Bei der direkten Übertragung in den Bildspeicher der Grafikkarte muss sichergestellt sein, dass die Display-Einstellungen mit den Einstellungen des Farbmodus übereinstimmen. Unter Umständen kommen die Bilder sonst in verfälschten Farben oder unkenntlich zur Darstellung.

Hinweis zum Darstellungsmodus

Diese Funktion wird nur im Bitmap (DIB)-Modus unterstützt.

Verwenden Sie die Funktion is_SetDisplayMode(), um im Direct3D- oder OpenGL-Modus andere Farbformate darzustellen.

Farbformat der UI-1007XS

Die UI-1007XS führt eine interne Farbkonvertierung durch und unterstützt derzeit folgende Farbformate:

•IS_CM_BGR8_PACKED

•IS_CM_BGRA8_PACKED

•IS_CM_CBYCRY_PACKED

•IS_CM_JPEG

Hinweis zur Bittiefe

Farbformate mit mehr als 8 Bit pro Kanal werden von Kameras der GigE uEye Serie, USB 3 uEye Modellen sowie den USB 2.0-Modellen mit Rev. 3 unterstützt. Bei Verwendung dieser Farbformate erhöht sich die von der Kamera benötigte Bandbreite.

Hinweis zu RGB15/16

Bei den Datenformaten RGB16 und RGB15 werden von den internen 8-Bit R-, G- und B-Farben die jeweils oberen Bits verwendet.

Folgenden Farbformate werden derzeit noch nicht von den GigE uEye Kameras unterstützt:

•IS_CM_SENSOR_RAW10

•IS_CM_MONO10

•IS_CM_RGB10_UNPACKED

•IS_CM_BGR10_UNPACKED

Übergabeparameter

hCam

Handle auf Kamera

Zu setzender Farbmodus Eine Liste aller möglichen Farbformate und der zugehörigen Übergabeparameter findet sich unter Anhang: Farb- und Speicherformate.

IS_CM_MONO16	Graustufen (16), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_MONO12	Graustufen (12), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_MONO10	Graustufen (10), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_MONO8	Graustufen (8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_SENSOR_RAW16	Raw Bayer (16), unveränderte Sensorrohdaten für Monochrom- und Farbkameras, LUT-/Gamma-Funktion nicht aktiv.
IS_CM_SENSOR_RAW12	Raw Bayer (12), unveränderte Sensorrohdaten für Monochrom- und Farbkameras, LUT-/Gamma-Funktion nicht aktiv.
IS_CM_SENSOR_RAW10	Raw Bayer (10), unveränderte Sensorrohdaten für Monochrom- und Farbkameras, LUT-/Gamma-Funktion nicht aktiv.
IS_CM_SENSOR_RAW8	Raw Bayer (8), unveränderte Sensorrohdaten für Monochrom- und Farbkameras, LUT-/Gamma-Funktion nicht aktiv.
IS_CM_RGB12_UNPACKED	Ungepacktes RGB (12 12 12), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGB10_UNPACKED	Ungepacktes RGB (10 10 10), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGB10_PACKED	RGB (10 10 10), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGB8_PACKED	RGB (8 8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGBA12_UNPACKED	Ungepacktes RGB (12 12 12), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGBA8_PACKED	RGB (8 8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGBY8_PACKED	RGBY (8 8 8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGR12_UNPACKED	Ungepacktes BGR (12 12 12), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGR10_UNPACKED	Ungepacktes BGR (10 10 10), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGR10_PACKED	BGR (10 10 10), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGR8_PACKED	BGR (8 8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGRA12_UNPACKED	Ungepacktes BGR (12 12 12), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGRA8_PACKED	BGR (8 8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGRY8_PACKED	BGRY (8 8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_RGB8_PLANAR	Planares RGB (8) für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGR565_PACKED	BGR (5 6 5), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_BGR5_PACKED	BGR (5 5 5), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_UYVY_PACKED	YUV 4:2:2 (8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_CBYCRY_PACKED	YCbCr 4:2:2 (8 8), für Monochrom- und Farbkameras, LUT-/Gamma-Funktion aktiv.
IS_CM_PREFER_PACKED_SOURCE_FORMAT	Nur USB 3 uEye Kameras: Wird IS_CM_PREFER_PACKED_SOURCE_FORMAT zum gewählten Pixelformat verodert, werden für die Übertragung gepackte Pixelformat bevorzugt. Das Kommando kann mit folgenden Formaten kombiniert werden (in Verbindung mit anderen Pixelformaten wird es ignoriert): •IS_CM_SENSOR_RAW10 •IS_CM_MONO10 •IS_CM_BGR10_UNPACKED •IS_RGB10_UNPACKED Da für die Übertragung ein gepacktes Format verwendet wird, wird weniger Bandbreite benötigt. Da das Bild im PC wieder entpackt werden muss, erhöht sich jedoch die CPU-Last.
IS_CM_JPEG	JPEG für USB uEye XS
IS_GET_COLOR_MODE	Gibt die aktuelle Einstellung zurück

Rückgabewert

In Verbindung mit IS_GET_COLOR_MODE	Aktuelle Einstellung
IS_CANT_COMMUNICATE_WITH_DRIVER	Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist.
IS_CAPTURE_RUNNING	Es läuft bereits eine Aufnahme, die zuerst beendet werden muss.
IS_INVALID_COLOR_FORMAT	Ungültiges Farbformat
IS_INVALID_CAMERA_HANDLE	Ungültiges Kamera-Handle
IS_INVALID_MODE	Kamera im Standby, Funktion nicht erlaubt
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_IO_REQUEST_FAILED	Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen.
IS_NO_IR_FILTER	Kein IR-Filter vorhanden
IS_NO_SUCCESS	Allgemeine Fehlermeldung
IS_NOT_CALIBRATED	Die Kamera enthält keine Kalibrierungsdaten.
IS_NOT_SUPPORTED	Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.
IS_NULL_POINTER	Ungültiges Array
IS_OUT_OF_MEMORY	Es konnte kein Speicher alloziert werden.
IS_SUCCESS	Funktion erfolgreich
IS_TIMED_OUT	Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden.

Verwandte Funktionen

•is_SetDisplayMode()

•is_SetColorConverter()

•is_SetColorCorrection()

•is_GetColorDepth()

•is_AllocImageMem()

•is_RenderBitmap()

Hinweis zu veralteten Parametern

Die folgenden Parameter für Farbformate sind veraltet, es sollten nur noch die neuen Parameter verwendet werden:

Alter Parameter	Neuer Parameter
IS_SET_CM_RGB32	IS_CM_BGRA8_PACKED
IS_SET_CM_RGB24	IS_CM_BGR8_PACKED
IS_SET_CM_RGB16	IS_CM_BGR565_PACKED
IS_SET_CM_RGB15 IS_CM_BGR555_PACKED	IS_CM_BGR5_PACKED
IS_SET_CM_Y8	IS_CM_MONO8
IS_SET_CM_BAYER IS_CM_BAYER_RG8	IS_CM_SENSOR_RAW8
IS_SET_CM_UYVY	IS_CM_UYVY_PACKED
IS_SET_CM_UYVY_MONO	IS_CM_UYVY_MONO_PACKED
IS_SET_CM_UYVY_BAYER	IS_CM_UYVY_BAYER_PACKED
IS_SET_CM_CBYCRY	IS_CM_CBYCRY_PACKED
IS_SET_CM_RGBY	IS_CM_BGRY8_PACKED
IS_SET_CM_RGB30 IS_CM_BGR10V2_PACKED	IS_CM_BGR10_PACKED
IS_CM_RGB10V2_PACKED	IS_CM_RGB10_PACKED
IS_SET_CM_Y12	IS_CM_MONO12
IS_SET_CM_BAYER12 IS_CM_BAYER_RG12	IS_CM_SENSOR_RAW12
IS_SET_CM_Y16	IS_CM_MONO16
IS_SET_CM_BAYER16 IS_CM_BAYER_RG16	IS_CM_SENSOR_RAW16
IS_CM_RGB12_PACKED	IS_CM_RGB12_UNPACKED
IS_CM_RGBA12_PACKED	IS_CM_RGBA12_UNPACKED
IS_CM_BGR12_PACKED	IS_CM_BGR12_UNPACKED
IS_CM_BGRA12_PACKED	IS_CM_BGRA12_UNPACKED

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.