Home

Benutzerhandbuch uEye Software Development Kit

Contents

1. Rechnertyp Motherboard CPU RAM VGA Karte Typ VGA Speicher SCSI Controller Oja O nein Netzwerk Oja Onein Typ USB onboard Oja O nein USB Einsteckkarte O ja O nein Typ Betriebssystem O Win2000 installiertes Service Pack O WinXP installiertes Service Pack O Linux Distribution Kernelversions Nr 2000 2007 by IDS Imaging Development Systems GmbH 149 Anhang Abbildungsverzeichnis Abb 1 Prinzipieller Aufbau des Bayer Pattern 2 2400444400snnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nn nnnnnnnn nn 3 ie DEET KETTEN 4 Abb 3 DirectDraw BackBuffer Modus 5 Abb 4 DirectDraw Overlay Surface Modus nn nnnnnnnnn nn 5 Abb 5 Events bei Einzeltrogerautnahme nen 11 Abb 6 Eventsiim Eivemod s ET 11 Abb 7 Events im Mem rymedus 2 2e een el 12 Abb 8 Pre Trigger Modus arira 604 Bere in Reese 15 Abb 9 P St Trigger Oe el 17 Abb 10 Anh ngender Gpoeichermodus AA 18 Abb 11 Ablauf Direct mode Memory mode s ssssssesneesnsssnssensssnsssnssnsssrnnssrnssrnnstensrnsstnnsnentnnnnnnnssnnnsnnnnnnnnnnnnt 19 Abb 12 Timing Diagramm Memorvboard nn nnnnnnnnnn 19 Abb 13 zweifaches Subsamplihg 42 2 CECR ENEE A AAA E aA aE AANE 135 Abb 14 zweifaches Gubesamplmg nnna a aaa a ATAKAA ANE 135 Abb 15 vierfaches Subsampling 2 42 22 Mean en 135 Abb 16 vierfaches Subsampling een 135 Tabellenverzeichnis Tabelle 1 CAMINFO Datenstruktur des
2. IS_SUCCESS IS_NO_SUCCESS 84 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 73 is_Savelmage Syntax INT is_Savelmage HIDS hf char File Beschreibung Speichert ein Bild im Bitmap Format BMP in eine Datei Die Bilder werden aus dem aktiven Bildspeicher ausgelesen siehe auch 4 37 is_GetilmageMem In den DirectDraw Modi werden die Bilddaten direkt aus dem entsprechenden DirectDraw Buffer gelesen Das Auslesen des Grafikartenspeichers kann je nach Bildgr e mehrere 100msec dauern Im DirectDraw Prima ry Surface Modus ist zu beachten dass das Bild so gespeichert wird wie es aktuell auf dem Bildschirm dargestellt ist Es wird nur mit maximal der Gr e des Bild Ausgabefensters gespei chert unabh ngig davon welche Bildgr e mit is_SetlmageSize eingestellt ist Falls andere Fenster das Bild Ausgabefenster ganz oder teilweise berlagern so wird der berlagernde In halt mit gespeichert Das Bitmap wird mit der Farbtiefe 8 15 16 24 oder 32 Bit gespeichert wie der Bildspeicher allokiert wurde bzw wie der aktuelle Farbmodus bei DirectDraw Ausgabemodi eingestellt ist Einige Bildbearbeitungsprogramme unterst tzen keine 15 Bit 16 Bit oder 32 Bit Bitmaps und k nnen somit in diesen Modi gespeicherte Bilder nicht einlesen Der Dateiname kann sowohl absolute als auch relative Pfadangaben enthalten Mit is_Loadlmage werden BMP Bilder gelesen Overlay Daten werden nich
3. bergabeparameter hf Handle auf Kamera EXP Neue gew nschte Exposure Zeit Wenn EXP 0 0 bergeben wird dann wird mit der Belich tungszeit von 1 Framerate belichtet IS_GET_EXPOSURE_TIME Gibt nur die aktuelle Exposure Zeit ber den Parameter ne wEXP zur ck IS_GET_DEFAULT_EXPOSURE Gibt die Standard Exposure Zeit zur ck newEXP Gibt die tats chlich eingestellte Exposure Zeit zur ck Bei Verwendung der Konstanten IS_SET_ENABLE_AUTO_SHUTTER f r den Parameter EXP wird die AutoExposure Funktionalit t aktiviert Durch Setzen eines Wertes wird diese wieder de aktiviert siehe auch 4 80 is SetAutoParameter R ckgabewert IS_SUCCESS IS_NO_SUCCESS EEE 2000 2007 by IDS Imaging Development Systems GmbH 111 Benutzerhandbuch uEye Software Development Kit V2 40 4 98 is_SetExternalTrigger Syntax INT is_SetExternalTrigger HIDS hf INT nTriggerMode Beschreibung is_SetExternalTrigger aktiviert den Triggereingang Mit dem Funktionsaufruf wird die Flanke auf die ein Trigger ausgel st werden soll angegeben Wurde der Trigger aktiviert wird bei je dem Aufruf der Funktion is_FreezeVideo mit der Bildaufnahme gewartet bis das entspre chende Triggerereignis stattgefunden hat e Aktivit t auf Flanke High Low TTL IS_SET_TRIG_HI_LO e Aktivit t auf Flanke Low High TTL IS_SET_TRIG_LOHI e Deaktivieren IS_SET_TRIG_OFF Wenn auf die Triggerfunktionalit t verzichtet wird IS_SET_TRIG_OFF kann der Pegel
4. Mit Hilfe der Funktion is_GetSensorlInfo k nnen Informationen ber den verwendeten Sensor abgefragt werden Die in der Struktur SENSORINFO enthaltenen Informationen sind in der fol genden Tabelle aufgelistet WORD Char Char SensorlD strSensorName 32 nColorMode Sensortyp CMOS IS_SENSOR_INVALID IS_SENSOR_UN41X_M IS_SENSOR_UN41X_C IS_SENSOR_UI144X_M IS_SENSOR_UI144X_C IS_SENSOR_UI45X_C IS_SENSOR_UI146X_C IS_SENSOR_UMN21X_M IS_SENSOR_UN21X_C IS_SENSOR_UMN22X_M IS_SENSOR_UN22X_C IS_SENSOR_UI164X_C IS_SENSOR_UN54X_M IS_SENSOR_UI154X_C IS_SENSOR_UI1543_M IS_SENSOR_UN543_C CCD IS_SENSOR_UI223X_M IS_SENSOR_UI223X_C IS_SENSOR_UI241X_C IS_SENSOR_UI241X_C IS_SENSOR_UI221X_M IS_SENSOR_UI221X_C IS_SENSOR_UI231X_M IS_SENSOR_UI231X_C IS_SENSOR_UI222x_M IS_SENSOR_UI222x_C IS_SENSOR_UI233x_M IS_SENSOR_UI233x_C IS_SENSOR_UI224x_M IS_SENSOR_UI224x_C IS_SENSOR_UI225x_M IS_SENSOR_UI225x_C Sensor Name z B Ul141x_M Sensor Farbmodus IS_COLORMODE_BAYER hex o E Go A OH 11 12 13 20 30 31 32 33 80 81 82 83 88 89 90 91 92 93 94 95 96 97 98 99 dec AUON O 16 17 18 19 32 48 49 50 51 128 129 130 131 136 137 144 145 146 147 148 149 150 151 152 153 a E 2000 2007 by IDS Imaging Development Systems GmbH 63 Benutzerhandbuch uEye Software Development Kit V2 40 IS_COLORMODE_MONOCHROME DWORD nMaxWidth Maximale Fenster Breite z B 1280 DWORD nMaxHeig
5. bergabeparameter hf Handle auf Kamera R ckgabewert IS_CAMERA_TYPE_UEYE_USB 2000 2007 by IDS Imaging Development Systems GmbH 49 Benutzerhandbuch uEye Software Development Kit V2 40 4 27 is_GetColorDepth Syntax INT is_GetColorDepth HIDS hf INT pnCol INT pnColMode Beschreibung is_GetColorDepth ermittelt die aktuelle Farbeinstellung der VGA Karte und gibt die Bittiefe pnCol und den zu pnCol passenden uEye Farbmodus pnCo Mode zur ck Der Farbmodus kann direkt der Funktion is_SetColorMode bergeben werden bergabeparameter hf Handle auf Kamera PnCol Liefert die Bittiefe der Farbeinstellung zur ck 8 bei 256 Farben 15 bei 32768 Farben 5 5 5 Modus 16 bei 65536 Farben 5 6 5 Modus 24 bei 16777216 Farben 8 8 8 Modus 32 bei 16777216 Farben 0 8 8 8 Modus pnColMode Liefert den zu pnCol entsprechenden uEye Farbmodus zur ck IS_SET_CM_Y8 bei pnCol 8 IS_SET_CM_RGB15 bei pnCol 15 IS_SET_CM_RGB16 bei pnCol 16 IS_SET_CM_RGB24 bei pnCol 24 IS_SET_CM_RGB32 bei pnCol 32 R ckgabewert IS_SUCCESS IS_NO_SUCCESS 50 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 28 is_GetDC Syntax INT is_GetDC HIDS hf HDC phDC Beschreibung is_GetDC gibt im DirectDraw BackBuffer Modus das Device Context Handle des Overlaybuf fers zur ck Mit diesem Handle kann ber die Windows GD Funktionen auf das Overlay zuge griffen werden Es ste
6. ret is_SetHWGainFactor hf IS_SET_MASTER_GAIN_FACTOR 357 ret hat f r die UI 1460 C den Wert 363 Abfragen des maximalen Verst rkungsfaktors im Rotkanal ret is_SetHWGainFactor hf IS_INQUIRE_RED_GAIN_FACTOR 100 ret hat f r die UI 1460 C den Wert 725 2000 2007 by IDS Imaging Development Systems GmbH 123 Benutzerhandbuch uEye Software Development Kit V2 40 4 108 is_SetHwnd Syntax INT is_SetHwnd HIDS hf HWND hwnd Beschreibung is_SetHwnd setzt ein neues Fenster Handle f r die Bildausgabe unter DirectDraw Das neue Handle und die Bildausgabe wird erst beim n chsten Aufruf von is_SetDisplayMode wirksam bergabeparameter hf Handle auf Kamera hwnd Handle auf ein Fenster R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 109 is_SetlmageAOl Syntax INT is_SetlmageAOl HIDS hf INT xPos INT yPos INT width INT height is_SetlmageAOl wird vollst ndigt durch die Funktion is_SetAOl ersetzt siehe 4 79 is_SetAOl bergabeparameter hf Handle auf Kamera xPos x Position der oberen linken Ecke yPos y Position der oberen linken Ecke width Bildbreite height Bildh he R ckgabewert IS_SUCCESS oder IS_NO_SUCCESS El 124 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 110 is_SetlmageMem Syntax INT is_SetlmageMem HIDS hf char pcImgMem INT id Beschreibung is_SetlmageMem setzt den angegebenen
7. Bedingt durch die Farbkonvertierung des Bayerformats k nnen die urspr nglichen Kanten in nerhalb eines Farbbildes leicht unscharf werden Durch aktivieren des digitalen Kantenfilters kann diesem Effekt entgegen gewirkt werden Hierf r stehen zwei unterschiedlich starke Ein stellungen IS_EDGE_EN_STRONG IS_EDGE_EN_WEAK zur Verf gung Bei Verwendung dieser Funktion erh ht sich die CPU Belastung des Systems bergabeparameter hf nEnable IS_EDGE_EN_DISABLE IS_EDGE_EN_STRONG IS EDGE EN _WEAK IS_GET_EDGE_ENHANCEMENT R ckgabewert IS_SUCCESS IS_NO_SUCCESS Handle auf Kamera Deaktiviert den Kantenfilter Aktiviert die starke Kantenbetonung Aktiviert die schw chere Kantenbetonung Gibt die aktuelle Einstellung zur ck 2000 2007 by IDS Imaging Development Systems GmbH 109 Benutzerhandbuch uEye Software Development Kit V2 40 4 96 is_SetErrorReport Syntax INT is_SetErrorReport HIDS hf INT Mode Beschreibung Schaltet die Protokollierung der Fehler ein und aus Bei eingeschaltetem Fehlerreport werden auftretende Fehler automatisch ber eine Dialogbox angezeigt Quittiert man die Dialogbox mit Abbrechen wird gleichzeitig der Fehlerreport deaktiviert Ist der Fehlerreport nicht aktiv k nnen Fehler in Verbindung mit der Funktion is_GetError abgefragt werden Das Kamera Handle wird nicht ausgewertet is_SetErrorReport arbeitet global nicht devicebezogen is_SetErrorReport kann vor is_InitCamera aufgerufen
8. Char SerNo 16 Seriennummer der Kamera Char Model 16 Kameramodell DWORD dwReserved 16 F r sp tere Verwendung reserviert bergabeparameter pucl Struktur UEYE_CAMERA_LIST R ckgabewert IS_SUCCESS IS _ACCESS_VIOLATION zu wenig Speicher allokiert oder IS_CANT_OPEN_DEVICE bzw IS_IO_REQUEST_FAILED Kommunikation mit Treiber fehl geschlagen Beispiel PUEYE_CAMERA_LIST pucl new UEYE_CAMERA_LIST first request number of cameras to determine the array size within the UEYE_CAMERA_LIST structure pucl gt dwCount 0 if is_GetCameralist pucl IS_SUCCESS get number of cameras DWORD dwCameraCount pucl gt dwCount delete pucl reallocate the required list size pucl PUEYE_CAMERA_LIST new char sizeof DWORD dwCameraCount sizeof UEYE_CAMERA_INFO pucl gt dwCount dwCameraCount let the DLL fill in the camera info if is_GetCameralist pucl IS_SUCCESS for int iCamera 0 iCamera lt int pucl gt dwCount iCamerat 48 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen process camera info printf Camera i Id d iCamera pucl gt uci iCamera dwCameralD 4 26 is_GetCameraType Syntax INT is_GetCameraType HIDS hf Beschreibung is_GetCameraType liefert als Ergebnis den Typ der Kamera Familie zur ck Bei der uEye Kamera Familie wird immer IS_CAMERA_TYPE_UEYE_USB zur ckgegeben
9. HIDS hf char File char pcMem int nID INT fileFormat INT Pa ram Beschreibung is_SavelmageMemeEx speichert ein Bild im Bitmap oder JPEG Format Die Bilder werden vom Bildspeicher gelesen Das Bitmap wird mit einer Farbtiefe von 8 15 16 24 oder 32 Bit ge speichert entsprechend dem allokierten Bildspeicher Einige Bildverarbeitungsprogramme un terst tzen nicht alle Farbformate 15 16 32 Bit und k nnen diese Bilder nicht laden Die JPEG Datei wird immer mit einer Farbtiefe von 8 oder 24 Bit gespeichert bergabeparameter Hf Handle auf Kamera File Name der Bilddatei NULL gt Speichern unter Dialog wird ge ffnet Es kann sowohl der absolute als auch der relative Pfad ber geben werden pcMem Zeiger auf Bildspeicher niD ID des Bildspeichers fileFormat bestimmt das Ausgabeformat der Datei IS_IMG_BMP Bitmap IS_IMG_JPG JPEG Param Wenn JPEG als Dateiformat gew hlt wird kann mit Param die Qualit t der Kompression zwischen 1 und 100 eingestellt werden Wenn Param 0 ist wird die voreingestellte Qualit t 75 verwendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS IS_INVALID_PARAMETER ung ltiges Dateiformat oder ung ltige JPEG Qualit t 88 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 77 is_SaveParameters Syntax INT is_SaveParameters HIDS hf char pFilename Beschreibung is_SaveParameters speichert die Parameter einer Kamera in eine ini Datei d
10. Wait lt 32768 R ckgabewert IS_SUCCESS IS_NO_SUCCESS Handle auf Kamera Funktion synchronisiert die Bildaufnahme auf den n chsten VSYNG kehrt aber sofort zur ck Funktion synchronisiert die Bildaufnahme auf den n chsten VSYNC und kehrt erst dann zur ck Wartezeit in 10 ms Schritten Maximal kann 327 68 Sekunden ca 5 Minuten und 20 Sekunden gewartet werden F r 1 lt Wait lt 10 wird Wait 10 gesetzt Bsp Wait 100 gt 1 sec warten 2000 2007 by IDS Imaging Development Systems GmbH 27 Benutzerhandbuch uEye Software Development Kit V2 40 4 5 is_ClearSequence Syntax INT is_ClearSequence HIDS hf Beschreibung is_ClearSequence entfernt alle mit is_AddToSequence hinzugef gten Bildspeicher aus der Sequenz Liste Nach is_ClearSequence ist kein Bildspeicher mehr aktiv gesetzt Um einen Bildspeicher als aktiven Bildspeicher zu setzen muss is_SetlmageMem aufgerufen werden bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 28 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 6 is_Convertlmage Syntax INT is_Convertlmage HIDS hf char pcSource INT nIDSource char ppcDest INT nIDDest INT reserved Beschreibung Wandelt ein RAW Bayer Bild in das gew nschte Format um Wenn als Zeiger f r das Ausgabe bild der Wert NULL bergeben wird dann wird intern ein neuer Speicher allokiert b
11. dass Microsoft das Format der lip Datei ab Version 6 0 ge ndert hat Die Funktionen zur uEye Kamerafamilie wurden mit Visual C 7 1 erstellt Somit ist das lib File uEye_api lib nur mit einem Compiler der Version 6 0 oder h her zu verwenden 2 2 Programmierung unter Visual Basic Die Funktionen des Software Development Kits sind mit der Aufrufkonvention _cdecl expor tiert Visual Basic ben tigt jedoch Funktionen mit der Konvention _stdcall Pascal Konvention Sie k nnen die uEye Funktionen direkt aus Visual Basic aufrufen wenn Sie den Pr fix is_ lt Funktionsname gt durch den Pr fix iss_ lt Funktionsnames ersetzen Alle in diesem Hand buch beschriebenen Funktionen is_ lt Funktionsname gt sind _cdecl Funktionen Zu allen diesen Funktionen existieren parallel _stdcall Funktionen iss_ lt Funktionsname gt bergabeparameter sowie R ckgabewerte sind ebenfalls identisch 2 3 CAMINFO Datenstruktur des EEPROMS Mit Hilfe der Funktion is_GetCameralnfo k nnen die in der Kamera fest hinterlegten Daten ausgelesen werden Die Datenstruktur ist 64 Byte lang und wie folgt aufgebaut Char SerNo 12 Seriennummer der Kamera Char ID 20 z B IDS GmbH Char Version 10 z B V1 00 oder nachfolgende Versionen Char Date 12 01 08 2004 Systemdatum des Endtests unsigned char Select Kamera ID unsigned char Type Kamera Typ 64 uEye USB2 0 Char Reserved 8 reserviert Tabelle 1 CAMINFO Datenstruktur des EEPROMS
12. is_FreelmageMem m_hCam pcDest nIDDest 4 7 is_CopylmageMem Syntax INT is_CopylmageMem HIDS hf char pcSource INT nID char pcDest Beschreibung is_CopylmageMem kopiert den Inhalt des durch pcSource und ol beschriebenen Bildspei chers in den Speicherbereich auf dessen Anfang pcDest zeigt Der Benutzer muss selbst daf r sorgen dass der allokierte Speicher pcDest gro genug ist um das gesamte Bild nicht nur einen Bildausschnitt im aktuellen Format Bits per Pixel zu fassen bergabeparameter hf Handle auf Kamera pcSource Zeiger auf den Bildspeicher nID ID dieses Bildspeichers pcDest Zeiger auf den Zielspeicher in den das Bild kopiert werden soll R ckgabewert IS_SUCCESS IS_NO_SUCCESS EZ FF EG FF ZZ 30 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 8 is_CopylmageMemlLines Syntax INT is_CopylmageMemlLines HIDS hf char pcSource INT nID INT nLines char pcDest Beschreibung is_CopylmageMemLines kopiert den Inhalt des durch pcSource und nID beschriebenen Bild speichers in den Speicherbereich auf dessen Anfang pcDest zeigt Es werden nLines Zeilen kopiert Der Benutzer muss selbst daf r sorgen dass der allokierte Speicher pcDest gro genug ist um die gew nschte Anzahl an Zeilen im aktuellen Format Bits per Pixel zu fassen bergabeparameter hf Handle auf Kamera pcSource Zeiger auf den Bildspeicher niD ID dies
13. 2007 by IDS Imaging Development Systems GmbH Kapitel4 Beschreibung der Funktionen 4 11 is_EnableAutoExit Syntax INT is_EnableAutoExit HIDS hf INT nMode Beschreibung is_EnableAutoExit aktiviert das automatische Schlie en des Kamera Handle nachdem eine Kamera w hrend des laufenden Betriebs entfernt wurde Beim Schlie en werden s mtliche vom SDK reservierten Speicher wieder freigegeben bergabeparameter hf Handle auf Kamera nMode IS_ENABLE_AUTO_EXIT Automatisches Schlie en aktivieren IS_DISABLE _AUTO_EXIT Automatisches Schlie en deaktivieren IS_GET_AUTO_EXIT_ENABLED Aktuelle Einstellung auslesen R ckgabewert Aktuelle Einstellung in Verbindung mit I S_GET_AUTO_EXIT_ENABLED sonst IS_SUCCESS oder IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 33 Benutzerhandbuch uEye Software Development Kit V2 40 4 12 is_EnableDDOverlay Syntax INT is_EnableDDOverlay HIDS hf Beschreibung is_EnableDDOverlay aktiviert im DirectDraw BackBuffer Modus den Live Overlay Modus Im BackBuffer Modus werden 3 nichtsichtbare Bildbuffer verwendet BackBuffer Overlay Buffer Mix Buffer Das Videobild wird in den BackBuffer digitalisiert In den Overlay Buffer k nnen die Grafikdaten geschrieben werden Der BackBuffer und der Overlay Buffer werden dann zusam men in den Mix Buffer geschrieben Dabei werden die Overlaydaten dem Videobild berlagert Der Mix Buffer wird dann in den sichtbaren Bereic
14. 80 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 67 is_Readl2C nur uEyeLE Syntax INT is_Readl2C HIDS hf INT nDeviceAddr INT nRegisterAddr BYTE pbData INT nLen Beschreibung Mit is_Readl2C k nnen Daten ber den I C Bus gelesen werden I C Bustakt betr gt 100 kHz bergabeparameter hf Handle auf Kamera nDeviceAdr Slave Adresse nRegisterAddr Register Adresse nur 8 Bit Adressen g ltig data Zu lesende Daten length Datenl nge Ung ltige Adresssen f r nRegisterAdar 0x48 0x4C 0x51 0x52 0x55 0x5C 0x5D 0x69 diese werden intern verwendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS or IS_INVALID_I2C_DEVICE_ADDRESS 4 68 is_ReleaseDC Syntax INT is_ReleaseDC HIDS hf HDC hDC Beschreibung is_ReleaseDC gibt im DirectDraw BackBuffer Modus das Device Context Handle des Overlay Buffers im DirectDraw BackBuffer Modus frei Nach Freigabe des Handles erfolgt ein Update des Overlay Buffers auf dem Bildschirm wenn mit is_ShowDDOverlay das Overlay einge blendet ist bergabeparameter hf Handle auf Kamera hDC Device Context Handle von is_GetDC R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 81 Benutzerhandbuch uEye Software Development Kit V2 40 4 69 is_RenderBitmap Syntax INT is_RenderBitmap HIDS hf INT nMemID HWND hwnd INT nMode Beschreibung Mit is_RenderBitmap kann ei
15. 97 4 83 Je Getb avertonverslon 98 4 84 EE un EE 99 4 85 i5 Een EE EE 100 4 86 Ee IT 101 KC lu TR EE 101 4 88 is_SetColorCorrection cuueenunnsannansannnennennannannnannennennannnnnnannnnnennnnnnnnnannnnnnennannannnanunnnennannannnnnnenn 102 4 89 iS eeler EE 103 e e O E e o Ai te E E ikea ee ua 104 2000 2007 by IDS Imaging Development Systems GmbH V Benutzerhandbuch uEye Software Development Kit V2 40 4 91 1S SetGonvertParam sauer Rare Blink 105 4 92 is_SetDDUpdateTime 22002n0ansnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnannnnnn 106 4 93 Is GetteplavkMode stnn stnn tt EA AE EASE EASE EASE EAA SKEAN EASE EA AEEA Annn annn ennnen nnt 107 4 94 EE E e cairgean ehe keine euch 108 4 95 je Geitdoetnbancement Ae 109 4 96 Ee e en EE 110 4 97 EE et 111 4 98 15 _SetExternal lut Le TEE 112 4 99 EE UR EE 113 4 100 iS SetFlashStrobe a u stein aaa aaa aa aaia aE D Ra EAEan 114 4 101 18 SetFr meR lte a2 Aa eaaa arana eaa E aA e aaa a denn aa aea EAEE REETA 116 Zelle EE 117 EI NOS Ce E MM EE 118 4 104 18 SetGlobalSh tter u xec Henne ana ee Naaa aE aaa Ra R 119 4 1105 18 SetH rdw areGain EE 120 4 106 Is GettlardwareGamma anene 121 4 107 is_SetHWGainractor uu0u00020000assanseenannnnnnnnnannnnnennnnnnnnennnnnnnnnnnnnnnnnannnnnannnnnnnnnannnnnannnnsnnennnnenn 122 4 108 S ee EE 124 D Cl Te Le 124 4 110 iS le E 125 4 11 1 18
16. Achse Diese Funktion ist je nach Kamera eine Hardware oder eine Software Funktion IS_GET_ROP_EFFECT Gibt die aktuelle Einstellungen zur ck param Ein Ausschalten des Rop Effekts 0 Ausschalten 1 Einschalten reserved Nicht verwendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder die aktuellen Einstellungen bei IS_SET_ROP_EFFECT 2000 2007 by IDS Imaging Development Systems GmbH 133 Benutzerhandbuch uEye Software Development Kit V2 40 4 119 is_SetSaturation Syntax INT is_SetSaturation HIDS hf INT Chrom INT ChromV Beschreibung ber is_SetSaturation kann die Software Farbs ttigung eingestellt werden Diese Funktion ar beitet nur mit dem Farbformat YUV bergabeparameter Hf Handle auf Kamera ChromU S ttigung U Wert multipliziert mit 100 Bereich IS_MIN_SATURATION IS_MAX_SATURATION IS_GET_SATURATION_U Gibt den aktuellen Wert f r die U S ttigung zur ck ChromV S ttigung V Wert multipliziert mit 100 Bereich IS_MIN_SATURATION IS_MAX_SATURATION IS_GET_SATURATION_V Gibt den aktuellen Wert f r die V S ttigung zur ck R ckgabewert IS_SUCCESS IS_LNO_SUCCESS IS_INVALID_PARAMETER ung ltiger Wert f r den Parameter ChromU oder ChromV Aktuelle Einstellung in Verbindung mit IS_GET_SATURATION_U oder IS_GET_SATURA TION_V 134 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 120 is_SetSubSampling Syntax INT is_SetSubSampli
17. EEPDROME nn 2 Tabelle 2 Farb und Gpeichertommate AA 3 Tabelle 3 Funktionsliste Initialisierung und Terminierung esssssessssressissrssrssirsssrnssrnssinssrnnsrnssrnnsrnnsrnnsrnennnnt 7 Tabelle 4 Funktionsliste Bilderfassung und Speichermanagement nn 7 Tabelle 5 Funktionsliste Auswahl der Betriebsmodi und R cklesen der Einstellungen en 9 Tabelle 6 Funktionsliste Double und Mehrfach Buffering nenn 9 Tabelle 7 Funktionsliste Lesen und Schreiben des EEDROMG 9 Tabelle 8 Funktionsliste Speichern und Laden von Bildern 2220442244004022nn0nnnnnnnnennennnnnnnnnnnnenneennnennennnnenn 9 Tabelle 9 Funktionsliste Bildausogabe nn 9 Tabelle 10 Funktionsliste Zus tzliche DirectDraw Funktionen seessessseesseesseesessirssressrntnnsrnnnnnsnnnrnnsrnnne 10 Tabelle 11 Funktionsliste Event Handling sesseseesseessesssessiresnssirsssnssrissrnsstnnttnsstnrnttnssnnnsnnnnnnnstnntennnnnnnnnn nnt 10 Tabelle 12 Funktionsliste Steuerung der Ein Ausg nge nen 12 Tabelle 13 Funktionsliste VC Funktonen nt 12 Tabelle 14 Funktionsliste Memory Handling ssssssessssesssesssssrsssrsssisssrissrnssinssrnssrnsstissrissrnnstnnntnnntnnntnnnennnenntnt 13 Tabelle 15 G ltigkeit der Funktionen nennen 21 2000 2007 by IDS Imaging Development Systems GmbH 151
18. Einstellung ist bei der aktuell eingestellten Belich tungszeit nicht m glich Die Einstellung kann nicht ge ndert werden solange die automatische Belichtungszeitregelung aktiviert ist BackBuffer Surface kann nicht angelegt werden BackBuffer Mixer Surface kann nicht angelegt werden BackBuffer Overlay Speicher kann nicht gelocked wer den BackBuffer Overlay Speicher kann nicht erzeugt werden Wird im BackBuffer Overlay Modus nicht unterst tzt BackBuffer Surface ung ltig BackBuffer Surface lost Fehler bei der Freigabe des Overlay Device Context BackBuffer Timer konnte nicht angelegt werden BackBuffer Overlay wurde nicht aktiviert Nur im BackBuffer Modus m glich Ung ltiges Farbformat 2000 2007 by IDS Imaging Development Systems GmbH 148 Anhang Service und Support Um Ihre Anfrage effektiv und schnell bearbeiten zu k nnen ben tigen wir von Ihnen die folgenden Daten per Fax 07134 96196 99 Anschrift Name Tel Fax E Mail Kameramodell O mit Geh use 0 O ohne Geh use 1 O Platinenversion 2 O Monochrom MI O Farbe C O OnBoardMemory M O Andere Seriennummer Treiberversion Kaufdatum Gekauft bei Beabsichtigter Einsatz L uft das Demoprogramm uEye Demo Oja O nein Erstinstallation Oja O nein Kamera pl tzlich ausgefallen Oja O nein Erkl rung Wurde die Kamera an einem anderen Rechner gegengepr ft Oja O nein Beschreibung des Problems
19. Funk tionen nur aus einem Thread heraus aufzurufen um ein unvorhersehbares Verhalten Ihrer Appli kation zu vermeiden e is_InitCamera e is_SetDisplayMode e is_ExitCamera bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 37 Benutzerhandbuch uEye Software Development Kit V2 40 4 16 is_ExitEvent Syntax INT is_ExitEvent HIDS hf INT which Beschreibung L schen des eingerichteten Event Objekts Nach dem L schen des jeweiligen Events kann die ses nicht mehr mit is_EnableEvent aktiviert werden bergabeparameter Siehe 4 53 is_InitEvent bergabeparameter hf Handle auf Kamera which ID welches Event initialisiert werden soll Siehe 4 53 is_InitEvent R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Siehe 4 53 is_InitEvent 38 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 17 is_ForceTrigger Syntax INT is_ForceTrigger HIDS hf Beschreibung Die Funktion is_Force Trigger erm glicht es w hrend einer Hardware Trigger Aufnahme einen Trigger zu erzwingen um so unabh ngig von einem echten Triggersignal ein Bild aufzunehmen Diese Funktion kann nur angewandt werden wenn die Triggeraufnahme mit dem Parameter IS_DONT_WAIT gestartet wurde Siehe auch 4 19 is FreezeVideo und 4 98 is SetExternalTrigger bergabeparameter hf Handle auf Kamera R
20. Gammawert multipliziert mit 100 Bereich 1 1000 IS_GET_GAMMA R cklesen der aktuellen Einstellung R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_BRIGHTNESS sonst IS_SUCCESS or IS_NO_SUCCESS Beispiel Gammawert auf 1 42 setzen ret SetGamma hf 142 118 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 104 is_SetGlobalShutter Syntax INT is_SetGlobalShutter HIDS hf INT mode Beschreibung is_SetGlobalShutter aktiviert deaktiviert den Global Start Shutter Diese Funktionnalit t wird nur von der UI 1480 C unterst tzt bergabeparameter hf Handle auf Kamera mode IS_GET_GLOBAL_SHUTTER Gibt den aktuellen Global Shutter Modus zur ck oder IS_NOT_SUPPORTED wenn die Kamera diese Funk tion nicht nterst tzt IS_SET_ GLOBAL_SHUTTER_ON Aktiviert den Global Shutter IG GEI GLOBAL_SHUTTER_OFF Deaktiviert den Global Shutter IS_GET_SUPPORTED_GLOBAL_SHUTTER Gibt IS_SET_GLOBAL_SHUTTER_ON zur ck falls diese Funktion unterst tzt wird Sonst wird IS_SET_GLOBAL_SHUTTER_OFF zur ck gegeben R ckgabewert Aktuelle Einstellung beim Aufruf mit IS_GET_GLOBAL_SHUTTER sonst IS_NOT_SUPPORTED IS_SUCCESS oder IS_NO_SUCCESS D TFT Er 2000 2007 by IDS Imaging Development Systems GmbH 119 Benutzerhandbuch uEye Software Development Kit V2 40 4 105 is_SetHardwareGain Syntax INT is_SetHardwareGain HIDS hf INT nMaster INT nRed INT nGreen INT nBl
21. Kapitel 4 Beschreibung der Funktionen 4 93 is_SetDisplayMode Syntax INT is_SetDisplayMode HIDS hf INT Mode Beschreibung is_SetDisplayMode bestimmt auf welche Art die Bilder auf dem Bildschirm dargestellt werden F r echtes Live Video plus Overlay wurde der DirectDraw Overlay Surface Modus eingef hrt Die Verf gbarkeit dieses Modus ist abh ngig von der verwendeten VGA Karte Nur bestimmte VGA Controller unterst tzen diesen Modus Der Speicherausbau der VGA Karte sollte gen gend gro sein da der Overlay Modus einen Speicherplatz bis zur Gr e der aktuellen Bildschirm Aufl sung f r sich ben tigt Im Allgemeinen ist das uEye SDK thread safe Die API Funktionsaufrufe erfolgen alle in critical sections Auf Grund interner DirectDraw Strukturen empfehlen wird dringend die folgenden Funk tionen nur aus einem Thread heraus aufzurufen um ein unvorhersehbares Verhalten Ihrer Appli kation zu vermeiden e is_InitCamera e is_SetDisplayMode e is_ExitCamera bergabeparameter hf Handle auf Kamera Mode IS_SET_DM_DIB Bild in Systemspeicher RAM erfassen keine automatische Darstellung Darstellung mit is_RenderBitmap m glich IS_SET_DM_DIRECTDRAW DirectDraw BackBuffer Modus IS_SET_DM_BACKBUFFER IS_SET_DM_DIRECTDRAW DirectDraw Overlay Surface Modus IS_SET_DM_ALLOW_OVERLAY DirectDraw Overlay Surface Erweite rung IS_SET_DM_ALLOW_SCALING Echtzeit Skalierung im Overlay Surface Modus R cklesemodus I
22. Mode 1 Blacklevel Offset 0 2000 2007 by IDS Imaging Development Systems GmbH 73 Benutzerhandbuch uEye Software Development Kit V2 40 Gain Master 0 Red 0 Green 0 Blue 0 Processing EdgeEnhancement 0 RopEffect 0 Whitebalance 0 Whitebalance Red 1 000000 Whitebalance Green 1 000000 Whitebalance Blue 1 000000 Color correction 0 Auto features Auto Framerate control 0 Brightness exposure control 0 Brightness gain control 0 Brightness reference 128 Brightness speed 50 Brightness max gain 1 000000 Brightness max exposure 1 000000 Brightness Aoi Left 0 Brightness Aoi Top 0 Brightness Aoi Width 1280 Brightness Aoi Height 1024 Auto WB control 0 Auto WB offsetR 0 Auto WB offsetB 0 Auto WB gainMin 0 Auto WB gainMax 100 Auto WB speed 50 Auto WB Aoi Left 0 Auto WB Aoi Top 0 Auto WB Aoi Width 1280 Auto WB Aoi Height 1024 Auto WB Once 0 SEENEN 74 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 61 is_LockDDMem Syntax INT is_LockDDMem HIDS hf void ppMem INT pPitch Beschreibung is_LockDDMem gibt den Zugriff auf den Bildspeicher in den DirectDraw Modi frei und liefert den Adresszeiger auf den Anfang des Bildspeichers zur ck Der Bildspeicher befindet sich in den meisten F llen auf der VGA Karte Mit dem Zeiger kann direkt auf den Bildspeicher zuge griffen werden Der Zugriff muss sobald als m glich mit der Funktion is_UnlockDDMem aufge
23. R ckgabewert IS_SUCCESS IS_NO_SUCCESS 76 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 63 is_LockSegqBuf Syntax INT is_LockSegBuf HIDS hf INT nNum char pcMem Beschreibung Mit is_LockSegBuf kann ein Bildspeicher vor dem berschreiben mit neuen Bilddaten ge sperrt werden d h dieser Bildspeicher wird in der Sequenzliste der zu verwendenden Bildspei cher ausgeklammert Damit kann verhindert werden dass Bilddaten die noch zur weiteren Verarbeitung ben tigt werden durch neue Daten berschrieben werden Auf den Bildspeicher kann weiterhin voll zugegriffen werden Es kann immer nur ein Bildspeicher gleichzeitig gesperrt sein Zum Freigeben dient die Funk tion is_UnlockSegBuf bergabeparameter hf Handle auf Kamera nNum Nummer des Bildspeichers der gesch tzt werden soll 1 max pcMem Startadresse des Bildspeichers der gesch tzt werden soll nNum bezeichnet die Position in der Sequenzliste und nicht die mit is_AllocImageMem vergebe ne Speicher ID R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 77 Benutzerhandbuch uEye Software Development Kit V2 40 4 64 is_MemoryFreezeVideo Syntax INT is_MemoryFreezeVideo HIDS hf INT nMemID INT Wait Beschreibung Mit der Funktion is_MemoryFreezeVideo kann mit einem einzigen Befehl ein Einzelbild ber das Memoryboard aufgenommen werden Dabei
24. SellmagePoS E 126 4 112 Elle EE 128 4 113 is_SetlO nur Ul 1543 M 2202200nssnnsensnennnnnnennnnnnnnnnnnennnnnnnnnnnnennnennnnnnnnnnnnnnnnnnnnnnnnnnnnennnnn 129 NEE ET 129 4 115 15 Set ED E 130 4 116 ERT le EE 131 AMT ZIISZDEtBIXelGlOCK zer EE 132 4 118 ele EC EE 133 4119 15 SetSaturatiOr EE 134 4 120 15 SelSuUbSampliNg DEE 135 AACHEN 136 4 122 gelen RTE EE 137 1223 Genhitebalance nenne 138 4 124 Is GeiWhttebalancekuftplers 139 AE Ee Or AIR le ET EE 139 4 126 18 StealVideo EE 140 4 127 Rtl e e E 141 4 128 18 _Transferlmage siminer a iaraa aa nennen aaia anaidia eaaa heran ern anaa 142 4 129 Is TroansterMemorveouence 143 vi 2000 2007 by IDS Imaging Development Systems GmbH 4 130 is Unl ckDDMem u ne ana anhalten 144 4 131 is__UnlockDDOverlayMem ssssesssessseesnesensssnessssssnssessrsnsrenssinssnnstnenstenstnnttenstenntnnntnnntnnntnnntnnntnn nnt 144 4 132 Is Unlockf eobut 145 4 183 18 JpdateDisplay za ehe ee ia ee lach 145 413415 Write EEPROM 5222ER EES NEESS 146 4 135 is_Writel2C nur UEyeLE sinisen oninia aaa aaa ia aaa a aai a iaaa 146 o Fehlermeld NgeN eege ee eege EEGEN 147 SEFVICE Tu ENT e Uu en eana aa ne aer aaa eea aasa aaa Aeae aaea asan aaaea 149 Abbildungsverzeichnis 224000040000n0nan0nannnnnnnnnnnnnnnnnnnnnnannnnnannnnnnnnnnnnnnnnnnnnnnnennannnnnannnnnnnnnnnnnnnnnnnnannnnn nenn 151 Tabellenverzeichnis 2 0 u0 2 20u02 a a a a aan nn 151
25. adjust 4 rest line 4 wenn line nicht ohne Rest durch 4 teilbar ist Der Zeileninkrement kann mit der Funktion is_GetimglMemPitch ausgelesen werden Die Anfangsadresse des Speicherbereichs wird in ppcImgMem zur ckgegeben pid enth lt eine Identifikationsnummer des allokierten Speichers Ein neu allokierter Speicher ist nicht direkt aktiv d h Bilder werden nicht direkt in diesen neuen Speicher digitalisiert Er muss zuerst mit is_SetlmageMem aktiv gesetzt werden Der zur ckgegebene Zeiger muss gesichert werden und darf nicht ver ndert werden da dieser f r alle weiteren ImageMem Funktionen ben tigt wird Die Freigabe des Speichers erfolgt mit is_FreelmageMem In den DirectDraw Modi ist das Allokieren eines Bildspeichers nicht notwendig Aktuelle Betriebssysteme lagern einzelne l nger nicht benutzte Bereiche des Arbeits speichers auf die langsamere Festplatte aus falls der freie physische Arbeitsspeicher knapp wird Daher kann sich die Bildaufnahme insgesamt verlangsamen falls mehr Bildspeicher reserviert wurde als gleichzeitig im Arbeitsspeicher vorgehalten werden kann bergabeparameter hf Handle auf Kamera width Breite des Bildes height H he des Bildes bitspixel Farbtiefe des Bildes Bits pro Pixel ppcimgMem Enth lt dann den Zeiger auf den Speicheranfang pid Enth lt dann die ID f r diesen Speicher R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 25
26. ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Trigger aktivieren und 1 sec auf externen Trigger warten Wurde kein Trigger ausgel st Auf nahme mit is_ForceTrigger erzwingen HANDLE hEvent CreateEvent NULL TRUE FALSE if hEvent NULL is_InitEvent hf m_hEvent IS_SET_EVENT_FRAME is_EnableEvent hf IS_SET_EVENT_FRAME is_SetExternalTrigger hf IS_SET_TRIG_HI_LO is_FreezeVideo hf IS_DONT_WAIT if WaitForSingleObject m_hEvent 1000 WAIT_OBJECT_O Noch kein Trigger empfangen also Bildaufnahme erzwingen is_ForceTrigger hf is_DisableEvent hf IS_SET_EVENT_FRAME is_ExitEvent hf IS_SET_EVENT_FRAME 2000 2007 by IDS Imaging Development Systems GmbH 39 Benutzerhandbuch uEye Software Development Kit V2 40 4 18 is_FreelmageMem Syntax INT is_FreelmageMem HIDS hf char pclmgMem INT id Beschreibung is_FreelmageMem gibt einen allokierten Bildspeicher wieder frei F r ocImgMem muss ein von is_AllocImgMem stammender Zeiger bergeben werden Alle anderen Zeiger f hren zu einer Fehlermeldung Eine wiederholte bergabe des gleichen Zeigers f hrt ebenfalls zu einer Feh lermeldung bergabeparameter hf Handle auf Kamera pclmgMem Zeiger auf den Speicheranfang id ID f r diesen Speicher R ckgabewert IS_SUCCESS IS_NO_SUCCESS 40 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreib
27. den minimalen Gainwert gesetzt und umgekehrt Falls nur einer der Parameter pvalT pval2 bergeben werden soll dann ist f r den jeweils ande ren Parameter ein NULL Zeiger zu bergeben Wenn die Einstellungen zur ckgegeben werden sollen dann werden die Werte an die mit pval1 und pval2 angegeben Adresse geschrieben Vordefinierte Werte f r Auto Features Werte aus uEye h ersichtlich IS_DEFAULT_AUTO_BRIGHT_REFERENCE Default Sollwert f r AutoGain und AutoShutter IS_MIN_AUTO_BRIGHT_REFERENCE Minmaler Sollwert f r AutoGain und AutoShutter IS_MAX_AUTO_BRIGHT_REFERENCE Maximaler Sollwert f r AutoGain und AutoShutter IS_DEFAULT_AUTO_SPEED Defaultwert f r Auto Geschwindigkeit IS_MIN_AUTO_SPEED Minimaler Wert f r Auto Geschwindigkeit IS_MAX_AUTO_SPEED Maximaler Wert f r Auto Geschwindigkeit IS_DEFAULT_WB_OFFSET Defaultwert f r Auto Whitebalance Offset IS_MIN_WB_OFFSET Minimaler Wert f r Auto Whitebalance Offset IS_MAX_WB_OFFSET Maximaler Wert f r Auto Whitebalance Offset IS_DEFAULT_AUTO_WB_SPEED Defaultwert f r Auto Whitebalance Geschwindigkeit IS_MIN_AUTO_WB_SPEED Minimaler Wert f r Auto Whitebalance Geschwindigkeit IS_MAX_AUTO_WB_SPEED Maximaler Wert f r Auto Whitebalance Geschwindig keit Weitere M glichkeiten die AutoBrightness Funktionen zu aktivieren deaktivieren Die AutoGain Funtktionalit t kann mit der Funktion is_SetHardwareGain aktiviert werden wenn der Parameter IS_SET_ENABLE_AUTO_GAIN anstatt des er
28. die Position in der Sequenzliste und nicht die mit is_AlloclmageMem vergebe ne Speicher ID R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 133 is_UpdateDisplay Syntax INT is_UpdateDisplay HIDS hf Beschreibung is_UpdateDisplay aktualisiert manuell die Bildschirmausgabe in den DirectDraw Modi Die Ak tualisierung erfolgt normalerweise automatisch durch den Treiber Es kann in wenigen F llen notwendig werden die Bildschirmausgabe manuell auf ge nderte Gegebenheiten anzupassen Siehe auch Funktion 4 93 is_SetDisplayMode bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 145 Benutzerhandbuch uEye Software Development Kit V2 40 4 134 is_WriteEEPROM Syntax INT is_WriteEEPROM HIDS hf INT Adr char pcString INT Count Beschreibung Auf der uEye befindet sich ein EEPROM als kleiner Speicher Neben den fest auf der Karte hin terlegten Informationen k nnen 64 Byte eigene Daten in das EEPROM geschrieben werden Mit der Funktion is_ReadEEPROM kann der Inhalt dieses 64 Byte Blockes gelesen werden bergabeparameter hf Handle auf Kamera Adr Anfangsadresse ab der Daten geschrieben werden sollen 0 63 pcString Zeichenkette die eigene Daten enth lt Count Anzahl zu schreibender Zeichen 1 64 R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 135 is_Writel2C nur uEyeLE Syntax INT is_Writel2C HIDS hf INT n
29. die momentan verwendeten Faktoren des Wei abgleichs zur ck die entweder zuvor mit is_SetWhiteBalanceMultipliers gesetzt oder ber den automatischen Wei abgleich berechnet wurden bergabeparameter hf Handle auf Kamera pdblIRed Faktor f r Rotkanal pdbIGreen Faktor f r Gr nkanal pdbIBlue Faktor f r Blaukanal R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 65 Benutzerhandbuch uEye Software Development Kit V2 40 4 50 is_HasVideoStarted Syntax INT is_HasVideoStarted HIDS hf BOOL pbo Beschreibung Mit is_HasVideoStarted kann berpr ft werden ob die Digitalisierung des Bildes gestartet wurde Diese Funktion ist im Zusammenhang mit is_FreezeVideo mit dem Parameter IS_DONT_WAIT sinnvoll bergabeparameter hf Handle auf Kamera pbo Enth lt dann den Digitalisierstatus 0 Bildaufnahme noch nicht gestartet 1 Bildaufnahme gestartet R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 51 is_HideDDOverlay Syntax INT is_HideDDOverlay HIDS hf Beschreibung is_HideDDOverlay blendet das Overlay im DirectDraw BackBuffer Modus aus Es wird dann nur noch der Bildbuffer dargestellt so dass die Bildwiederholrate h her ist als mit eingeblende tem Overlay Durch das Ausblenden des Overlays gehen die Overlaydaten nicht verloren bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 66 2000 2007 by IDS Imaging Developmen
30. i p SetExternalTrigger N Be N S WS N E i SetMemoryMode FreezeVideo E IT L p SetExternalTrigger ag Pas timeout J SC Ready ki Save Image to Memory no i assign SequencelD N ER assign Imagelndex n fe x N i Image n 1 N yes no e N yes increment Imagelndex n Trigger N lt Timeout save Image at position Image n 2 N d N O e n N Image n N N S 3 d i S Fa R S K p Y g i SN S nm N Wo oA A yes o no Timeout N Wait dt E nN N p lt Timeout p SUCCESS go a er A J j d Ki Ee 2 vi NG yes yes NO SUCCESS 4 Pi Abb 9 Post Trigger Modus Mehrere Sequenzen Es ist durchaus m glich mehrere Sequenzen aufzunehmen ohne die aufgenommenen Bilder zwischen zwei Sequenzen aus dem Kameraspeicher auslesen zu m ssen F r ltere Sequenzen kann allerdings nicht garantiert werden dass diese noch im Kameraspei cher pr sent sind Eine neue Sequenz speichert ihre Bilder vornehmlich in freiem Kameraspeicher Ist nicht aus reichend freier Speicher vorhanden so werden zumindest Teile alter Sequenzen berschrie ben Von einer alten Sequenz sind also eventuell nur noch einige Bilder g ltig Die Funktion is_ Transferlmage erwartet als Parameter die Sequenz Id einer g ltigen Sequenz und die Nummer des zu bertragenden Bildes innerhalb dieser Sequenz Ist das Bild oder die gesamte Sequenz inzwischen ung ltig gibt die Funktion einen entsprechenden Fe
31. int Mode ULONG StealColorMode Beschreibung Setzt den Steal Modus Es gibt zwei unterschiedliche Steal Modi e normal steal Mit dieser Option wird ein einzelnes Bildes aus einem DirectDraw Livestream in den aktuell aktiven Benutzerspeicher umgeleitet e copy steal Hier wird die Abbildung mit DirectDraw angezeigt und in den aktuell aktiven Bildspeicher ko piert bergabeparameter Hf Mode IS_SET_STEAL_NORMAL IS_SET_STEAL_COPY StealColorMode R ckgabewert IS_SUCCESS IS_NO_SUCCESS Handle auf Kamera Normal Modus Copy Modus reserviert TFT TFT 2000 2007 by IDS Imaging Development Systems GmbH 79 Benutzerhandbuch uEye Software Development Kit V2 40 4 66 is_ReadEEPROM Syntax INT is_ReadEEPROM HIDS hf INT Adr char pcString INT Count Beschreibung In der Kamera befindet sich ein EEPROM als kleiner Speicher Neben den fest von IDS hinter legten Informationen k nnen 64 Bytes eigene Daten in das EEPROM geschrieben werden Mit der Funktion is_ReadEEPROM kann der Inhalt dieses 64 Byte Blockes gelesen werden Sie he auch 4 134 is_WriteEEPROM bergabeparameter hf Handle auf Kamera Adr Anfangsadresse ab der Daten gelesen werden soll Wertebe reich 0 63 pcString Buffer f r die zu lesenden Daten min Gr e Count Count Anzahl zu lesender Zeichen R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel char buffer 64 is_ReadEEPROM m_hCam 0x00 buffer 64
32. is_CameraStatus Syntax Benutzerhandbuch uEye Software Development Kit V2 40 ULONG is_CameraStatus HIDS hf INT ninfo ULONG ulValue Beschreibung Mit is_CameraStatus k nnen verschiedene Statusinformationen und Einstellungen abgefragt und teilweise gesetzt werden bergabeparameter hf ninfo IS_FIFO_OVR_CNT IS_SEQUENCE_CNT IS_SEQUENCE_SIZE IS_EXT_TRIGGER_EVENT_CNT IS_WAIT_TIMEOUT IS_TRIGGER_MISSED IS_LAST_CAPTURE_ERROR ulValue IS_GET_STATUS Handle auf Kamera Anzahl FIFO Overruns Wird erh ht wenn Bilddaten bedingt durch einen berlasteten USB2 0 Bus verloren gehen Wird bei is_CaptureVideo auf 0 gesetzt Bei jedem Wechsel des Sequenz Buffers Bildz hler erfolgt die Erh hung um 1 Anzahl Sequenz Buffer nur lesen Trigger Interrupt Z hler Timeout f r HW Trigger bei Verwendung von S_WAIT oder IS_DONT_WAIT 1ms Schritte Anzahl der nicht verarbeiteten Triggersignale Wird nach je dem Aufruf auf 0 gesetzt Fehler beim Bildeinzug nur lesen Auslesen der unter ninfo angegebenen Information R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder der aktuelle Wert bei ulValue IS_GET_STATUS Nach Eintreten des Events IS_SET_TRANSFER_FAILED oder der Nachricht IS_TRANSFER_FAILED kann mit IS_LASTCAPTURE_ERROR der aufgetretene Fehler ausge lesen werden Folgende R ckgabewerte sind m glich e IS_SUCCESS e IS_TRANSFER_ERROR Bildeinzug wurde abgebrochen e IS_TIMED_OUT Die max zul ssige Z
33. ter Wert f r die horizontale ACL Position Schrittweite f r die horizontale AOI Position R cklesen ob die Y Position f r den aktuellen Speicher ber nommen wurde Position absolut auch f r Speicher bernehmen Kleinster Wert f r die vertikale ACL Position Gr ter Wert f r die vertikale AOI Position Schrittweite f r die vertikale AOQI Position Vertikale Position 2000 2007 by IDS Imaging Development Systems GmbH 127 Benutzerhandbuch uEye Software Development Kit V2 40 4 112 is_SetlmageSize Syntax INT is_SetlmageSize HIDS hf INT x INT y Beschreibung is_SetimageSize bestimmt in Verbindung mit den Einstellungen durch is_SetimagePos die Bildgr e Die nachfolgend dargestellte Reihenfolge der Funktionsaufrufe ist zwingend erforderlich 1 is_SetlmageSize 2 is_SetlmagePos Die Funktion is_SetAOl siehe 4 79 is_SetAON vereint die beiden Funktionen Mit is_SetAOl k nnen die Position und die Gr e eines AOI mit einem Funktionsaufruf gesetzt werden Randbedingungen Siehe 4 79 is_SetAOl bergabeparameter hf Handle auf Kamera x 1 xMax Bildbreite IG GET IMAGE GLZE X R cklesen der aktuellen Bildbreite IS_GET_IMAGE_SIZE_X_MIN Kleinster Wert f r die AOI Bildbreite IS_GET_IMAGE_SIZE_X_MAX Gr ter Wert f r die AOI Bildbreite IS_GET_IMAGE_SIZE_X_ING Schrittweite f r de AOI Bildbreite IS_GET_IMAGE_SIZE_Y R cklesen der aktuellen Bildh he IS_GET_IMAGE_SIZE
34. werden bergabeparameter hf Handle auf Kamera oder NULL Mode IS_DISABLE_ERR_REP Ausschalten der Fehleranzeige IS_ENABLE_ERR_REP Einschalten der Fehleranzeige R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_ERR_REP_MODE sonst IS_SUCCESS IS_NO_SUCCESS 110 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 97 is_SetExposureTime Syntax INT is_SetExposureTime HIDS hf double EXP double newEXP Beschreibung Die Funktion is_SetExposure Time setzt die mit EXP angegebene Belichtungsdauer in ms Da diese aber nur in Vielfachen einer Zeilendauer einstellbar ist kann die tats chlich verwendete Zeit von dem gew nschten Wert abweichen Die tats chlich nach Aufruf dieser Funktion einge stellte Dauer wird ber den Parameter newEXP zur ckgegeben Durch ndern der Fenster gr e oder des Auslesetimings Pixelclock wird die zuvor gesetzte Exposure Zeit ebenfalls ver ndert deshalb muss is_SetExposureTime danach neu aufgerufen werden Exposure Zeit beeinflussende Funktionen is_SetlmageSize is_SetPixelClock is_SetFrameRate Nur wenn neue Bilddauer k rzer als Exposure Zeit wird Welche minimalen und maximalen Werte m glich sind und die Abh ngigkeiten der einzelnen Sensoren wird in der Beschreibung zum uEye Timing ausf hrlich behandelt Je nach Zeitpunkt der nderung der Belichtungszeit wirkt sich diese erst bei der Aufnahme des n chsten Bildes aus
35. zur ck Ist Bildaufnahme gestartet Gibt Eigenschaften eines Bildspeichers zur ck Ist Bildaufnahme beendet Bildspeicher als Bitmap speichern Anwender stellt Speicherbereich zur Bilderfassung bereit W hlt Bayer Algorithmus aus Einen Bildspeicher als aktiv setzen Aktiviert Testbilder Beednet die Aufnahme kontinuierlich oder Einzelbild Tabelle 4 Funktionsliste Bilderfassung und Speichermanagement 2000 2007 by IDS Imaging Development Systems GmbH Benutzerhandbuch uEye Software Development Kit V2 40 3 3 Auswahl der Betriebsmodi und R cklesen der Einstellungen Funktionsliste is_CameraStatus is_GetAutolnfo is_GetCameralist is_GetCameraType is_GetColorDepth is_GetDLLVersion is_GetError is_GetExposureRange is_GetFramesPerSecond is_GetFrameTimeRange is_GetNumberOfCameras is_GetOsVersion is_GetPixelClockRange is_GetUsedBandwidth is_GetVsyncCount is_GetWhiteBalanceMultipliers is_LoadBadPixelCorrectionTable is_PrepareStealVideo is_ResetToDefault is_SaveBadPixelCorrectionTable is_SetAOlI is_SetAutoParameter is_SetBadPixelCorrection is_SetBadPixelCorrectionTable is_SetBinning is_SetBlCompensation is_SetBrightness is_SetColorCorrection is_SetColorMode is_SetContrast is_SetConvertParam is_SetDisplayMode is_SetEdgeEnhancement is_SetErrorReport is_SetExposureTime is_SetFrameRate is_SetGainBoost is_SetGamma is_SetGlobalShutter is_SetHardwareGain is_SetHardwareGamma is_SetHWGainFactor is_SetHwnd is_Setlma
36. 2 2000 2007 by IDS Imaging Development Systems GmbH Kapitel2 Programmierung EE 2 4 Farb und Speicherformate Die von der uEye Kamera unterst tzten Farbformate bewirken unterschiedliche Speicherfor mate Aus der nachfolgenden Tabelle entnehmen Sie die Reihenfolge der Anordnung im Spei cher Pixel Data Format Byte 3 Bit 31 24 Byte 2 Bit 23 16 Byte 1 Bit 15 8 Byte 0 Bit 7 0 Tabelle 2 Farb und Speicherformate Cokams en 1 Abb 1 Prinzipieller Aufbau des Bayer Pattern Bei den Datenformaten RGB16 und RGB15 werden von den internen 8 Bit R G und B Farben die jeweils oberen Bits verwendet 2000 2007 by IDS Imaging Development Systems GmbH 3 Benutzerhandbuch uEye Software Development Kit V2 40 2 5 Bildausgabemodi Bitmap Modus BMP DIB Nach dem Starten des Demoprogramms uEye Demo welches im n chsten Kapitel beschrieben wird zun chst der Bitmap Modus aktiv Hier wird das ber die uEye USB2 0 Kamera eingelese ne Bild in den Hauptspeicher des PCs geschrieben Die Bildausgabe muss der Anwender selbst handhaben in dem unter Programmkontrolle und unter Belastung der CPU das Bild in ein Bit map gewandelt und in die VGA Karte kopiert wird Der gro e Vorteil dieses Modus ist die Kom patibilit t zu allen VGA Karten und der M glichkeit des Zugriffs auf die Bilddaten im Speicher Overlay Funktionen m ssen vom Anwender programmiert werden Da Windows die Steuerung der B
37. 4 53 is_InitEvent Handle auf Kamera Event Handle von der C C Funktion CreateEvent ID welches Event initialisiert werden soll 2000 2007 by IDS Imaging Development Systems GmbH 35 is_EnableMessage Syntax Benutzerhandbuch uEye Software Development Kit V2 40 INT is_EnableMessage HIDS hf INT which HWND hWnd Beschreibung Mit is_EnableMessage k nnen Nachrichten aktiviert oder deaktiviert hWnd NULL werden die beim Eintreten eines bestimmten Ereignisses an das Anwenderprogramm gesendet werden Die Nachricht ist wie folgt aufgebaut IS_UEYE_MESSAGE Eingetroffenes Ereignis siehe Tabelle zur Message geh render Kamera Handle Msg wParam IParam bergabeparameter hf which IS_FRAME IS_SEQUENCE IS_STEAL_VIDEO IS_TRANSFER_FAILED IS_TRIGGER IS_MEMORY_MODE_FINISH IS_DEVICE_REMOVED IS_DEVICE_RECONNECTED IS_NEW_DEVICE IS_DEVICE_REMOVAL IS_WB_FINISHED IS_AUTOBRIGHTNESS_FINISHED hWnd R ckgabewert Handle auf Kamera ID der Meldung die aktiviert deaktiviert werden soll Ein neues Bild steht zur Verf gung Die Sequenz wurde durchlaufen Ein dem Overlay entzogenes Bild steht zur Verf gung Beim Datentransfer trat ein Fehler auf zu hohe Framerate Pixelclock Ein Bild dessen Aufnahme durch einen Trigger ausgel st wurde wurde komplett empfangen Dies ist der fr hest m glicher Zeitpunkt f r eine neue Aufnahme Das Bild muss noch das Postpro cessing des Treibers durch
38. 777215 bergabeparameter hf Handle auf Kamera r Rot Anteil der Keying Farbe 0 255 IS_GET_KC_RED gibt den Rot Anteil zur ck IS_GET_KC_GREEN gibt den Gr n Anteil zur ck IS_GET_KC_BLUE gibt den Blau Anteil zur ck IS_GET_KC_RGB gibt das RGB Tripple zur ck g Gr n Anteil der Keying Farbe 0 255 b Blau Anteil der Keying Farbe 0 255 R ckgabewert Farbwert in Verbindung mit IS_GET_KC_RGB IS_GET_KC_RED IS_GET_KC_GREEN IS_GET_KC_BLUE sonst IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 129 Benutzerhandbuch uEye Software Development Kit V2 40 4 115 is_SetLED Syntax INT is_SetLED HIDS hf INT nValue Beschreibung Mit is_SetKeyColor wird die LED auf der Geh user ckseite der Kamera ein ausgeschaltet bergabeparameter hf Handle auf Kamera nValue IS_SET_LED_OFF Schaltet LED aus IS_SET_LED_ON Schaltet LED an IS_SET_LED_TOGGLE Zwischen AN und AUS umschalten R ckgabewert IS_SUCCESS IS_NO_SUCCESS 130 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 116 is_SetMemoryMode Syntax INT is_SetMemoryMode HIDS hf INT nCount INT nDelay Beschreibung Mit der Funktion is_SetMemoryMode wird die Bildaufnahme ber das optionale Memoryboard aktiviert Als Parameter wird die Anzahl der Bilder die in den Speicher aufgenommen werden sollen bergeben Bei Verwendung des Pre Trigger Modus gibt dieser Parameter d
39. ARAMETER unbekannter Parameter ColorMode Beispiel RGB Testbild erzeugen char pcSource INT nIDSource is_AllocImageMem hf 256 256 24 amp pcSource amp nlIDSource Int nX nY nBits nPitch is_InquirelmageMem hf pcSource nIDSource amp nX amp nY amp nBits amp nPitch for int j 0 j lt nY j t for int i 0 i lt nX 3 i 3 pcSource li j nPitch 0 Blue pixels i 3 Green pixels 255 Red pixels pceSource li j nPitch 1 pceSource li j nPitch 2 memory for the rgb histogram DWORD bgrBuffer 256 3 Assign a pointer to each color histogram DWORD pBlueHisto bgrBuffer DWORD pGreenHisto bgrBuffer 256 DWORD pRedHisto bgrBuffer 512 is_GetlImageHistogram hf nIDSource IS_SET_CM_RGB24 bgrBuffer is_FreelmageMem hf pcSource nIDSource anna u E 56 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 37 is_GetlmageMem Syntax INT is_GetlmageMem HIDS hf VOID pMem Beschreibung is_GetlmageMem gibt den Zeiger auf den Anfang des aktiven Bildspeichers zur ck Im Di rectDraw Modus wird der Zeiger auf den BackBuffer bzw der Zeiger auf den sichtbaren Bereich DirectDraw Primary Surface Modus zur ckgegeben Im DirectDraw Primary Modus ver ndert sich der Adresszeiger wenn das Ausgabefenster ver schoben wird siehe auch 4 61 is LockDDMem Wenn mit Ringbuffering gearbeitet wird 4 1 is AddToSe
40. B IS_SET_CM_RGB16 Hi Color Modus 5R 6G 5B IS_SET_CM_RGB15 Hi Color Modus 5R 5G 5B IS_SET_CM_Y8 8 Bit Monochrombilder IS_SET_CM_BAYER Roh Bayerdaten bei Farb Sensoren IS_SET_CM_UYVY 16 Bit UYVY Format IS_GET_COLOR_MODE R cklesen der aktuellen Einstellung R ckgabewert Aktuelle Einstellung in Verbindung mit S_GET_COLOR_MODE sonst IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 103 Benutzerhandbuch uEye Software Development Kit V2 40 4 90 is_SetContrast Syntax INT is_SetContrast HIDS hf INT Cont Beschreibung is_SetContrast ver ndert digital den Kontrast des Bildes Verst rkung der Luminanz im Be reich zwischen 0 und 200 bergabeparameter hf Handle auf Kamera Cont 0 511 zu setzender Kontrastwert IS_GET_CONTRAST R cklesen der aktuellen Einstellung R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_CONTRAST sonst IS_SUCCESS IS_NO_SUCCESS 104 2000 2007 by IDS Imaging Development Systems GmbH 4 91 is_SetConvertParam Syntax Kapitel 4 Beschreibung der Funktionen INT is_SetConvertParam HIDS hf BOOL ColorCorrection INT BayerConversionMode INT Co lorMode INT Gamma double WhiteBalanceMultipliers Beschreibung is_SetConvertParam stellt die Konvertierungsparameter f r das RAW Bayer Bild ein welches mit der Funktion is_Convertlmage in ein anderes Format umgewandelt wird Diese Funktion setzt die Werte f r e Farbkorrektur e Baye
41. Benutzerhandbuch uEye Software Development Kit SDK uEye USB 2 0 Kameras Version 2 40 Stand M rz 2007 2007 IDS Imaging Development Systems GmbH Alle Rechte vorbehalten IDOS Imaging Development Systems Dimbacher Stra e 6 D 74182 Obersulm Fax 49 0 7134 96196 99 eMail sales ids imaging de Vorwort Die IDS Imaging Development Systems GmbH hat dieses Handbuch mit aller Sorgfalt erstellt Es kann jedoch keine Garantie in Bezug auf Inhalt Vollst ndigkeit und Qualit t der Angaben in diesem Handbuch bernommen werden Der Inhalt dieses Handbuches wird gepflegt und den aktuellen Gegebenheiten angepasst Weiterhin k nnen wir nicht gew hren dass selbst unter Einhaltung der Spezifikationen dieses Produkt st rungsfrei arbeitet In keinem Falle k nnen wir eine Gew hr daf r bernehmen dass mit dem Erwerb dieses Pro duktes ein bestimmtes Anwendunggsziel erreicht werden kann Im Rahmen der gesetzlichen M glichkeiten ist die Haftung f r unmittelbare Sch den Folge sch den und Drittsch den die aus dem Erwerb dieses Produktes resultieren ausgeschlossen Die Haftung ist in jedem Falle auf den Produktpreis beschr nkt Alle Rechte vorbehalten Das vorliegende Handbuch darf auch auszugsweise nicht ohne die schriftliche Genehmigung der IDS Imaging Development Systems GmbH reproduziert bertra gen oder in eine andere Sprache bersetzt werden Stand M rz 2007 FT TFT rl 2000 2007 by IDS Imaging D
42. Bilddarstellung gezeigt 2000 2007 by IDS Imaging Development Systems GmbH 23 Benutzerhandbuch uEye Software Development Kit V2 40 4 1 is_AddToSequence Syntax INT is_AddToSequence HIDS hf char pcImgMem INT nID Beschreibung is_AddToSequence f gt einen Bildspeicher in die Liste der Bildspeicher ein die f r Ringbuffe ring verwendet werden Der Bildspeicher muss zuvor mit is_AlloclmageMem angefordert wor den sein Bildspeicher die f r das Ringbuffering verwendet werden m ssen f r dieselbe Farb tiefe Bits per Pixel allokiert worden sein Die Anzahl der Bildspeicher f r eine Sequenz nID ist auf den Integer Wertebereich begrenzt bergabeparameter hf Handle auf Kamera pcMem Zeiger auf Bildspeicher niD ID des Bildspeichers R ckgabewert IS_SUCCESS IS_NO_SUCCESS 24 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 2 is_AlloclmageMem Syntax INT is_AlloclmageMem HIDS hf INT width INT height INT bitspixel char ppcImgMem INT pid Beschreibung is_AlloclmageMem allokiert einen Bildspeicher f r ein Bild der Breite width der H he height und der Farbtiefe bitspixel Die Speichergr e ist mindestens size width bitspixel 1 8 adjust height adjust siehe unten Der Zeileninkrement berechnet sich zu line width bitspixel 1 8 lineinc line adjust adjust 0 wenn line ohne Rest durch 4 teilbar ist
43. Bildspeicher als aktiven Speicher Nur ein aktiver Bildspeicher kann Bilddaten empfangen Nach is_SetImageMem muss ein is_SetlmageSize folgen um die Bildgegebenheiten auf den neu aktivierten Speicher zu bertragen F r pclmg Mem muss ein von is_AllocimgMem stammender Zeiger bergeben werden Alle anderen Zeiger f hren zu einer Fehlermeldung Eine wiederholte bergabe desselben Zei gers ist erlaubt In den DirectDraw Modi ist das Setzen eines Bildspeichers nicht erforderlich bergabeparameter hf Handle auf Kamera pclmgMem Zeiger auf den Speicheranfang id ID f r diesen Speicher R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 125 Benutzerhandbuch uEye Software Development Kit V2 40 4 111 is_SetlmagePos Syntax INT is_SetlmagePos HIDS hf INT x INT y Beschreibung is_SetlmagePos bestimmt den Startpunkt des Fensters In Verbindung mit der Funktion is_SetimageSize kann aus dem vollen Videobild ein Ausschnitt herausgeschnitten werden Dabei ist die nachfolgend dargestellte Reihenfolge der Funktionsaufrufe zwingend erforderlich 1 is_SetlmageSize 2 is_SetlmagePos Die Funktion is_SetAOl siehe 4 79 is_SetAON vereint die beiden Funktionen Mit is_SetAOl k nnen die Position und die Gr e eines AOI mit einem Funktionsaufruf gesetzt werden Die Parameter x und y stellen einen Offset in Bezug auf die linke obere Ecke des Bildes dar Das ausgeschnit
44. Brightness AOI setzen Int nRet SetAOI m_hCam Kamera Handle IS_SET_AUTO_BRIGHT_AOI AOI Typ Kommando amp XPOS amp ypos amp width amp height 92 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 80 is_SetAutoParameter Syntax INT is_SetAutoParameter HIDS hf INT param double pval1 double pval2 Beschreibung is_SetAutoParameter steuert die Gain Shutter Framerate und Whitebalance Autofunktionen Das Ziel der Auto Funktionen ist es das Kamerabild in seiner mittleren Helligkeit und Farbwie dergabe auf den vorgegebenen Sollwert zu regeln und dabei die Bildwiederholrate Framerate auf einem maximalen Wert zu halten Bei der Regelung der mittleren Helligkeit wird die Exposu re Regelung bevorzugt D h es wird erst die maximal m gliche Belichtungszeit eingestellt be vor der Gain geregelt wird AutoGain regelt den MasterGain der Kamera im Bereich 0 100 Auto Exposure benutzt den jeweils aktuellen Exposure Bereich der sich aus Pixelclock und Bildwiederholrate ergibt Die Regelbereichsgrenzen k nnen f r Exposure und Gain getrennt eingestellt werden Die Framerate kann bei aktivierter Shutterregelung weiterhin manuell oder automatisch ver n dert werden um den Regelbereich f r die Belichtung dynamisch zu halten Die automatische Frameratenregelung hat das Ziel die Framerate auf einen optimalen Wert einzustellen Da durch steht der Shutterregelung in allen Situa
45. CAL Aktiviert zweifaches Subsampling in vertikaler Richtung IS_SUBSAMPLING_4X_VERTICAL Aktiviert vierfaches Subsampling in vertikaler Richtung IS_SUBSAMPLING_2X_HORIZONTAL Aktiviert zweifaches Subsampling in horizontaler Richtung IS_SUBSAMPLING_4X_HORIZONTAL Aktiviert vierfaches Subsampling in horizontaler Richtung IS_GET_SUBSAMPLING Gibt die aktuelle Einstellung zur ck IS_GET_SUBSAMPLING_TYPE Gibt zur ck ob die Kamera farberhaltendes Subsampling IS_SUBSAMPLING_COLOR verwendet oder nicht IS_GET_SUPPORTED_SUBSAMPLING Gibt die unterst tzten Subsampling Modi zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder aktuelle Einstellung bei IG GEI SUBSAMPLING 4 121 is_SetTestlmage Syntax INT is_SetTestlmage HIDS hf INT nMode Beschreibung Die Funktion is_SetTestlmage schaltet verschiedene vordefinierte Testbilder im Memorybo ardbetrieb ein Wurde ein bestimmter Modus aktiviert wird bei der n chsten Memoryaufnahme dieses Testbild anstelle der echten Bilddaten bertragen Die Testbilder verschieben sich bei jeder Aufnahme um eine Zeile Grauwert usw bergabeparameter hf Handle auf Kamera nMode IS_SET_TEST_IMAGE_DISABLED Testbilder werden deaktiviert IS_SET_TEST_IMAGE_MEMORY_1 1 Testbild wird aktiviert einfarbige graue Rampe IS_SET_TEST_IMAGE_MEMORY_2 2 Testbild wird aktiviert Bayer RGB Rampe IS_SET_TEST_IMAGE_MEMORY_3 3 Testbild wird aktiviert eine wei e horizontale Linie ber einem schwarz
46. Delay HIDS hf ULONG ulDelay ULONG ulDuration Beschreibung is_SetSetFlashDelay erlaubt es eine Verz gerung einzustellen um die der Blitz sp ter einge schaltet wird Zus tzlich kann die Dauer des Blitzes angegeben werden So kann eine globale Blitzfunktion realisiert werden in der alle Zeilen eines Rolling Shutter Sensors belichtet werden siehe dazu auch 4 35 is_GetGlobalFlashDelays Wird f r ulDelay der Wert 0 angegeben wird die normale Blitzfunktion verwendet Soll nur versp tet eingeschaltet werden und erst bei Bildende ausgeschaltet werden kann f r die Blitzdauer ulDuration der Wert 0 bergeben werden bergabeparameter hf Handle auf Kamera ulDelay Zeit um die der Blitz verz gert wird in us IS_GET_FLASH_DELAY R ckgabe der momentan eingestellten Verz gerung IS_GET_FLASH_DURATION R ckgabe der momentan eingestellten Blitz dauer IS_GET_MIN_FLASH_DELAY Gibt den minimal einstellbaren Wert f r die Ver z gerung zur ck IS_GET_MIN_FLASH_DURATION Gibt den minimal einstellbaren Wert f r die Blitzdauer zur ck IS_GET_MAX_FLASH_DELAY Gibt den maximal einstellbaren Wert f r die Verz gerung zur ck IS_GET_MAX_FLASH_DURATION Gibt den maximal einstellbaren Wert f r die Blitzdauer zur ck IS_GET_FLASH_DELAY_GRANULARITY Gibt die Aufl sung der einstellbaren Verz ge rungszeit zur ck IS_GET_FLASH_DURATION_GRANULARITY Gibt die Aufl sung der einstellbaren Blitzdauer zur ck ulDuration Zeit in de
47. Development Systems GmbH 137 Benutzerhandbuch uEye Software Development Kit V2 40 4 123 is_SetWhiteBalance Syntax INT is_SetWhiteBalance HIDS hf INT nMode Beschreibung is_SetWhiteBalance aktiviert den mit nMode angegebenen Wei abgleich Der Software Wei abgleich l sst sich nicht aktivieren wenn der automatische Wei abgleich mit is_SetAutoParameter eingeschaltet wurde is_SetWhiteBalance f hrt eine Farbskalierung per Software durch Optimale Ergebnisse sind mit der Funktion is_SetAutoParameter zu erzielen da diese die hardwareseitigen Gainregler ver wendet bergabeparameter hf Handle auf Kamera nMode IS_SET_WB_DISABLE Wei abgleich deaktivieren IS_SET_WB_USER Benutzerdefinierte Werte verwenden Faktoren m ssen an a Bend mit is_SetWhiteBalanceMultipliers gesetzt wer IS_SET_WB_AUTO_ENABLE Aktiviert automatischen Wei abgleich bei jedem neuen Bild IS_SET_WB_AUTO_ENABLE_ONCE Ba EE mit dem n chsten aufgenomme nen Bild IS_SET_WB_DAYLIGHT_65 Industriestandard Daylight 65 IS_SET_WB_COOL_WHITE Industriestandard CWF Cool White Fluorescent IS_SET_WB_ILLUMINANT_A Industriestandard Illuminant A IS_SET_WB_U30 Industriestandard Ultralume 30 IS_SET_WB_HORIZON Industriestandard Horizon IS_GET_WB_MODE R ckgabe des aktuellen Modus R ckgabewert Aktuelle Einstellung in Verbindung mit S_GET_WB_MODE sonst IS_SUCCESS IS_NO_SUCCESS 138 2000 2007 by IDS Imaging Development Systems GmbH Kapite
48. DeviceAddr INT nRegisterAddr BYTE pbData INT nLen Beschreibung Mit is_Writel2C k nnen Daten ber den I C Bus geschrieben werden Der I C Bustakt betr gt 100 kHz bergabeparameter hf Handle auf Kamera nDeviceAdr Slave address nRegisterAddr Register address nur 8 Bit Adressen g ltig data Zu schreibende Daten length Datenl nge Ung ltige Adresssen f r nRegisterAdar 0x48 0x4C 0x51 0x52 0x55 0x5C 0x5D 0x69 diese werden intern verwendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS or IS_INVALID_I2C_DEVICE_ADDRESS 146 2000 2007 by IDS Imaging Development Systems GmbH Kapitel5 Fehlermeldungen 5 Fehlermeldungen 11 12 15 16 bs 49 50 51 52 53 108 112 113 117 118 119 120 122 125 127 139 140 Fehler IS_NO_SUCCESS IS_SUCCESS IS_INVALID_CAMERA_HANDLE IS_IO_REQUEST_FAILED IS_CANT_OPEN_DEVICE IS CANT OPEN REGISTRY IS_CANT_READ_REGISTRY IS_NO_IMAGE_MEM_ALLOCATED IS_CANT_CLEANUP_MEMORY IS_CANT_COMMUNICATE_WITH_DRIVER IS_INVALID_MEMORY_POINTER IS_FILE_WRITE_OPEN_ERROR IS_FILE_READ_OPEN_ERROR IS_FILE_READ_INVALID_BMP_ID IS_FILE_READ_INVALID_BMP_SIZE IS_NO_ACTIVE_IMG_MEM IS_SEQUENCE_LIST_EMPTY IS_CANT_ADD_TO_SEQUENCE IS_SEQUENCE_BUF_ALREADY_LOCKED IS_INVALID_DEVICE_ID IS_INVALID_BOARD_ID IS_ALL_DEVICES_BUSY IS_TIMED_OUT IS_INVALID_PARAMETER IS_OUT_OF_MEMORY IS_NO_USB20 IS_CAPTURE_RUNNING Besc
49. FT TFT el 2000 2007 by IDS Imaging Development Systems GmbH vii Kapitel 1 Einleitung 1 Einleitung Vielen Dank f r den Kauf einer uEye USB2 0 Kamera der Fa IDS Imaging Development Sys tems GmbH Die uEye Serie besteht aus Monochrom und Farb Kameras f r industrielle medizinische und multimediale Anwendungen Unterst tzt werden USB Schnittstellen nach dem Standard 2 0 USB1 1 nur mit Memoryboard Die Bilder sind abh ngig vom spezifischen Kameramodell in 8 Bit monochromer bzw 24 Bit Echtfarbqualit t verf gbar Zur Einbindung der uEye Kamera in eigene Programme unter Windows 2000 Windows XP und Linux ist ein SDK Software Development Kit im Lieferumfang enthalten Dieses Handbuch beschreibt die Funktionen des uEye Software Development Kit SDK Das Software Development Kit von uEye ist bis auf zus tzliche Funktionalit ten bzw bauart und anschlussbedingte nderungen nahezu identisch mit dem SDK der FALCON bzw EAGLE Fra megrabber Bitte lesen Sie auch die Datei LIESMICH TXT die sich auf der Installations CD befindet Hier sind zus tzliche Informationen zu finden die in dieser Ausgabe des Handbuches eventuell noch nicht enthalten sind Wir w nschen Ihnen viel Erfolg mit diesem Produkt 2000 2007 by IDS Imaging Development Systems GmbH 1 Benutzerhandbuch uEye Software Development Kit V2 40 2 Programmierung 2 1 Programmierung unter Visual C 6 0 7 0 7 1 und 8 0 Bitte beachten Sie
50. IS_GET_RED_GAIN IS GEI GREEN_GAIN IS_GET_BLUE_GAIN sonst IS_SUCCESS oder IS_NO_SUCCESS 120 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 106 is_SetHardwareGamma Syntax INT is_SetHardwareGamma HIDS hf INT nMode Beschreibung Die Funktion is_SetHardwareGamma aktiviert bzw deaktiviert die Gammaregelung der Kame ra bergabeparameter hf Handle auf Kamera nMode IS_GET_HW_SUPPORTED_GAMMA IG GET HW GAMMA ON Die Gammaregelung wird von der Kamera unterst tzt IS_SET_HW_GAMMA_OFF Die Gammaregelung wird von der Kamera nicht unterst tzt IS_SET_HW_GAMMA_OFF Aktiviert die Gammaregelung IS_SET_HW_GAMMA_ON Deaktiviert die Gammaregelung IS_GET_HW_GAMMA Gibt den aktuellen Zustand der Gammaregelung zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder IS_NOT_SUPPORTED 2000 2007 by IDS Imaging Development Systems GmbH 121 Benutzerhandbuch uEye Software Development Kit V2 40 4 107 is_SetHWGainFactor Syntax INT is_SetHWGainFactor HIDS hf INT nMode INT nFactor Beschreibung Die Funktion is_SetHWGainrFactor dient der Steuerung der in der Kamera befindlichen Ver st rker Diese k nnen unabh ngig voneinander von einfacher bis maximaler Verst rkung ein gestellt werden ber die Funktion is_GetSensorlInfo kann abgefragt werden welche Verst r ker vorhanden sind F r die Umrechnung eines Verst rkungswertes aus der Funktion is_Se
51. NFO info Beschreibung Mit der Funktion is_GetAutolnfo k nnen Statusinformationen der Autofunktionalit t abgefragt werden Die Informationen stehen in der Struktur UEYE_AUTO_INFO zur Verf gung Die in der Struktur UEYE_AUTO_INFO gelieferten Statusinformationen sind nur g ltig wenn mindestens eine Autofunktionalit t aktiviert wurde UEYE_AUTO_INFO INT AutoAbility 0x01 AutoShutter m glich AC_SHUTTER 0x02 AutoGain m glich AC_GAIN 0x03 AutoGain und AutoShutter m glich 0x04 AutoWhiteBalance m glich AC_WHITEBAL 0x07 Alle Autofunktionen m glich AUTO_BRIGHT_STATUS sBrightCtrlStatus Siehe AUTO_BRIGHT_STATUS AUTO_WB_STATUS sWBGCtrlStatus Siehe AUTO_WB_STATUS DWORD reserviert Reservierter Platz f r Erweiterungen In der Struktur UEYE_AUTO_INFO werden die Strukturen AUTO_BRIGHT_STATUS und AU TO_WB_STATUS verwendet AUTO_BRIGHT_STATUS INT curValue Akuteller mittlerer Grauwert Ist INT curError Aktuelle Regelabweichung Error INT curController Aktueller Helligkeitsregler 0x01 AC_SHUTTER 0x02 AC_GAIN INT curOtrlStatus Aktueller Regler Status 0x01 ACS_ADJUSTING 0x02 ACS_FINISHED 0x04 ACS_DISABLED AUTO_WB_STATUS INT curController Akuteller Wei abgleichsregler 0x08 AC_WB_RED_CHANNEL 0x10 AC_WB_GREEN_CHANNEL 0x20 AC_WB_BLUE CHANNEL AUTO_WB_CHANNEL_STATUS RedChannel Siehe AUTO_WB_CHANNEL_STATUS AUTO_WB_CHANNEL_STATUS GreenChannel Siehe AUTO_WB_CHANNEL_STATUS AUTO_WB_CHANNEL_STATUS BlueChann
52. OEN A0 4 19 IS FrE8ZEeVIdeo WE 41 4 20 is GetActivelmageMem EE 42 4 21 Ee EE 43 4 22 iS GEAN O sa a a a E a RET 44 4 23 15 1 11 5 111 1210 WE 46 424 Ce Ee ae BE 47 ETC EE 48 TO Ee ECH KEE 49 4 27 is GetColor Ee EE 50 428 iS RE 51 DC CERN ET E el 51 4 30 VEH EIN eet essen eeh Eed 52 4 31 IS de EE 52 4 32 is GetExp sureR ngen auenaen ie ikiia aaa aaia iiaiai ta hend idaan hnkehn nenne 53 4 33 18 GetFramesPerSecond suis een anal am 53 4 34 Je Geitramefmebiange nusen nenn 54 4 35 je Gei lobaltlasbtielavs AAA 55 4 36 Je Geilmagetistogram nenn nnnnnennnen nenn 56 4 37 1iSxGetlmageMem EE 57 4 38 is GetlmageMemPitch 4 4 22 realen 58 4 39 is_GetLastMemorySequence sssessseessessseesieesnesnesesttnettnntttnttnnttnnnttnatnnntnnntnnntnnnnnnnenn netune nnnnn 58 4 40 Je GeMemoneouenceimdow 59 4 41 is_GetNumberOfCameras ucunnssssensssssnnnnnnennnnnnnnnnnnnnnnunnnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnenn 59 4 42 is_GetNumberOfMemorylmages AA 60 E CET Ee EEN 60 4 44 Je Geibiveliockhange AAA 61 4 45 is_GetRevisionlnfo 000000senan1nan1nonnnnnnnnnnnnrnnnannnnrnnrnnnannnnrnnrrnnannnnrnnrnnnannnnnnnentonanannnnntonannnnenannaa nnet 62 A 46 iS Ee dl Oies nia lee aka 63 4 47 is GetUsedBANdWIdtN EEN 64 4 48 Ee 65 4 49 Je GetWhbitebalancekMutpnlers 65 4 50 is HasvVideoztarted eiiieaen aa aaae aa aaa ra aa airaa E a ai r EEA EA NAERAA Si 66 4 51 is HideDD
53. OT_PRESENT IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 143 Benutzerhandbuch uEye Software Development Kit V2 40 4 130 is_UnlockDDMem Syntax INT is_UnlockDDMem HIDS hf Beschreibung is_UnlockDDMem hebt den Zugriff auf den Bildspeicher in den DirectDraw Modi auf An schlie end wird der Inhalt des Backbuffers auf dem Bildschirm aktualisiert bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 131 is_UnlockDDOverlayMem Syntax INT is_UnlockDDOverlayMem HIDS hf Beschreibung is_UnlockDDOverlayMem hebt den Zugriff auf den Overlay Buffer im DirectDraw BackBuffer Modus wieder auf Anschlie end wird der Inhalt des Overlay Buffers auf dem Bildschirm aktua lisiert wenn mit is_ShowDDOverlay das Overlay eingeblendet ist bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 144 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 132 is_UnlockSeqBuf Syntax INT is_UnlockSegBuf HIDS hf INT nNum char pcMem Beschreibung Mit is_UnlockSegBuf wird die Bildaufnahme in einen zuvor gelockten Bildspeicher wieder er laubt Der Bildspeicher wird wieder an der fr heren Position der Sequenzliste eingef gt bergabeparameter hf Handle auf Kamera nNum Nummer des Bildspeichers der freigegeben werden soll 1 max pcMem Startadresse des Bildspeichers nNum bezeichnet
54. OVETAY oianean aa aaaea aaa aaa Aaa da ASA AEEA A NANE aaa 66 iv 2000 2007 by IDS Imaging Development Systems GmbH Ce TT EE 67 4 535 SMEV EEN 68 4 54 Je Inouirelmaoekem mann 69 4 55 je IeMemorvboardConneched AAA 69 Ce ee e EE 70 4 57 Is Load adbtvelorrecton able 71 4 58 is LoddMa ge EE 71 4 59 je _Loadlmage Meisies aanse enable int 72 4 60 is LoadParameter Sierraren a aaee aaa een See Ee een 73 46l is LockDDMEMi iiite a aa a a an 75 4 62 is_LockDDOverlayMem 224 2240444400nnnnnnnnnnnnnnennnnnnnnnnnnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 76 4 63 1S2EOCKSEGBUF EE 77 4 64 is Memorvtreezeviden A 78 4 65 Je PrepnarezteaViden AA 79 4 66 is ReadEEPROM erg estugSetergdk ed Ae e ENEE EEN eane han a ngrr ed 80 4 67 is_Readl2C nur oEvel EN 81 4 68 15 Rel amp seDG u near in HA 81 4 69 is Remnerb itmapt Zeiten edd CES anne nninseilknsuria 82 4 70 i ResetMermory EE 83 dt e R settotefault ef ireira iaaa e eege DEER ege 83 4 72 Is Gavebadbtvelorectonfable 84 ATS iS Savelma EE 85 4 74 is Save lmage EE 86 4 75 Je GavelmagekMem Abbe 87 4 16 ne El EE 88 4 E un 89 4 78 is_SetAllocatedlmageMem AAA 90 NEW 91 4 80 e GeiAutobarameier oscine ainrni iaeaea aaneen aaa Ea ata iaa RETAN aE EATA Ra aneia 93 4 81 je Getb adbivelorrechon 96 4 82 is_SetBadPixelCorrectionTable n nonnoennnnnnnenneennnnnnnnnnseninninnssnssrinnnnnsansrnirirnnnnssrninnnnnnnnsreirnnnnnnne
55. S_GET_DISPLAY_MODE R cklesen der aktuellen Einstellung R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_DISPLAY_MODE sonst IS_SUCCESS IS_NO_SUCCESS EEE 2000 2007 by IDS Imaging Development Systems GmbH 107 Benutzerhandbuch uEye Software Development Kit V2 40 Beispiel Aufl sung mit 1024x768x16 1 5 MB gt OverlayBuffer bis zu 1 5 MB Beispiel is_SetDisplayMode hf Mode Bitmap Modus in Systemspeicher digitalisieren Mode IS_SET_DM_DIB DirectDraw BackBuffer Modus Mode IS_SET_DM_DIRECTDRANW DirectDraw Overlay SurfaceModus bestes Live Overlay Mode IS_SET_DM_DIRECTDRAN IS_SET_DM_ALLOW_OVERLAY bzw um ein automatisches Skalieren auf die Fenstergr e zu erlauben Mode IS_SET_DM_DIRECTDRANW IS_SET_DM_ALLOW_OVERLAY IS_SET_DM_ALLOW_SCALING 4 94 is_SetDisplayPos Syntax INT is_SetDisplayPos HIDS hf INT x INT y Beschreibung Die Funktion is_SetDisplayPos erm glicht die Verschiebung der Bildausgabe die mit is_RenderBitmap erzeugt wird Die Verschiebung erfolgt ber die Parameter x und y bergabeparameter hf Handle auf Kamera x Offset in x Richtung y Offset in y Richtung R ckgabewert IS_SUCCESS IS_NO_SUCCGESS 108 2000 2007 by IDS Imaging Development Systems GmbH 4 95 is_SetEdgeEnhancement Syntax Kapitel 4 Beschreibung der Funktionen INT is_SetEdgeEnhancement HIDS hf INT nEnable Beschreibung
56. S_SET_FLASH_LO _ACTIVE_FREERUN und IS_SET_FLASH_HI ACTIVE_FREERUN funkti oniert nur im Capturemodus siehe 4 4 is_CaptureVideo bergabeparameter hf Handle auf Kamera nMode IS_SET_FLASH_OFF Schaltet den Strobe Ausgang aus IS_SET_FLASH_LO_ACTIVE Schaltet den Strobe Ausgang auf Low Active IS_SET_FLASH_HI_ACTIVE Schaltet den Strobe Ausgang auf High Active IS_SET_FLASH_LO_ACTIVE_FREERUN Schaltet den Strobe Ausgang auf Low Active im Freerun IS_SET_FLASH_HI_ACTIVE_FREERUN Schaltet den Strobe Ausgang auf High Active im Freerun IS_SET_FLASH_HIGH Setzt Strobe Ausgang auf HIGH IS_SET_FLASH_LOW Setzt Strobe Ausgang auf LOW IS_GET_FLASHSTROBE_MODE Gibt den aktuellen Modus zur ck IS_SET_FLASH_IO_1 Blitzen auf dem l O Port 1 nur uEyeLE IS_SET_FLASH_IO_2 Blitzen auf dem UO Port 2 nur uEyeLE IS_GET_SUPPORTED_FLASH_IO Gibt die unterst tzten blitzf higen I O Ports zur ck nur uEyeLE nLine Wird aktuell nicht verwendet Die Parameter IS_SET_FLASH_LO_ACTIVE_FREERUN und IS_SET_FLASH_HI_ACTIVE_ FREERUN werden von den Kameras UI 1440 und UI 1210 nicht unterst tzt 114 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen R ckgabewert IS_SUCCESS IS_NO_SUCCESS den aktuellen Modus in Verbindung mit IS_GET_FLASHSTROBE_MODE 2000 2007 by IDS Imaging Development Systems GmbH 115 Benutzerhandbuch uEye Software Development Kit V2 40 Beispiel T
57. Tabelle 12 Funktionsliste Steuerung der Ein Ausg nge 3 11 1 C Funktionen nur uEyeLE Funktionsliste is_Readl2C nur uEyeLE Daten ber den I C Bus lesen is_Writel2C nur uEyeLE Daten ber den I C Bus schreiben Tabelle 13 Funktionsliste PC Funktionen 12 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke 3 12 Memory Handling der Kamera Funktionsliste is_GetlLastMemorySequence Liefert ID der zuletzt aufgenommenen Sequenz im Memory board is_GetMemorySequenceWindow Liefert Fenstergr e zu einer angegebenen Memoryboard Sequenz is_GetNumberOfMemorylmages Liefert Anzahl an g ltigen Bilder die sich innerhalb der ange gebenen Sequenz ID im Kameraspeicher befinden is_IsMemoryBoardConnected Pr fen ob das optionale Memoryboard vorhanden ist is_MemoryFreezeVideo Einzelbild ber das Memoryboard aufnehmen is_ResetMemory Speicher des Memoryboards l schen is_SetMemoryMode Aktiviert das optionale Memoryboard is_Transferlmage 1 Bild aus dem Kameraspeicher einlesen is_TransferMemorySequence Mehrere Bilder aus dem Kameraspeicher in eine SDK Se quenz einlesen Tabelle 14 Funktionsliste Memory Handling In Verbindung mit dem Memory Erweiterungsmodul f r die uEye Kamerafamilie besteht die M glichkeit neuer Aufnahmevarianten Zur Steuerung werden neue SDK Funktionen zur Verf gung gestellt bzw werden die Funktionalit ten bestehender Funktionen erweitert In Abh ngigkeit ob ein Trig
58. ULL IS_CANNOT_CREATE_BB_OVL IS_NOT_SUPP_IN_OVL_SURF_MODE IS_INVALID_SURFACE IS_SURFACE_LOST IS_RELEASE_BB_OVL_DC IS_BB_TIMER_NOT_CREATED IS_BB_OVL_NOT_EN IS_ONLY_IN_BB_MODE IS_INVALID_COLOR_FORMAT Beschreibung Der Memorymodus ist aktiv Deshalb k nnen keine nde rungen and der Bildgr e vorgenommen werden Es wurde kein Memoryboard detektiert Die Funktion er fordert eine Kamera mit Memoryboard Die eingestellte Anzahl Bilder berschreitet in der aktuel len Gr e die Kapazit t des Memoryboards 4MB Das angeforderte Bild ist nicht im Kameraspeicher vor handen oder nicht mehr g ltig Das Memoryboard wurde aufgrund eines Fehlers deakti viert Die Funktion steht nicht mehr zur Verf gung Die Funktion ist nicht m glich da die kamera auf ein Triggersignal wartet Beim Lesen der Einstellungen trat ein CRC Fehler auf Diese Funktion ist in dieser Treiberversion noch nicht freigeschaltet Die Kamera enth lt keine Kalibrierungsdaten Es wird noch auf eine R ckmeldung des Kerneltreibers gewartet Das verwendete Kameramodell unterst tzt diese Funktion oder Einstellung nicht Es konnte keine Datei gespeichert werden weil der Dia log ohne Auswahl beendet wurde Eine interne Struktur hat die falsche Gr e Der Bildspeicher hat die falsche Gr e um das Bild im gew nschten Format aufzunehmen Diese Einstellung ist bei dem aktuell eingestellten Pixelc lock nicht m glich Diese
59. _Y_MIN Kleinster Wert f r die AOI Bildh he IS_GET_IMAGE_SIZE_Y_MAX Gr ter Wert f r de AOI Bildh he IS_GET_IMAGE_SIZE_Y_MINC Schrittweite f r die AOI Bildh he y 1 yMax Bildh he R ckgabewert In Verbindung mit IS_GET_IMAGE_SIZE_X und IS_GET_IMAGE_SIZE_Y werden die aktuellen Einstellungen gelesen sonst IS_SUCCESS oder IS_NO_SUCCESS 128 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 113 is_SetlO nur Ul 1543 M Syntax INT is_SetlO HIDS hf INT nIO Beschreibung is_SetlO setzt die beiden zus tzlichen digitalen Ausg nge oder liest die momentanen Ein stellungen zur ck bergabeparameter hf Handle auf Kamera nlO Bitmaske f r Ausg nge 0x00 00 Beide Ausg nge auf 0 0x01 01 Erster Ausgang auf 1 zweiter auf 0 0x02 10 Erster Ausgang auf 0 zweiter auf 1 0x03 11 Beide Ausg nge auf 1 IS_GET_IO R ckgabe der momentanen Bitmaske R ckgabewert IS_SUCCESS IS_NO_SUCCESS aktueller Zustand in Verbindung mit IS_GET_IO 4 114 is_SetKeyColor Syntax INT is_SetKeyColor HIDS hf INT r INT g INT b Beschreibung Mit is_SetKeyColor wird die Key Farbe f r den DirectDraw Overlay Surface Modus definiert Die Funktion dient ebenfalls dazu die Key Farbe auszulesen Der auszulesende Farbwert wird ber den Parameter r bergeben Als Ergebnis liefert die Funktion je nach Aufruf entweder den Wert eines Farbanteils 0 255 oder den RGB Wert 0 16
60. am Triggereingang statisch abgefragt werden Damit wird der Triggereingang als digitaler Eingang verwendet Beim Kameramodell Ul 144x xx muss bedingt durch das Timingverhalten dieses Modells im Triggermodus die Belichtungszeit auf den Wert 1 Framerate eingestellt werden bergabeparameter hf Handle auf Kamera nTriggerMode IS_SET_TRIG_OFF Ausschalten der Triggerverarbeitung IS_SET_TRIG_HI_LO Aktive Triggerflanke auf negative Signalflanke setzen IS_SET_TRIG_LO_HI Aktive Triggerflanke auf positive Signalflanke setzen IS_SET_TRIG_SOFTWARE Aktiviert Softwaretriggermodus mit Aufruf der Funktion is_FreezeVideo wird die Kamera getriggert und liefert ein Bild IS_GET_EXTERNALTRIGGER Triggermodus Einstellung zur ck lesen IS_GET_TRIGGER_STATUS Gibt den aktuellen Pegel am Triggereingang zur ck IS_GET_SUPPORTED_TRIGGER_MODE Gibt die unterst tzten Triggermodi zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder aktuelle Einstellung in Verbindung mit IS_GET_EXTERNALTRIGGER IS_SET_TRIG_SOFTWARE IS_SET_TRIG_HI_LO IS_SET_TRIG_LO_HI bei Vewendung von IS_GET_SUPPORTED_TRIGGER_MODE Beispiel Triggermodus einschalten und High Active Blitzmodus setzen is_SetExternalTrigger hf IS_SET_TRIG_SOFTWARE is_SetFlashStrobe hf IS_SET_FLASH_HI_ACTIVE is_FreezeVideo hf IS_WAIT 112 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 99 is_SetFlashDelay Syntax INT is_SetFlash
61. amera nEnable IS_CCOR_DISABLE Deaktiviert die Farbkorrektur IS_CCOR_ENABLE Aktiviert die Farbkorrektur IS_GET_CCOR_MODE Gibt aktuelle Einstellung zur ck factors reserviert R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_CCOR_MODE sonst IS_SUCCESS IS_NO_SUCCESS 102 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 89 is_SetColorMode Syntax INT is_SetColorMode HIDS hf INT Mode Beschreibung is_SetColorMode stellt den gew nschten Farbmodus ein mit dem die Bilddaten gespeichert bzw in der VGA Karte dargestellt werden Im ersten Fall ist es wichtig dass je nach verwen detem Farbmodus der allokierte Bildspeicher ausreichend gro ist Ein 24 Bit Farbbild ben tigt die dreifache Speichergr e als ein 8 Bit Monochrombild Beim Zugriff auf die Bilddaten ist Kenntnis ber die Speicherorganisation in den jeweiligen Farbmodi wichtig siehe auch 2 4 Farb und Speicherformate Eine falsche Interpretation des Speicherinhalts f hrt zu falschen Ergebnissen Bei der direkten bertragung in den Bildspeicher der VGA Karte muss sicherge stellt sein dass die Display Einstellungen mit den Einstellungen des Farbmodus bereinstim men Unter Umst nden kommen die Bilder sonst in verf lschten Farben oder unkenntlich zur Darstellung bergabeparameter hf Handle auf Kamera Mode IS_SET_CM_RGB32 32 Bit Echtfarbomodus R G B Dummy IS_SET_CM_RGB24 24 Bit Echtfarbmodus R G
62. befenster befindet das Videobild eingeblendet Wird der Fensterbereich mit der Keying Farbe gef llt so erscheint das Videobild Entsprechend bleiben Grafik Textdaten erhalten die nicht mit der Keying Farbe gezeichnet wurden Dadurch entsteht ein non destructive Overlay Das Einblenden erfolgt durch den VGA Chip und ben tigt nahezu keine Rechenzeit Dieser Modus wird nicht von allen VGA Chips unterst tzt und ist h ufig nur im YUV Modus m glich Bestes Text Grafik Overlay mit Fenster berlagerung erreicht man durch Setzen des nachfol genden Videomodus Mode IS_SET_DM_DIRECTDRAW IS_SET_DM_ALLOW_OVERLAY Wenn das Videobild auf die Fenstergr e skaliert werden soll auch Vergr erung m glich dann kann dies wie folgt erreicht werden Mode IS_SET_DM_DIRECTDRAW IS_SET_DM_ALLOW _OVERLAY IS_SET_DM_ALLOW_SCALING DirectDraw Overlay Surface Modus VGA Speicher nicht sichtbar l sichtbar Anwender overlaydaten Abb 4 DirectDraw Overlay Surface Modus 2000 2007 by IDS Imaging Development Systems GmbH 5 Benutzerhandbuch uEye Software Development Kit V2 40 Beim FALCON Framegrabber wurde der BackBuffer Modus durch das Setzen des Parameters IS_SET_DM_DIRECTDRAW aktiviert Der BackBuffer Modus der uEye Kameras wird wie folgt aktiviert IS_SET_DM_DIRECTDRAW IS_SET_DM_BACKBUFFER 6 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke 3 Funktionsbl cke 3 1 Initialisie
63. berschrieben Nach dem Aufruf von is_StopLiveVideo mit einem optionalen timeout Wert werden so lange weiter Bilder aufgenommen und in den Kameraspeicher geschrieben bis ein Triggersignal registriert wird Das derzeit aufgenommene Bild wird noch fertig geschrieben Danach sind dien zuletzt aufgenommenen Bilder im Speicher abrufbar Die aufgenommene Sequenz hat eine eindeutige Sequenz Id erhalten unter der die Bilder indiziert werden k nnen Diese Se quenz Id ist mit dem Befehl is_GetLastMemorySequence nach Beenden der Aufnahme ab rufbar L uft die mit timeout spezifizierte Zeit ab bevor das Triggersignal ausgel st wurde wird ein Fehler zur ckgegeben Eventuell in dieser Sequenz bereits aufgenommene Bilder werden verworfen und die Sequenzdaten sind ung ltig is_GetLastSeqguence gibt in diesem Fall 0 zur ck 0 ist keine g ltige Sequenz Id Codebeispiel int nNumberOflmages 5 nSequence 0 is_SetExternalTrigger hCamera IS_TRIG_HI_LO wenn die Speicherung so vieler Bilder m glich ist if is_SetMemoryMode hCamera nNumberOflmages 0 IS_SUCCESS starte Bildaufnahme is_CaptureVideo hCamera IS_WAIT warten auf Triggersignal is_StopLiveVideo hCamera IS_WAIT Sequenz ist g ltig is_GetLastMemorySequence hCamera amp nSequence if nSequence 0 is_TransferImage hCamera 0 nSequence 3 0 14 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke Sta
64. durch einen mit Bright einstellbaren Offset durchgef hrt Bright steht stan dardm ig auf 100 IS_DEFAULT_BRIGHTNESS bergabeparameter hf Handle auf Kamera Bright 0 255 zu setzender Helligkeitswert IS_GET_BRIGHTNESS R cklesen der aktuellen Einstellung R ckgabewert Aktuelle Einstellung in Verbindung mit S_GET_BRIGHTNESS sonst IS_SUCCESS IS_NO_SUCCESS 4 87 is_SetCameralD Syntax INT is_SetCameralD HIDS hf INT nID Beschreibung is_SetCameralD erm glicht es die ID nummer zu vergeben die zum ffnen der Camera ver wendet werden kann siehe dazu auch is_InitCamera bergabeparameter hf Handle auf Kamera niD 1 254 Neue Kamera ID IS_GET_CAMERA_ID Gibt die aktuelle ID zur ck R ckgabewert In Verbindung mit S_GET_CAMERA_ID wird die aktuelle ID zur ckgegeben sonst IS_SUCCESS oder IS_LNO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 101 Benutzerhandbuch uEye Software Development Kit V2 40 4 88 is_SetColorCorrection Syntax INT is_SetColorCorrection HIDS hf INT nEnable double factors Beschreibung Um eine bessere Farbwiedergabe mit Farbsensoren zu erhalten kann ber das SDK eine Farbkorrektur aktiviert werden Hierf r steht die Funktion is_SetColorCorrection zur Verf gung Nach nderung des Parameters muss zwingend mit is_SetWhiteBalance ein Wei abgleich durchgef hrt werden siehe 4 80 is_SetAutoParameter bergabeparameter hf Handle auf K
65. dware Korrektur nur Ul_141x Sensoren Pa rameter threshold wird verwendet IS_BPC_ENABLE_SOFTWARE Aktiviert die Software Korrektur auf Basis der im EEPROM hinterlegten Hotpixelliste IS_BPC_ENABLE_USER Aktiviert die Software Korrektur mit benutzerdefinierten Wer ten Zuvor muss die Funktion SetBadPixelCorrectionTable aufgerufen werden IS_GET_BPC_MODE Gibt den aktuellen Modus zur ck IS_GET_BPC_THRESHOLD Gibt den aktuellen Schwellwert zur ck threshold Wird nur bei Ul_141x Sensoren in Verbindung mit dem Para meter IS_BPC_ENABLE_HARDWARE verwendet Beeinflusst den Grad der Korrektur Es besteht die M glichkeit die Hardwarekorrektur mit einem Softwaremodus zu verkn pfen beide Softwarekorrekturen k nnen aber nicht gemeinsam verwendet werden m gliche Kombi nationen sind 1 IS_BPC_DISABLE IS_BPC_ENABLE_HARDWARE IS_BPC_ENABLE_SOFTWARE IS_BPC_ENABLE_USER IS_BPC_ENABLE HARDWARE IS_BPC_ENABLE_SOFTWARE IS_BPC_ENABLE _ HARDWARE IS_BPC_ENABLE_USER DPPN R ckgabewert IS_SUCCESS IS_NO_SUCCESS den aktuellen Modus in Verbindung mit IS_GET_BPC_MODE oder den aktuelle Schwellwert in Verbindung mit IS_GET_BPC_THRESHOLD 96 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 82 is_SetBadPixelCorrectionTable Syntax INT is_SetBadPixelCorrectionTable HIDS hf INT nMode WORD pList Beschreibung is_SetBadPixelCorrectionTable setzt die Tabelle mit defekten Pixel die b
66. e Software Development Kit V2 40 4 83 is_SetBayerConversion Syntax INT is_SetBayerConversion HIDS hf INT nMode Beschreibung is_SetBayerConversion erm glicht es zwischen drei verschiedenen Farbkonvertierungs Algorithmen zu w hlen die sich in der Qualit t und der ben tigten Rechnerauslastung unter scheiden Randbedingungen Funktion nur g ltig f r 24 Bit 32 Bit und Y8 Farbformat bergabeparameter hf Handle auf Kamera nMode IS_SET_BAYER_CV_NORMAL Die Standard Konvertierung wird nicht mehr unterst tzt Bei Auwahl dieses Modes wird der BETTER Mode ver wendet IS_SET_BAYER_CV_BETTER Bessere Qualit t leicht erh hte Rechner Auslastung IS_SET_BAYER_CV_BES Beste Qualit t st rkste Rechner Auslastung IS_GET_BAYER_CV_MODE Aktuelle Einstellung wird zur ckgegeben R ckgabewert In Verbindung mit S_GET_BAYER_CV_MODE wird die aktuelle Einstellung gelesen sonst IS_SUCCESS oder IS_LNO_SUCCESS 98 2000 2007 by IDS Imaging Development Systems GmbH 4 84 is_SetBinning Syntax INT is_SetBinning HIDS hf INT mode Beschreibung Kapitel 4 Beschreibung der Funktionen Mit is_SetBinning kann der Binningmodus sowohl in horizontaler als auch in vertikaler Rich tung aktiviert werden Dadurch kann die Bildgr e je Binnigrichtung halbiert oder geviertelt wer den Je nach Sensor kann bei aktiviertem Binning die Empfindlichkeit zunehmen oder die Fra merate erh ht werden Z
67. e USB Schnittstelle zum Rechner erfolgen W hrend der bertragung der Daten k nnen keine neuen Bilder aufgenommen und gespeichert werden El 18 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke Kees Abb 11 Ablauf Direct mode Memory mode Das nachfolgende Diagramm zeigt die zeitlichen Abl ufe bei der Verwendung des Memorybo ards Trigger IL TT Exposure Jl Je EE tat E Memory delay gt e Trigger delay Storage TOL T en L Transfer SL T E L gt lt Transfer delay Abb 12 Timing Diagramm Memoryboard 2000 2007 by IDS Imaging Development Systems GmbH 19 Benutzerhandbuch uEye Software Development Kit V2 40 3 13 G ltigkeit in Darstellungsmodi Einige der Funktionen sind f r alle Darstellungsmodi g ltig andere arbeiten nur in Verbindung mit den DirectDraw Darstellungsmodi DD Modi In der nachfolgenden Tabelle sind die G ltig keiten der jeweiligen Funktionen aufgelistet Funktion Bitmap DD BackBuffer DD Overlay Surface Surface is_AddToSequence K is_AlloclmageMem Il L La is_CaptureVideo KI is_ClearSequence E is_Convertlmage K is_CopylmageMem EN L is_CopylmageMemLines Il Li is_DisableDDOverlay is_EnableDDOverlay is_FreelmageMem II L is_FreezeVideo E is_GetActivelmageMem K is_GetActSeqBuf K is_GetDC K is_GetDDOvlSurface is_GetlmageHistogram EN L is_GetlmageMem EN K is_GetlmageMemPitch EN Li is_GetVsyncCount KI KI i
68. e der Rot Verst rkung R ckgabe der Gr n Verst rkung R ckgabe der Blau Verst rkung Setzen der Master Verst rkung Setzen der Rot Verst rkung Setzen der Gr n Verst rkung Setzen der Blau Verst rkung R ckgabe der Standard Master Verst rkung R ckgabe der Standard Rot Verst rkung R ckgabe der Standard Gr n Verst rkung R ckgabe der Standard Blau Verst rkung Umrechnung des Index Wertes f r die Master Verst rkung Umrechnung des Index Wertes f r die Rot Verst rkung Umrechnung des Index Wertes f r die Gr n Verst rkung Umrechnung des Index Wertes f r die Blau Verst rkung 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen nFactor Verst rkungswert R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_MASTER_GAIN_FACTOR IS_GET_RED_GAIN_FACTOR IS_GET_ GREEN_GAIN_FACTOR IS_GET_BLUE_GAIN_FACTOR Gesetzte Einstellung nach Verwendung von S_SET_MASTER_GAIN_FACTOR IS_SET_RED_GAIN_FACTOR IS_SET_ GREEN_GAIN_FACTOR IS_SET_BLUE_GAIN_FACTOR Standard Einstellung nach Verwendung von IS_GET_DEFAULT_MASTER_GAIN_FACTOR IS_GET_DEFAULT_RED_GAIN_FACTOR IS_GET_DEFAULT_ GREEN_GAIN_FACTOR IS_GET_DEFAULT_BLUE_GAIN_FACTOR Umgerechneten Verst rkungsindex nach Verwendung von S_ INQUIRE_ MAS TER_GAIN_FACTOR IS_INQUIRE_ RED_GAIN_FACTOR IS_INQUIRE _ GREEN_GAIN_FACTOR IS_INQUIRE _BLUE_GAIN_FACTOR Beispiel Masterverst rkungsfaktor auf 3 57 setzen
69. ecimationMode is_SetDisplaySize is_SetHorfFilter is_SetHue is_SetlOMask is_SetKeyOffset is_SetParentHwnd is_SetPassthrough is_SetRenderMode is_SetSync is_SetSyncLevel is_SetToggleMode is_SetUpdateMode is_SetVertFilter is_SetVideoCrossbar is_SetVideolnput is_SetVideoMode is_SetVideoSize is_ShowColorBars is_Watchdog is_WatchdogTime 22 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 Beschreibung der Funktionen Zur Einbindung der uEye Kameras in eigene Programme stellt die Treiberbibliothek die in die sem Kapitel beschriebenen Funktionen und Parameter zur Verf gung Die Funktionen sind al phabetisch sortiert und wie folgt aufgebaut lt Name der Funktion gt Syntax Prototyp der Funktion aus der Header Datei ueye h Beschreibung Beschreibung der Funktion mit Querverweisen auf betroffene Funktionen bergabeparameter Beschreibung der Funktionsparameter mit Wertebereichen R ckgabewert Beschreibung und Wertebereich des R ckgabewerts Liefert eine Funktion den Wert IS_NO_SUCGESS 1 zur ck kann der Fehler mit der Funktion is_GetError abgefragt wer den Der Source Code des Beispielprogramms uEye_demo exe das die Funktionen der uEye Bib liothek verwendet liegt auf der Installations CD bei Darin werden neben der eigentlichen Initia lisierung der uEye Kamera und des Zugriffs auf die Kamera auch die verschiedenen Modi der
70. eein flussen nicht mehr ge ndert werden Dazu geh ren folgende Funktionen e is _SetWindowPos e is_SetWindowSize 2000 2007 by IDS Imaging Development Systems GmbH 131 Benutzerhandbuch uEye Software Development Kit V2 40 4 117 is_SetPixelClock Syntax INT is_SetPixelClock HIDS hf INT Clock Beschreibung is_SetPixelClock setzt die Frequenz mit der die Bilddaten aus dem Sensor ausgelesen wer den Eine zu hohe Frequenz kann dazu f hren dass Bilder w hrend der bertragung verloren gehen Durch ndern des Pixelclocks ndert sich auch die Framerate und die Exposure Zeit Der aktuelle Bildeinzug wird dabei abgebrochen bergabeparameter hf Handle auf Kamera Clock Pixelclock in MHz IS_GET_PIXEL_CLOCK Aktueller Pixelclock IS_GET_DEFAULT_PCLK Gibt den Standard Pixeltakt zur ck R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_PIXEL_CLOCK sonst IS_SUCCESS oder IS_NO_SUCCESS 132 2000 2007 by IDS Imaging Development Systems GmbH 4 118 is_SetRopEffect Syntax Kapitel 4 Beschreibung der Funktionen INT is_SetRopEffect HIDS hf INT effect INT param INT reserved Beschreibung is_SetRopEffect stellt den zu verwendenden Bildmanipulationseffekt ein bergabeparameter hf Handle auf Kamera effect IS_SET_ROP_MIRROR_UPDOWN Spiegelt das komplette Bild in Echtzeit um die horizontale Achse IS_SET_ROP_MIRROR_LEFTRIGHT Spiegelt das Bild in der Kamera an der vertikalen
71. ei der benutzerdefi nierten Hotpixelkorrektur verwendet wird Die Hotpixelkorrektur wird eingeschaltet Jeder Wert in der Tabelle besteht aus einem 2 Byte WORD Datentyp Der erste Wert gibt die Anzahl Pixel Koordinaten innerhalb der Tabelle an als n chstes folgen die Koordinaten zuerst X dann Y Eine Tabelle mit 3 defekten Pixeln muss wie folgt aufgebaut sein 3 x1 Y1 x2 Y2 X3 Y3 bergabeparameter hf Handle auf Kamera nMode IS_SET_BADPIXEL_LIST Setzt eine neue benutzerdefinierte Liste Der Parameter pList Zeigt auf eine Liste in dem zuvor be schriebenen Format IS_GET_LIST_SIZE Gibt die Anzahl an Pixel Koordinaten die in der benutzerdefi nierten Liste vorhanden sind zur ck IS_GET_BADPIXEL_LIST Kopiert die benutzerdefinierte Tabelle in den Parameter pList der Speicher muss zuvor reserviert worden sein Beispiel Auslesen der HotPixelCorrection Tabelle WORD pList NULL Anzahl an Koordinaten in der Liste DWORD nCount is_SetBadPixelCorrectionTable hf IS_GET_LIST_SIZE NULL Speicher f r komplette Liste reservieren pList new WORD 1 2 nCount is_SetBadPixelCorrectionTable hf IS_GET_BADPIXEL_LIST pList Liste wieder freigeben delete pList R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder Anzahl an Koordinaten in der Liste bei IS_GET_LIST_SIZE 2000 2007 by IDS Imaging Development Systems GmbH 97 Benutzerhandbuch uEy
72. eichers aus bergabeparameter hf Handle auf Kamera pMem Zeiger auf den Anfang des Bildspeichers von is_AlloclmageMem NID ID des Bildspeichers von is_AlloclmageMem pnX Enth lt die Breite mit der der Bildspeicher angelegt wurde kann NULL sein pnY Enth lt die H he mit der der Bildspeicher angelegt wurde kann NULL sein pnBits Enth lt die Bitbreite mit der der Bildspeicher angelegt wurde kann NULL sein pnPitch Enth lt den Zeileninkrement des Bildspeichers kann NULL sein R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 55 is_lsMemoryBoardConnected Syntax INT is_lsMemoryBoardConnected HIDS hf BOOL pConnected Beschreibung Mit der Funktion is_ IsMemoryBoardConnected kann abgefragt werden ob das optionale Me moryboard vorhanden ist bergabeparameter hf Handle auf Kamera pConnected TRUE Memoryboard ist angeschlossen FALSE Kein Memoryboard vorhanden R ckgabewert IS_SUCCESS IS_NO_SUCCESS Tee u TEE nr 2000 2007 by IDS Imaging Development Systems GmbH 69 Benutzerhandbuch uEye Software Development Kit V2 40 4 56 is_IsVideoFinish Syntax INT is_IsVideoFinish HIDS hf BOOL pbo Beschreibung Mit is_IsVideoFinish kann berpr ft werden ob ein Bild vollst ndig in den Bildspeicher erfasst wurde Diese Funktion ist im Zusammenhang mit is_FreezeVideo mit dem Parameter IS_DONT_WAIT sinnvoll Wenn vor dem Aufruf von is_ sVideoFinish pbo IS_TRANSFER_FAILED gesetzt wi
73. eit f r den Bildeinzug wurde berschritten e IS_NO_ACTIVE_IMAGE_MEM Es ist kein Zielbildspeicher vorhanden e IS_SEQUENCE_BUF_ALREADY_LOCKED Der Zielspeicher ist nicht beschreibbar e IS_COULD_NOT_CONVERT Das aktuelle Bild konnte nicht konvertiert werden EG FF GG Je FF FT 26 2000 2007 by IDS Imaging Development Systems GmbH 4 4 is_CaptureVideo Syntax Kapitel 4 Beschreibung der Funktionen INT is_CaptureVideo HIDS hf INT Wait Beschreibung is_CaptureVideo digitalisiert Videobilder in Echtzeit und bertr gt die Bilder in einen allokier ten Bildspeicher oder unter DirectDraw in die Grafikkarte Die Bilddaten DIB Mode werden in den Speicher abgelegt der mit is_AlloclmageMem angelegt und mit is_SetlmageMem als aktiver Bildspeicher bestimmt wurde ber die Funktion is_GetlmageMem l sst sich die Spei cheradresse abfragen Wird mit Ringbuffering gearbeitet is_AddToSequence so durchl uft die Bildaufnahme alle in die Sequenz aufgenommenen Bildspeicher in einer Endlosschleife Nach Aktivierung des Memorymodus mit is_SetMemoryMode oder is_MemoryFreeze Video werden die mit is_CaptureVideo erfassten Bilder im Kameraspeicher abgelegt Um wieder eine Bilderfassung ohne Memorymode zu erm glichen muss der Memory mode mit der Funktion is_SetMemoryMode IS_MEMORY_MODE_DISABLE 0 siehe 4 116 is SetMemoryMode wieder abgeschaltet werden bergabeparameter hf Wait IS_DONT_WAIT IS_WAIT 10 lt
74. el 4 Beschreibung der Funktionen 4 102 is_SetGainBoost Syntax INT is_SetGainBoost HIDS hf INT mode Beschreibung is_ SetGainBoost aktiviert oder deaktiviert die zus tzliche Hardwareverst rkung der Kamera Diese Funktion wird von den folgenden Kameramodellen unters tzt Ul 1220 C M UI 1440 C M UI 1540 C M UI 1450 C UI 1460 C UI 1480 C und monochrome CCD Modelle bergabeparameter hf Handle auf Kamera mode IS_GET_GAINBOOST Gibt den aktuellen Zustand der Zusatzverst rkung zur ck Falls die Kamera diese Funktion nicht unterst tzt wird IS_NOT_SUPPORTED zur ckgegeben IS_SET_GAINBOOST_ON Aktiviert die Zusatzverst rkung IS_SET_GAINBOOST_OFF Deaktiviert die Zusatzverst rkung IS_GET_SUPPORTED_GAINBOOST Gibt IS_SET_GAINBOOST_ON zur ck falls die Funktion un terst tzt wird sonst IS_SET_GAINBOOST_OFF R ckgabewert Bei Aufruf mit IS_GET_GAINBOOST die aktuellen Einstellungen sonst IS_NOT_SUPPORTED IS_SUCCESS oder IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 117 Benutzerhandbuch uEye Software Development Kit V2 40 4 103 is_SetGamma Syntax INT is_SetGamma HIDS hf INT Gamma Beschreibung is_SetGamma setzt den Wert f r die digitale Gamma Korrektur Der g ltige Wertebereich liegt zwischen 0 01 und 10 Allerdings muss der Parameter Gamma als Integer Wert mit einem Be reich von 1 bis 1000 Gammawert 100 festgelegt sein bergabeparameter hf Handle auf Kamera Gamma
75. el Siehe AUTO_WB_CHANNEL_STATUS 44 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen Nachfolgend wird die Struktur AUTO_WB_CHANNEL_STATUS erl utert welche in der Struktur AUTO_WB_STATUS zum Einsatz kommt AUTO_WB_CHANNEL_STATUS INT curValue Akuteller mittlerer Grauwert Ist INT curError Aktuelle Regelabweichung Error INT curOtrlStatus Aktueller Reglerstatus 0x01 ACS_ADJUSTING 0x02 ACS_FINISHED 0x04 ACS_DISABLED bergabeparameter hf Handle auf Kamera info Struktur UEYE_AUTO_INFO siehe oben R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Auto Info abragen UEYE_AUTO_INFO autoinfo Int ret is_GetAutolnfo m_hCam amp autoinfo FT TFT 2000 2007 by IDS Imaging Development Systems GmbH 45 Benutzerhandbuch uEye Software Development Kit V2 40 4 23 is_GetBusSpeed Syntax INT is_GetBusSpeed HIDS hf Beschreibung Mit der Funktion is_GetBusSpeed kann abgefragt werden ob eine Kamera an einen USB 2 0 Hostcontroller angeschlossen ist Bei bergabe des Wertes Null 0 f r den Kamera Handle wird berpr ft ob ein USB 2 0 Kon troller im System vorhanden ist bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IG NO SUCCESS kein USB 2 0 Kontroller vorhanden hf 0 IS_USB_10 Der Kontroller an dem die Kamera angeschlossen wurde unterst tzt kein USB 2 0 IS_USB_20 Kamera ist an einem USB 2 0 Kontroller angeschlo
76. em Text und Grafik Overlay Die Bildwiederholrate und die Belastung der CPU h ngen von der 4 2000 2007 by IDS Imaging Development Systems GmbH Kapitel2 Programmierung EE eingestellten Farbtiefe und vom Ort Systemspeicher des PCs oder Bildspeicher der VGA Karte des BackBuffers ab Der Treiber versucht die Buffer direkt in der VGA Karte zu allokieren um den Hochgeschwin digkeits Bildtransfer der VGA Karte beim Mischen der drei Buffer auszunutzen K nnen die Buf fer nicht in der VGA Karte allokiert werden muss auf den Systemspeicher ausgewichen wer den Der Bildtransfer aus dem Systemspeicher ist jedoch langsamer oder unter Umst nden auch gar nicht m glich je nach Grafikkarte Eine Skalierung des Videobildes ist im BackBuffer Modus nicht m glich Der BackBuffer Modus wird wie folgt gesetzt Mode IS_SET_DM_DIRECTDRAW IS_SET_DM_BACKBUFFER DirectDraw Backbuffer Modus mit Overlay VGA Speicher nicht sichtbar sichtbar Anwender overlaydaten Abb 3 DirectDraw BackBuffer Modus DirectDraw Overlay Surface Modus Unter LINUX nicht verf gbar In diesem Modus wird ein Live Bild bei gleichzeitiger Darstellung von Overlaydaten erreicht Das Videobild wird in einen nicht sichtbaren Bereich der VGA Karte digitalisiert Dieser Bereich muss sich immer auf der VGA Karte befinden Durch Definition einer Keying Farbe und Zeich nen dieser Farbe in das Bildausgabefenster wird berall dort wo sich diese Keying Farbe im Ausga
77. en Fehlerausgabe aktivieren deaktivieren Einstellen der Belichtungszeit Einstellen der Framerate Aktiviert deaktiviert zus tzliche Hardwareverst rkung Einstellen des Gammawertes digitale Nachbearbeitung Aktiviert deaktiviert den Global Start Shutter Hardware Verst rkung einstellen Aktiviert deaktiviert die Gammaregelung der Kamera Steuerung der Verst rker einer Kamera Fensterhandle f r die Bildausgabe unter DirectDraw Bildposition und Gr e festlegen Bildposition innerhalb des Bildfensters bestimmen Bildgr e festlegen LED ein ausschalten Pixeltakt einstellen 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke is_SetRopEffect Echtzeit Bildmanipulationseffekte einstellen is_SetSaturation Einstellen der Software Bilds ttigung is_SetSubSampling Einstellen der Subsampling Modi is_SetWhiteBalance Wei abgleich aktivieren is_SetWhiteBalanceMultipliers Einstellen der Wei abgleichparameter Tabelle 5 Funktionsliste Auswahl der Betriebsmodi und R cklesen der Einstellungen 3 4 Double und Mehrfach Buffering Funktionsliste is_AddToSequence Bildspeicher in Sequenz Liste aufnehmen is_ClearSequence Komplette Sequenz Liste l schen is_GetActSegBuf Aktuell verwendeten Bildspeicher der Sequenz ermitteln is_LockSegBuf Bildspeicher der Sequenz vor berschreiben sch tzen is_UnlockSegBuf Bildspeicher der Sequenz zum berschreiben freigeben Tabelle 6 Funktionsliste Double und Mehrfach Buff
78. en Bild IS_GET_TEST_IMAGE Aktuelle Einstellung wird zur ckgegeben R ckgabewert In Verbindung mit JS GET TEST IMAGE wird die aktuellen Einstellungen gelesen sonst IS_SUCCESS oder IS_LNO_SUCCESS 136 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 122 is_SetTriggerDelay Syntax INT is_SetTriggerDelay HIDS hf INT nDelay Beschreibung Mit is_SetTriggerDelay l sst sich die Verz gerungszeit zwischen Eingang eines externen Triggersignals und dem Start der Belichtung einstellen Die eingestellte Delayzeit wirkt sich additiv zur Defaultdelayzeit aus Dies ist diejenige Zeit die immer vorhanden ist bis das externe Triggersignal bis zum Sensor durchgeroutet ist Es gelten folgende Werte f r die Defaultdelayzeit bei TTL Signalpegel und 50 Triggerlevel e CMOS e HI LO 38 0us e LOHI 19 7us e CCD e HI_LO 61 5us e LO HI 43 2us bergabeparameter hf Handle auf Kamera nDelay Zeit um die die Bildaufnahme verz gert wird in us IS_GET_TRIGGER_DELAY R ckgabe der momentan eingestellten Verz gerung IS_GET_MIN_TRIGGER_DELAY Gibt den minimal einstellbaren Wert zur ck IS_GET_MAX_TRIGGER_DELAY Gibt den maximal einstellbaren Wert zur ck IS_GET_TRIGGER_DELAY_GRANULARITY Gibt die Aufl sung der einstellbaren Verz gerungszeit zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS aktuelle Einstellungen in Verbindung mit IS_GET_TRIGGER_DELAY 2000 2007 by IDS Imaging
79. en Shutterbereich dynamisch einstellt und AutoGain niemals aktiviert w rde Deshalb sind diese beiden Features gegenseitig verriegelt AutoGain ist nur f r Kameras mit MasterGain Einstellung m glich Auto Whitebalance ist nur f r Kameras mit Hardware RGB Gain Einstellung m glich Bei eingeschaltetem Auto Whitebalance ist das Einschalten der Software Whitebalance ber die Funktion is_SetWhiteBalance deaktiviert Diese wird auch abgeschaltet wenn sie beim Einschalten der Auto Whitebalance aktiv ist 2000 2007 by IDS Imaging Development Systems GmbH 93 Benutzerhandbuch uEye Software Development Kit V2 40 bergabeparameter hf Handle auf Kamera param IS_SET_ENABLE_AUTO_GAIN Aktiviert deaktiviert die Auto Gain Funktion IS GET_ENABLE_AUTO_GAIN IS SET_ENABLE_AUTO_SHUTTER IS GET_ENABLE_AUTO_SHUTTER IS SET_ENABLE_AUTO_WHITEBALANCE IS GET_ENABLE_AUTO_WHITEBALANCE IS SET_ENABLE_AUTO_FRAMERATE IS GET_ENABLE_AUTO_FRAMERATE IS_SET_AUTO_REFERENCE Gibt die aktuelle Auto Gain Einstellung zur ck Aktiviert deaktiviert die Auto Shutter Funktion Gibt die aktuelle Auto Shutter Einstellung zur ck Aktiviert deaktiviert die Auto Whitebalance Funktion Gibt die aktuelle Auto Whitebalance Einstellung zur ck Aktiviert deaktiviert die Auto Framerate Funktion Gibt die aktuelle Auto Framerate Einstellung zur ck Sollwert f r AutoGain AutoShutter setzen Entspricht einem Grauwe
80. enn Param 0 ist wird die voreingestellt Qualit t 75 verwendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS IS_INVALID_PARAMETER ng ltites Dateiformat oder ung ltige JPEG Qualit t 86 2000 2007 by IDS Imaging Development Systems GmbH 4 75 is_SavelmageMem Syntax Kapitel 4 Beschreibung der Funktionen INT is_SavelmageMem HIDS hf char File char pcMem int nID Beschreibung Speichert ein Bild im Bitmap Format BMP in eine Datei Die Bilder werden aus dem angege benen Bildspeicher ausgelesen Das Bitmap wird mit der Farbtiefe 8 15 16 24 oder 32 Bit gespeichert wie der Bildspeicher allokiert wurde Einige Bildbearbeitungsprogramme unterst tzen keine 15 Bit 16 Bit oder 32 Bit Bitmaps und k nnen somit in diesen Modi gespeicherte Bilder nicht einlesen Overlay Daten werden nicht gespeichert bergabeparameter hf File pcMem niD R ckgabewert IS_SUCCESS IS_NO_SUCCESS Handle auf Kamera Name der BMP Bilddatei NULL gt Speichern unter Dialogbox wird ge ffnet Es kann sowohl der absolute als auch der relative Pfad ber geben werden Zeiger auf Bildspeicher ID des Bildspeichers USE_ACTUAL_IMAGE_SIZE kann mit nID logisch ODER verkn pft werden um das Bild mit der aktuell eingestellten Bildh he zu speichern 2000 2007 by IDS Imaging Development Systems GmbH 87 Benutzerhandbuch uEye Software Development Kit V2 40 4 76 is_SavelmageMemEx Syntax INT is_SavelmageMemeEx
81. er nimmt die Variable pval1 Werte von O inaktiv und 1 aktiv an Im Falle des Sollwerts f r AutoGain AutoShutter beschreibt der Wert einen Grauwert von 0 255 Bei den Regelgrenzen werden g ltige Werte f r GAIN 0 100 und SHUTTER Belichtungszeit eingestellt Bei bergabe des Wertes 0 f r den Parameter IS SET AUTO_SHUTTER_MAX wird die ma ximale Shutterzeit gesetzt Falls sich diese durch Justierung des Kameratimings ndert wird der aktualisierte Wert nachgef hrt Wird hingegen ein Wert des aktuell g ltigen Schutterbe reichs bergeben bleibt dieser so lange gesetzt bis ein neuer Wert bergeben wird Beim Aus lesen der Shutter Regelgrenze wird der Benutzerwert oder falls O bergeben wurde die maxi male Schutterzeit zur ckgegeben 94 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen Auto Whitebalance Funktion Bei den Einstellungen f r Offset und GainRange der Auto Whitebalance Funktion werden beide Variablen verwendet Um den Offset f r den roten und den blauen Kanal einzustellen wird der Offset f r rot als Variable pval1 und der Offset f r blau als pval2 bergeben Der Offset kann in einem Bereich von 50 bis 50 eingestellt werden Bei den Regelgrenzen steht pval1 f r den minimalen und pval2 f r den maximalen Gainwert Die Regelgrenzen lassen sich in einem Be reich von 0 bis 100 einstellen Wenn der maximale Gainwert kleiner als das Minimum sein soll te wird das Maximum auf
82. ergabeparameter Hf Handle auf Kamera pcSource Zeiger auf das Eingangsbild nIDSource Speicher ID des Eingangsbildes ppcDest Zeiger auf das Ausgangsbild nIiDDest Speicher ID des Ausgangsbildes R ckgabewert IS_SUCCESS oder IS_NO_SUCCESS Beispiel Konvertierung eines Raw Bayer Bilds in RGB24 Der Speicher wird automatisch allokiert Create a Raw Bayer test picture char pcSource INT nIDSource is_AllocImageMem hf 256 256 8 amp pcSource amp nlIDSource Int nX nY nBits nPitch is_InquirelmageMem hf pcSource nIDSource amp nX amp nY amp anBits amp nPitch for int j 0 j lt nY j t for int i 0 i lt nX i pceSource i j nPitch i INT Gamma 120 double rgbGains 3 rgbGains 0 Red gain Green gain Blue gain rgbGains 1 GO LA S OC rgbGains 2 char pcDest Pointer to the data of the new allocated picture INT nIDDest id of the new allocated picture INT nRet Set the conversion parameters nRet is_SetConvertParam hf TRUE IS_SET_BAYER_CV_BETTER IS_SET_CM_RGB24 Gamma rgbGains 2000 2007 by IDS Imaging Development Systems GmbH 29 Benutzerhandbuch uEye Software Development Kit V2 40 Convert the picture if nRet IS_SUCCESS pcDest NULL is_ConvertImage hf pcSource nlIDSource amp pcDest amp nlIDDest 0 Free the allocated memory is_FreelmageMem m_hCam pcSource nIDSource
83. ering 3 5 Lesen und Schreiben des EEPROMS Funktionsliste is_GetCameralnfo Holt sich die ab Werk eingebrannten Informationen is_GetRevisionInfo Revisionsinformationen der einzelnen uEye Komponenten is_GetSensorlnfo Auslesen der Sensorinformationen is_ReadEEPROM Liest eigene Daten aus EEPROM is_WriteEEPROM Beschreibt das EEPROM mit eigenen Daten Tabelle 7 Funktionsliste Lesen und Schreiben des EEPROMS 3 6 Speichern und Laden von Bildern Funktionsliste is_Loadlmage Bitmap Datei in den aktuellen Bildspeicher laden is_LoadlmageMem Bild aus Datei in den aktuellen Bildspeicher laden is_Savelmage Speichert Videobild als BMP Datei ab is_SavelmageEX Speichert Videobild in einer Datei ab is_SavelmageMem Speichert Bildspeicher als BMP Datei ab is_SavelmageMemEx Speichert Bildspeicher in einer Datei ab ab Tabelle 8 Funktionsliste Speichern und Laden von Bildern 3 7 Bildausgabe Funktionsliste is_RenderBitmap Gibt ein Bild eines Bildspeichers in einem Fenster aus is_SetDisplayPos Erm glicht die Verschiebung der Bildausgabe is_UpdateDisplay Bildschirm Refresh bei DirectDraw Tabelle 9 Funktionsliste Bildausgabe 2000 2007 by IDS Imaging Development Systems GmbH 9 Benutzerhandbuch uEye Software Development Kit V2 40 3 8 Zus tzliche DirectDraw Funktionen Funktionsliste is_DisableDDOverlay Deaktiviert den Overlay Modus is_EnableDDOverlay Aktiviert den Overlay Modus is_GetDC Holt Device Context Handle des Overlay
84. es Bildspeichers nLines Anzahl Zeilen die kopiert werden sollen pcDest Zeiger auf den Zielspeicher in den das Bild kopiert werden soll R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 9 is_DisableDDOverlay Syntax INT is_DisableDDOverlay HIDS hf Beschreibung is_EnableDDOverlay deaktiviert im DirectDraw BackBuffer Modus den Overlay Modus und gibt den durch das Overlay belegten Speicher wieder frei Die Overlaydaten werden dadurch verworfen bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 31 Benutzerhandbuch uEye Software Development Kit V2 40 4 10 is_DisableEvent Syntax INT is_DisableEvent HIDS hf INT which Beschreibung Mit is_DisableEvent wird das hier angegebene Ereignis gesperrt Das Ereignis z B ein Fra me tritt in der Regel nach wie vor auf l st aber kein Event Signal mehr aus Das Anwen dungsprogramm bekommt nach Aufruf dieser Funktion die gesperrten Ereignisse nicht mehr mit Auf Wunsch kann mit is_EnableEvent das gew nschte Ereignis wieder aktiviert werden Siehe auch 4 53 is_InitEvent bergabeparameter Siehe 4 53 is_InitEvent bergabeparameter hf Handle auf Kamera hEv Event Handle von der C C Funktion CreateEveni which ID welches Event initialisiert werden soll Siehe 4 53 is_InitEvent R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Siehe 4 53 is_InitEvent 32 2000
85. evelopment Systems GmbH i Benutzerhandbuch uEye Software Development Kit V2 40 Urheberrechte IDS Imaging Development Systems GmbH Alle Rechte vorbehalten Die IDS Imaging Development Systems GmbH bertr gt dem K ufer das Recht zur Anwendung der Software Jegliche Anfertigung von Kopien der Software mit Ausnahme einer Sicherheits kopie ist strikt untersagt Sicherheitshinweise Wir weisen darauf hin dass der Inhalt dieser Betriebsanleitung nicht Teil einer fr heren oder bestehenden Vereinbarung Zusage oder eines Rechtsverh ltnisses ist oder diese ab ndern soll S mtliche Verpflichtungen der IDS Imaging Development Systems GmbH ergeben sich aus dem jeweiligen Kaufvertrag der auch die vollst ndige und allein g ltige Gew hrleistungs regelung enth lt Diese vertraglichen Gew hrleistungsbestimmungen werden durch die Ausf h rung dieser Betriebsanleitung weder erweitert noch beschr nkt Sollten Sie weitere Informatio nen zu diesem Ger t w nschen oder sollten besondere Probleme auftreten die in der Betriebs anleitung nicht ausf hrlich genug behandelt werden k nnen Sie sich an Ihren H ndler oder Er richter wenden Warenzeichen IDS Imaging Development Systems und uEye sind eingetragene Warenzeichen der IDS Ima ging Development Systems GmbH IBM PC ist ein eingetragenes Warenzeichen der Internatio nal Business Machines Corporation MICROSOFT und WINDOWS sind Warenzeichen oder eingetragene Warenzeichen der Microsoft Cor
86. f char File Beschreibung L dt ein Bild aus einer Datei Das Bild muss im BMP Format vorliegen Das Bild wird in den ak tiven Bildspeicher geladen siehe auch 4 37 is_GetlmageMem und 4 110 is_SetlmageMem bergabeparameter hf Handle auf Kamera File Zeiger auf Dateiname Es kann sowohl der absolute als auch der relative Pfad bergeben werden R ckgabewert IS_SUCCESS Bild wurde fehlerfrei geladen IS_FILE_READ_INVALID_BMP_SIZE Das zu ladende Bild ist gr er als der aktive Bildspeicher IS_FILE_READ_INVALID_BMP_ID Die zu ladende Datei besitzt kein g ltiges Bitmap Format IS_FILE_READ_OPEN_ERROR Die Datei konnte nicht ge ffnet werden 2000 2007 by IDS Imaging Development Systems GmbH 71 Benutzerhandbuch uEye Software Development Kit V2 40 4 59 is_LoadimageMem Syntax INT is_LoadImageMem HIDS hf char File char ppcImgMem int pid Beschreibung is_Loadlmage l dt ein Bild aus einer Datei welches im BMP Format vorhanden sein muss Das Bild wird mit den Eigenschaften Farbformat und tiefe in einen neu allokierten Bildspeicher geladen Mit der Funktion is_FreelmageMem siehe 4 18 is_FreelmageMem wird der Bildspeicher wie der freigegeben bergabeparameter Hf Handle auf Kamera File Dateiname Es kann sowohl der absolute als auch der relative Pfad bergeben werden ppcImgMem Zeiger auf eine Variable mit der Startadresse Pid Zeiger auf eine Variable mit der Speicher ID R ckgabewe
87. geAOlI is_SetlmagePos is_SetlmageSize is_SetLED is_SetPixelClock Liefert Event Z hler und Counter Werte Liefert Statusinformationen der Autofunktionalit t Liefert Informationen ber die angeschlossenen Kameras Liefert den Kamera Typ Aktuellen Farbmodus der VGA Karte ermitteln Gibt die Version der ueye_api dil zur ck Fehlermeldung abfragen Belichtungsbereich ermitteln Gibt aktuelle Framerate im Livemodus zur ck Frameraten Bereich ermitteln Ermittelt die Anzahl im System vorhandener Kameras Betriebssystem erfragen Gibt einstellbaren Bereich f r den Pixeltakt zur ck Summe der aktuell eingestellten Pixeltakte Auslesen des VSYNC Z hlers Auslesen der aktuellen Parameter des Wei abgleichs Eine benutzerdefinierte Hotpixel Liste aus einer Datei laden Setzt den Stehlen Modus R cksetzen der Kameraparameter auf Standardwerte Speichert die aktuelle benutzerdefinierte HotpixelListe Gr e und Position eines AOI setzen Aktiviert deaktiviert Gain Shutter Whitebalance Autofunktionen Ein ausschalten und parametrieren der Hotpixelkorrektur bergibt dem SDK eine benutzerdefinierte Hotpixel Liste Einstellen der Binning Modi Ein Ausschalten der Blacklevel Kompensation Einstellen der Bildhelligkeit digitale Nachbearbeitung Farbkorrektur einstellen Farbmodus ausw hlen Einstellen des Kontrastes digitale Nachbearbeitung Konvertierungsparameter f r ein RAW Bayer Bild Auswahl des Modus der Bilddarstellung Kantenfilter einstell
88. gersignal die Aufnahme beendet oder startet ergeben sich f r die zwei Aufzeichnungsmodi die Bezeichnungen e Pre Trigger und e Post Trigger Modus Pre Trigger In diesem Modus zeichnet das Memoryboard kontinuierlich Bilder auf Beim Ausl sen des Trig gers wird die Aufnahme beendet und es stehen die n letzten Bilder im Kameraspeicher zur Ver f gung e Vorbereitung Mit der Funktion is_SetExternalTrigger wird der Triggereingang der Kamera aktiviert Die Kamera wird mit der Funktion is_SetIMemoryMode f r die Speicherung vorbereitet Die Reihenfolge der Funktionen is_SetlMemoryMode und is_SetExternalTrigger ist beliebig Wird mit is_SetExternalTrigger hCamera IS_SET_TRIG_OFF der Trigger deaktiviert so wird die Aufnahme direkt beim Aufruf von is_StopLiveVideo beendet Als Parameter bekommt diese Funktion eine Zahl mit die die Anzahl an Bildern in einem Ringspeicher beschreibt welcher bis zum Eintreten des Triggers zyklisch berschrieben wird Die maximal m gliche Anzahl Bilder die im Speicher gehalten werden k nnen ist abh ngig von der eingestellten Bildgr e weshalb diese nach Aktivierung des Memorymodus nicht mehr zu ndern ist 2000 2007 by IDS Imaging Development Systems GmbH 13 Benutzerhandbuch uEye Software Development Kit V2 40 Aufnahme Mit dem Aufruf von is_CaptureVideo startet die Aufnahme Es werden n Bilder in den Spei cher geschrieben und beim Eintreffen weiterer Bilder wird das jeweils lteste
89. h der VGA Karte kopiert Die drei Buffer be sitzen jeweils die Gr e Video_X Video_Y Farbtiefe in Bytes pro Pixel Der Treiber ver sucht die Buffer direkt in der VGA Karte zu allokieren um den Hochgeschwindigkeits Bildtransfer der VGA Karte beim Mischen der drei Buffer auszunutzen K nnen die Buffer nicht in der VGA Karte allokiert werden muss auf den Systemspeicher ausgewichen werden Der Bildtransfer aus dem Systemspeicher ist jedoch langsamer oder unter Umst nden abh ngig von der Grafikkarte auch gar nicht m glich Das Overlay wird nicht direkt eingeblendet Es muss zuvor mit is_ShowDDOverlay siehe 4 125 is_ShowDDOverlay sichtbar gemacht wer den Das Overlay benutzt als Color Key die Farbe Schwarz so dass eine Overlay Grafik keine schwarze Farbe enthalten kann Behelf ber eine nahezu schwarze Farbe z B Dunkelblau bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 34 2000 2007 by IDS Imaging Development Systems GmbH 4 13 is_EnableEvent Syntax INT is_EnableEvent HIDS hf INT which Beschreibung Kapitel 4 Beschreibung der Funktionen Freigabe des eingerichteten Event Objekts Nach der Freigabe werden die Ereignismeldungen f r das angelegte Event Objekt zugelassen Siehe auch 4 53 is_InitEvent bergabeparameter Siehe 4 53 is_InitEvent bergabeparameter hf hEv which Siehe 4 53 is_InitEvent R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Siehe
90. hen somit alle Grafikbefehle wie Line Circle Rectangle TextOut Funk tionen von Windows zur Verf gung Das Device Context Handle muss sobald als m glich mit der Funktion is_ReleaseDC freigegeben werden Innerhalb eines GetDC ReleaseDC Blocks erfolgt KEIN Update des Overlaybuffers auf dem Bildschirm bergabeparameter hf Handle auf Kamera phDC Zeiger auf Variable die das Device Kontext Handle aufnimmt R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 29 is_GetDDOvlISurface Syntax INT is_GetDDOvISurface HIDS hf LPDIRECTDRAWSURFACE ppDDSurf Beschreibung is_GetDDOvISurface gibt im DirectDraw BackBuffer Modus den Zeiger auf das interne Di rectDraw Surface zur ck Damit k nnen die Funktionen des IDirectDraw Surface Interface ver wendet werden bergabeparameter hf Handle auf Kamera ppDDSurf Enth lt dann den Zeiger auf das IDirectDraw Surface Inter face R ckgabeparameter IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 51 Benutzerhandbuch uEye Software Development Kit V2 40 4 30 is_GetDLLVersion Syntax INT is_GetDLLVersion Beschreibung Gibt die Version der ueve ap dl zur ck Der R ckgabewert enth lt die Versionsnummer in folgender Kodierung Bits 31 24 major version number Bits 16 23 minor version number Bits 15 0 build version number bergabeparameter lt keine gt R ckgabewert Versionsnummer 4 31 is_GetError Syntax INT is_Ge
91. hler zur ck 2000 2007 by IDS Imaging Development Systems GmbH 17 Benutzerhandbuch uEye Software Development Kit V2 40 Beispiel Es wurde bereits eine Sequenz A mit 5 Bildern aufgenommen Eine zweite Sequenz B passt noch komplett in den Speicher ohne berschreibungen vornehmen zu m ssen Wird nun eine dritte Sequenz aufgenommen deren 3 Bilder zusammen gr er sind als der noch zur Verf gung stehende Speicher so wird der Speicher wieder vom Anfang an beschrie ben falls ein Bild nicht mehr komplett in den noch freien Speicher passt einzelne Bilder werden also nicht umgebrochen es bleibt ein kleiner Rest ungenutzt Eventuell in diesen Speicherstellen stehende Bilder werden berschrieben im Beispiel ragt das Bild C3 in den Speicherbereich von A3 womit das ganze Bild A3 ung ltig wird Sequenz A be steht nunmehr aus nur noch 2 Bildern Abb 10 Anh ngender Speichermodus Timing im Memoryboard Betrieb Die Daten eines aufgenommenen Bildes werden im Normalbetrieb direkt vom Sensor ber die USB Schnittstelle an den Rechner geschickt Bei der Verwendung des Memoryboards verh lt sich dies anders Im Memoryboard Betrieb be findet sich der Sensor im Triggermodus Sobald das Triggersignal anliegt wird gem der Vor einstellungen 1 Bild oder eine Folge von Bildern aufgenommen und im Memoryboard gespei chert Nachdem das letzte Bild gespeichert wurde kann die bertragung der gespeicherten Bil der ber di
92. hoben werden Die Digitalisierung in den Speicherbereich wird durch einen Aufruf von is_LockDDMem nicht unterbrochen Im DirectDraw Backbuffer Modus erfolgt innerhalb eines LockDDMem UnlockDDMem Blocks erfolgt KEIN Update des Backbuffers auf dem Bildschirm bergabeparameter hf Handle auf Kamera ppMem Zeiger auf Variable die den Adresszeiger aufnimmt pPitch Zeiger auf Variable die den Pitch Wert aufnimmt R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 75 Benutzerhandbuch uEye Software Development Kit V2 40 4 62 is_LockDDOverlayMem Syntax INT is_LockDDOverlayMem HIDS hf void ppMem INT pPitch Beschreibung is_LockDDOverlayMem gibt im DirectDraw Backbuffer Modus den Zugriff auf den Overlay speicher frei und liefert den Adresszeiger auf den Anfang des Overlay Buffers zur ck Damit kann direkt in den Overlay Buffer geschrieben werden ohne die Windows GDI Funktionen ver wenden zu m ssen pPitch liefert den Zeilenoffset in Bytes vom Anfang einer Zeile zum Anfang der folgenden Zeile zur ck Der Zugriff muss sobald als m glich mit der Funktion is_UnlockDDOverlayMem wieder aufgehoben werden Innerhalb eines LockDDOverlayMem UnlockDDOverlayMem Blocks erfolgt KEIN Update des Overlaybuffers auf dem Bildschirm bergabeparameter hf Handle auf Kamera ppMem Zeiger auf Variable die den Adresszeiger aufnimmt pPitch Zeiger auf Variable die den Pitch Wert aufnimmt
93. hreibung allgemeine Fehlermeldung allgemeine Erfolgsmeldung kein Fehler Das Kamera Handle ist ung ltig F r die meisten der Funktionen des uEye SDk wird das Kamera Handle als erster Parameter erwartet Eine IO Anforderung des uEye Treibers schlug fehl E ventuell passen Api dl und Treiber Datei nicht zusam men Ein Versuch die Kamera zu ffnen schlug fehl Kamera nicht vorhanden oder Fehler beim Initialisieren Fehler beim ffnen eines Windows Registry Keys Fehler beim Lesen von Einstellungen aus der Windows Registry Der Treiber konnte keinen Speicher reservieren Der Treiber konnte den verwendeten Speicher nicht frei geben Kommunikation mit dem Treiber schlug fehl weil kein Treiber geladen ist Ung ltiger Zeiger oder ung ltige SpeicherID Datei kann nicht zum Schreiben ge ffnet werden Datei kann nicht zum Lesen ge ffnet werden Die angegebene Datei ist kein g ltiges Bitmap Die Gr e des Bitmaps ist falsch zu gro Kein aktivierter Bildspeicher vorhanden Der Speicher muss mit der Funktion is_SetActivelmageMem aktiviert werden oder es muss mit der Funktion is_AddTo Se quence eine Sequenz aufgebaut werden Die Sequenzliste ist leer und kann nicht gel scht werden Der Bildspeicher befindet sich bereits in der Sequenz und kann nicht doppelt hinzugef gt werden Der Speicher konnte nicht gelockt werden Der Zeiger auf den Buffer ist ung ltig Die Device ID ist ung ltig G ltige IDs liegen zwi
94. ht Maximale Fenster H he z B 1024 BOOL bMasterGain Gemeinsamer Verst rker vorhanden z B FALSE BOOL bRGain Rot Verst rker vorhanden z B TRUE BOOL bGGain Gr n Verst rker vorhanden z B TRUE BOOL bBGain Blau Verst rker vorhanden z B TRUE BOOL bGlobShutter Global oder Rolling Shutter TRUE GlobalShutter FALSE RollingShutter Char Reserved 16 Reserviert bergabeparameter hf Handle auf Kamera pinfo Sensor Info Struktur R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 47 is_GetUsedBandwidth Syntax INT is_GetUsedbandwidth HIDS hf Beschreibung is_GetUsedBandwidth gibt die momentan belegte Bandbreite durch den Pixelclock aller akti ven Kameras zur ck bergabeparameter hf Handle auf Kamera R ckgabewert Summe des Pixeltaktes 64 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 48 is_GetVsyncCount Syntax INT is_GetVsyncCount HIDS hf ong plntr Jong pFrame Beschreibung is_GetVsyncCount liest den VSYNC Z hler aus Dieser wird bei jedem VSYNC um 1 erh ht bergabeparameter hf Handle auf Kamera pintr Aktueller VSYNC Z hlerstand pFrame Aktueller Frame SYNC Z hlerstand R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 49 is_GetWhiteBalanceMultipliers Syntax INT is_GetWhiteBalanceMultipliers HIDS hf double pdblRed double pdblGreen double pdblBlue Beschreibung Die Funktion is_GetWhiteBalanceMultipliers gibt
95. ht ca 59 5 Stunden F r 1 lt Wait lt 10 wird Wait 10 gesetzt Bsp Wait 100 gt 1 sec warten R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Triggermodus einschalten High Active Blitzmodus setzen und Bild aufnhemen is_SetExternalTrigger hf IS_SET_TRIG_SOFTWARE is_SetFlashStrobe hf IS_SET_FLASH_HI_ACTIVE is_FreezeVideo hf IS_WAIT 2000 2007 by IDS Imaging Development Systems GmbH 41 Benutzerhandbuch uEye Software Development Kit V2 40 4 20 is_GetActivelmageMem Syntax INT is_GetActivelmageMem HIDS hf char ppcMem INT pnID Beschreibung is_GetActivelmageMem gibt den Zeiger auf den Anfang und die ID Nummer des aktiven Bild speichers zur ck Falls ein DirectDraw Modus aktiv ist aber trotzdem Bildspeicher allokiert wur den so wird mit dieser Funktion der Zeiger und die ID des mit is_SetlmageMem aktiv gesetz ten Bildspeichers zur ckgegeben in diesen Bildspeicher wird im DirectDraw Modus jedoch nicht digitalisiert Vergleiche auch mit is_GetimgMem bergabeparameter hf Handle auf Kamera ppcMem Enth lt dann den Zeiger auf den Anfang des Bildspeichers pnID Enth lt dann die Identifikationsnummer des Bildspeichers R ckgabewert IS_SUCCESS IS_NO_SUCCESS 42 2000 2007 by IDS Imaging Development Systems GmbH 4 21 is_GetActSeqBuf Kapitel 4 Beschreibung der Funktionen Syntax INT is_GetActSegBuf HIDS hf INT pnNum char ppcMem char ppcMemLast Beschre
96. ibung Mit is_GetActSegBuf kann der Bildspeicher ermittelt werden in den gerade die Bildaufnahme erfolgt ppcMem bzw den Bildspeicher der als letztes f r die Bildaufnahme verwendet wurde ppcMemlLast Diese Funktion ist nur verf gbar wenn ein Ringbuffering aktiv ist Wenn die Bildaufnahme f r ein Ringbuffering gestartet wurde so liefert is_GetActSegBuf in onNum so lange den Wert 0 zur ck bis die Bildaufnahme in den ersten Bildspeicher der Sequenz gestar tet wurde Sonst enth lt onNum die Nummer des Sequenz Bildspeichers in den gerade die Bildaufnahme erfolgt Die Nummer ist nicht die ID des Bildspeichers die von is_AlloclmageMem vergeben wurde sondern die laufende Nummer in der Reihenfolge der Anmeldung ber is_AddToSequence bergabeparameter hf Handle auf Kamera pnNum Enth lt dann die Nummer des Bildspeichers in den gerade die Bildaufnahme erfolgt 0 Bildaufnahme in den 1 Bildspeicher wurde noch nicht gestartet 1 max Bildaufnahme in den Sequenz Bildspeicher N wur de gestartet ppcMem Enth lt dann die Startadresse des Bildspeichers in den ge rade die Bildaufnahme erfolgt ppcMemLast Enth lt dann die Startadresse des Bildspeichers der zuletzt f r die Bildaufnahme verwendet wurde R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 43 Benutzerhandbuch uEye Software Development Kit V2 40 4 22 is_GetAutolnfo Syntax INT is_GetAutolnfo HIDS hf PUEYE_AUTO_I
97. ie Gr e des Ringspeichers an Wird f r nCount die Konstante IS_MEMORY_DISABLE bergeben wird das Memoryboard deaktiviert Mit dem Parameter nDelay wird der Abstand in Millisekunden in dem Bilder in den Speicher bertragen werden sollen angegeben Wird f r den Parameter nDelay die Konstante IS_MEMORY_USE_TRIGGER bergeben wird im Sequenz Mode zwischen zwei Aufnahmen auf einen neuen Trigger gewartet Im Pre Trigger Modus wird dieser Parameter ignoriert siehe auch 3 12 Memory Handling der Kamera bergabeparameter hf Handle auf Kamera nCount Gibt die Anzahl an Bildern an die im Post Triggermodus in den Speicher bertragen werden Im Pre Triggermodus wird hiermit die Gr e des Ringspei chers festgelegt IS_MEMORY_MODE_DISABLE Deaktiviert das Memoryboard IS_LMEMORY_GET_COUNT Gibt die eingestellte Bildanzahl zur ck IS MEMORY GET D I AN Gibt die Verz gerung zwischen zwei Bildern im Post Trigger modus zur ck nDelay Stellt die Verz gerung in Millisekunden zwischen zwei aufge nommenen Bildern im Post Triggermodus ein Die Bilderfas sung erfolgt ber einen intern gesteuerten Software Trigger IS_MEMORY_USE_TRIGGER Wartet bei einer Sequenzaufnahme auf den n chsten Trigger R ckgabewert IS_SUCCESS IS_NO_MEMORY_BOARD_CONNECTED IS_TOO_LESS_MEMORY aktuelle Einstellung in Verbindung mit IS_LMEMORY_GET_COUNT oder IS_MEMORY_GET_DELAY Nachdem der Memorymodus aktiviert wurde k nnen Kameraparameter die die Bildgr e b
98. ie Verwendung von S_FORCE_VIDEO_STOP kann eine mit is_FreezeVideo hf IS_DONT_WAIT gestartete Einzelbildaufnahme sofort beendet werden bergabeparameter hf Handle auf Kamera Wait IS_WAIT Funktion wartet bis Bild ganz im Speicher ist IS_DONT_WAIT Funktion kommt sofort zur ck IS_FORCE_VIDEO_STOP Halte Digitalisierung sofort an R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 141 Benutzerhandbuch uEye Software Development Kit V2 40 4 128 is_Transferlmage Syntax INT is_Transferlmage HIDS hf INT nMemID INT segID INT imageNr INT reserved Beschreibung Die Funktion is_Transferlmage wird verwendet um Bilder aus dem Kameraspeicher auf dem optionalen Memoryboard einzulesen Als Parameter wird die ID des Speichers angegeben in den das Bild bertragen wird Au erdem wird die gew nschte Sequenz ID und die Nummer des Bildes ben tigt Werden f r die Sequenz und die Bildnummer 0 angegeben wird das zuletzt aufgenommene Bild bertragen bergabeparameter hf Handle auf Kamera nMemID ID des Speichers muss zuvor mit is_AlloclmageMem oder is_SetAllocatedlmageMem angelegt worden sein seqID Die ID der Sequenz aus der ein Bild eingelesen wird imageNr Gibt die Nummer des Bildes innerhalb der Sequenz an R ckgabewert IS_SUCCESS IS_IMAGE_NOT_PRESENT IS_NO_SUCCESS 142 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der F
99. ie zu einem sp teren Zeitpunkt mit is_LoadParameters geladen werden kann Wird f r pFilename der Wert NULL bergeben wird der Datei speichern Dialog von Windows angezeigt bergabeparameter hf Handle auf Kamera pFilename Zeiger auf Dateiname Es kann sowohl der absolute als auch der relative Pfad bergeben werden R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel ini Datei Siehe 4 60 is_LoadParameters 2000 2007 by IDS Imaging Development Systems GmbH 89 Benutzerhandbuch uEye Software Development Kit V2 40 4 78 is_SetAllocatedimageMem Syntax INT is_SetAllocatedlmageMem HIDS hf INT width INT height INT bitspixel char pcImgMem Int pid Beschreibung is_SetAllocatedimageMem erkl rt einen vom Benutzer allokierten Speicher zu einem Spei cher in den digitalisiert werden kann Der Speicher muss gro genug allokiert worden und muss unbedingt global gelocked sein Ein mit is_SetAllocatedImageMem angegebener Spei cher kann in eine Sequenz eingebaut werden Der Speicher muss mit is_FreelmageMem aus der treiberinternen Verwaltung genommen werden bevor er tats chlich wieder freigegeben wird Der allokierte Speicher darf nicht reallokiert werden Folgende Reihenfolge ist zu beachten e Speicher allokieren HANDLE hgMem GlobalAlloc size e Speicher locken Char pcMem char GlobalLock hgMem Die Adresse des Speichers wird an den uEye Treiber bergeben Dies geschieht mit der Funk tion i
100. ildausgabe bernimmt kann das Bild von beliebig anderen Fenstern und Dialogboxen ganz oder teilweise berlagert werden Bitmap Modus VGA Speicher nicht sichtbar l sichtbar Abb 2 Bitmap Modus DirectDraw BackBuffer Modus unter LINUX nicht verf gbar In diesem Modus werden die Bilddaten in den nicht sichtbaren Bereich der VGA Karte ge schrieben Voraussetzungen sind hierbei Installierter DirectDraw Treiber ausreichend Speicher auf der VGA Karte und BackBuffer Support des VGA Karten Herstellers Im BackBuffer Modus mit Overlay werden 3 nichtsichtbare Bildbuffer verwendet e BackBuffer e OverlayBuffer e MixBuffer Die drei Buffer besitzen jeweils die Gr e Video_X Videon WV Farbtiefe in Bytes pro Pixel Das Videobild wird in den BackBuffer geschrieben Das Overlay kann in den OverlayBuffer ge zeichnet werden siehe auch 4 28 is_GetDC und 4 68 is ReleaseDC Das Overlay wird nicht direkt eingeblendet Es muss zuvor mit is_ShowDDOverlay siehe 4 125 is_ShowDDOverlay sichtbar gemacht werden Es benutzt als Color Key die Farbe schwarz so dass eine Overlay Grafik keine schwarze Farbe enthalten kann Behelf ber eine nahezu schwarze Farbe z B Dunkelblau BackBuffer und OverlayBuffer werden zusammen in den MixBuffer geschrieben Dabei werden die Overlaydaten dem Videobild berlagert Anschlie end wird der MixBuffer in den sichtbaren Bereich der VGA Karte kopiert Das Ergebnis ist eine Live Bilddarstellung mit berlagert
101. is_GetNumberOfMemorylmages HIDS hf INT nID INT pnCount Beschreibung Die Funktion is_GetNumberOfMemorylmages gibt die Anzahl an g ltigen Bildern zur ck die sich innerhalb der angegebenen Sequenz ID im Kameraspeicher befinden Diese Anzahl kann sich aufgrund von berschreibungen von der urspr nglich aufgenommenen Anzahl an Bildern unterscheiden bergabeparameter hf Handle auf Kamera niD Gibt die ID an zu der die Anzahl der vorhandenen Bilder zu r ckgegeben werden soll pnCount Dieser Parameter gibt die Anzahl der sich in der Sequenz be findenden Bilder zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 43 is_GetOsVersion Syntax INT is_GetOsVersion Beschreibung is_GetOsVersion gibt den Typ des Betriebssystems zur ck mit dem zur Laufzeit gearbeitet wird bergabeparameter lt keine gt R ckgabewert IS_OS_WIN2000 IS_OS_WINXP IS_OS_WINSERVER2003 60 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 44 is_GetPixelClockRange Syntax INT is_GetPixelClockRange HIDS hf INT pnMin INT pnMax Beschreibung is_GetPixelClockRange gibt den einstellbaren Bereich f r den Pixeltakt zur ck Je nach Kameramodell und Betriebsmodus k nnen die Grenzwerte f r den Pixeltakt variieren So erh ht sich bei einer Ul 1220x der minimale Pixeltaktbei aktiviertem 4x Binning horizontal von 8 MHz auf 16 MHzund bei einer Ul 141x von 5MHZz auf 10MHZz bei a
102. ktiviertem 2x Sampling horizontal bergabeparameter hf Handle auf Kamera pnMin Gibt den unteren Grenzwert zur ck pnMax Gibt den oberer Grenzwert zur ck R ckgabewert IS_SUCCESS oder IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 61 Benutzerhandbuch uEye Software Development Kit V2 40 4 45 is_GetRevisioninfo Syntax INT is_GetRevisionInfo HCAM hf PREVISIONINFO prevInfo Beschreibung Die Funktion is_GetRevisioninfo liest die Revisionsinformationen der einzelnen uEye Kompo nenten aus Die Revisions Struktur ist wie folgt aufgebaut Size Sensor Cypress Highbyte Lowbyte Blackfin DSPFirmware USB_Board Sensor_Board Processing_Board Memory_Board Housing Filter Timing_Board Product Reserved bergabeparameter hf previnfo R ckgabewert IS_SUCCESS IS_NO_SUCCESS Strukturgr e Hardware Sensorrevision 1 Typ FX2 2 Typ FX2LP Cypress revision DSP revision Blackfin Firmware Version USB Board Revision Sensor Board Revision Processing Board Revision Memory Board Revision Geh usevariante Eingebauter Filtertyp Timing Board Revision Produktrevision F r sp tere Verwendung reserviert Handle auf Kamera Zeiger auf Revisions Informations Struktur 62 2000 2007 by IDS Imaging Development Systems GmbH 4 46 is_GetSensorlnfo Syntax Kapitel 4 Beschreibung der Funktionen INT is_GetSensorlnfo HIDS hf PSENSORINFO plnfo Beschreibung
103. l 4 Beschreibung der Funktionen 4 124 is_SetWhiteBalanceMuiltipliers Syntax INT is_SetWhiteBalanceMultipliers HIDS hf double dbIRed double dbIGreen double dbIBlue Beschreibung Mit is_SetWhiteBalanceMultipliers werden die benutzerdefinierten Faktoren gesetzt die f r den Wei abgleich herangezogen werden Details hierzu siehe auch bei 4 121 is_SetWhiteBalance is_SetWhiteBalanceMultipliers setzt die Parameter f r die Software Farbskalierung die mit der Funktion is_SetWhiteBalance durchgef hrt wird Eine bessere Steuerung der Grundfarben kann mit der Funktion is_SetAutoParameter erreicht werden bergabeparameter hf Handle auf Kamera dbiRed Neuer Faktor f r rot dblGreen Neuer Faktor f r gr n dbIBlue Neuer Faktor f r blau R ckgabewert IS_SUCCESS oder IS_NO_SUCCESS 4 125 is_ShowDDOverlay Syntax INT is_ShowDDOverlay HIDS hf Beschreibung is_ShowDDOverlay blendet das Overlay im DirectDraw BackBuffer Modus ein Es werden die zuletzt im Overlaybuffer enthaltenen Daten dargestellt Die Darstellung erfolgt nun ber drei Bildbuffer Je nach VGA Karte kann jetzt die Bildwiederholrate kleiner sein als ohne Overlay darstellung bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS oder IS_LNO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 139 Benutzerhandbuch uEye Software Development Kit V2 40 4 126 is_StealVideo Syntax INT is_StealVideo HIDS hf in
104. laufen und steht nach IS_FRAME zur Verarbeitung bereit Die Bildaufnahme in das optionale Memorymodul wurde beendet Der mit is_InitCamera ge ffnete Device wurde ent fernt Eine mit is_InitCamera ge ffnete und danach ent fernte Kamera wurde wieder eingesteckt Eine neue Kamera wurde eingesteckt Unabh ngig vom Kamera Handle hf wird ignoriert Eine Kamera wurde entfernt Unabh ngig vom Kamera Handle hf wird ignoriert Der automatische Wei abgleich hat seine Rege lung beendet falls IS_SET_AUTO_WB_ONCE angegeben wurde Die automatische Helligkeitsregelung ist abge schlossen falls IS_SET_AUTO_WB_ONCE ange geben wurde Anwendungsfenster welches die Botschaft be kommt NULL deaktiviert die mit which bezeichne te Botschaft IS_SUCCESS oder IS_NO_SUCCESS FF FF Ge FF ZT 36 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 15 is_ExitCamera Syntax INT is_ExitCamera HIDS hf Beschreibung is_ExitCamera meldet den aktiven Device Handle hfab und gibt die durch die uEye Kamera besetzten Datenstrukturen und Speicherbereiche wieder frei Durch den Anwender allokierte Bildspeicher is_AllocImageMem die noch nicht freigegeben wurden werden durch is_ExitCamera freigegeben Im Allgemeinen ist das uEye SDK thread safe Die API Funktionsaufrufe erfolgen alle in critical sections Auf Grund interner DirectDraw Strukturen empfehlen wird dringend die folgenden
105. layMode e is_ExitCamera bergabeparameter phf Zeiger auf den Handle der Kamera Der Inhalt des Zeigers hat beim Aufruf der Funktion folgende Bedeutung 0 verwende die erste freie Kamera 1 254 ffne die Kamera mit dieser ID hWnd Handle auf das Fenster in dem das Bild dargestellt werden soll kann NULL sein R ckgabewert IS_SUCCESS Fehlercode siehe Header Datei 2000 2007 by IDS Imaging Development Systems GmbH 67 Benutzerhandbuch uEye Software Development Kit V2 40 4 53 is_lInitEvent Syntax INT is_InitEvent HIDS hf HANDLE hEv INT which Beschreibung Initialisiert den Event Handle durch Registrierung des im Parameter which angegebenen Event Objekts im Kernel Treiber bergabeparameter hf Handle auf Kamera hEv Event Handle von der C C Funktion CreateEventi which ID welches Event initialisiert werden soll IS_SET_EVENT_FRAME Ein neues Bild steht zur Verf gung IS_SET_EVENT_SEQ Die Sequenz wurde durchlaufen IS_SET_EVENT_STEAL Ein dem Overlay entzogenes Bild steht zur Verf gung IS_SET_EVENT_TRANSFER_FAILED Daten gingen w hrend der bertragung verloren IS_SET_EVENT_EXTTRIG Ein Bild dessen Aufnahme durch einen Trigger ausge l st wurde wurde komplett empfangen Dies ist der fr hest m glicher Zeitpunkt f r eine neue Aufnahme Das Bild muss noch das Postprocessing des Treibers durchlaufen und steht nach IS_FRAME zur Verarbeitung bereit IS_SET_EVENT_MEMORY_MODE_FINISH Die Bi
106. ldaufnahme in das optionale Memorymodul wur de beendet IS_SET_EVENT_REMOVE Eine mit is_InitCamera ge ffnete Kamera wurde ent fernt IS_SET_EVENT_DEVICE_RECONNECTED Eine mit is_InitCamera ge ffnete und danach entfern te Kamera wurde wieder eingesteckt IS_SET_EVENT_NEW_DEVICE Eine Kamera wurde neu angeschlossen Unabh ngig vom Device Handle hf wird ignoriert IS_SET_EVENT_REMOVAL Eine Kamera wurde entfernt Unabh ngig vom Device Handle hf wird ignoriert IS_SET_EVENT_WB_FINISHED Der automatische Wei abgleich hat seine Regelung beendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Frame event aktivieren Bildaufnahme starten und auf Event warten HANDLE hEvent CreateEvent NULL TRUE FALSE if hEvent NULL is_InitEvent hf hEvent IS_SET_EVENT_FRAME is_EnableEvent hf IS_SET_EVENT_FRAME is_FreezeVideo hf IS_DON_T_WAIT if WaitForSingleObject hEvent 1000 WAIT_OBJECT_O Bild Erfolgreich aufgenommen is_DisableEvent hf IS_SET_EVENT_FRAME is_ExitEvent hf IS_SET_EVENT_FRAME 68 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 54 is_InquirelmageMem Syntax INT is_InquirelmageMem HIDS hf char pcMem int nID Int pnX int pnY int pnBits Int pnPitch Beschreibung is_InquirelmageMem liest die Eigenschaften eines allokierten Bildsp
107. lesenen Bilder pro Sekunde zur ck bergabeparameter hf Handle auf Kamera dbIFPS Framerate R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 53 Benutzerhandbuch uEye Software Development Kit V2 40 4 34 is_GetFrameTimeRange Syntax INT is_GetFrameTimeRange HIDS hf double min double max double intervall Beschreibung Mit is_GetFrameTimeRange k nnen die m glichen Einstellungen der Framerate ausgelesen werden die f r die momentanen Einstellungen des Pixeltaktes m glich sind Die zur ckgege ben Werte geben die minimal und maximal m gliche Dauer eines Bildes in Sekunden an Die m gliche Framedauer kann zwischen min und max in intervall Schritten eingestellt werden fps min max fps max m n 1 n i de m n intervall m n m bergabeparameter hf Handle auf Kamera min Enth lt die minimal m gliche Dauer eines Bildes max Enth lt die maximal m gliche Dauer eines Bildes intervall Enth lt die Schrittweite mit der die Bilddauer ge ndert wer den kann R ckgabewert IS_SUCCESS IS_NO_SUCCESS 54 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 35 is_GetGlobalFlashDelays Syntax INT is_GetGlobalFlashDelays HIDS hf ULONG pulDelay ULONG pulDuration Beschreibung Mit der Funktion is_GetGlobalFlashDelays k nnen die ben tigten Zeiten ermittelt werden um eine globale Blitzf
108. n Bild aus einem Bildspeicher in einem angegebenen Fenster ausgegeben werden Zur Darstellung werden Win32 Bitmapfunktionen verwendet Die Darstel lung erfolgt generell in dem Format das beim Allokieren des Bildspeichers festgelegt wurde In der Funktion is_AlloclmageMem legt der Parameter bitspixel die Farbtiefe und die Darstel lungsart fest RGB16 und RGB 15 ben tigen denselben Speicherplatz k nnen aber anhand des Parameters bitspixel differenziert werden Das Farbformat UYVY ist nur im Overlaymode sinnvoll darzustellen Dieser ist mit den in is_RenderBitmap verwendeten Funktionen der Windows API aber nicht realisierbar bergabeparameter hf Handle auf Kamera nMemID ID des Bildspeichers der angezeigt werden soll hwnd Fenster Handle des Ausgabefensters nMode IS_RENDER_NORMAL Bild normal ausgeben Es wird 1 1 dargestellt so wie das Bild im Bildspeicher vorliegt IS_RENDER_FIT_TO_WINDOW Bild in das Ausgabefenster einpassen IS_RENDER_ DOWNSCALE 13 Bild mit 50 der Originalgr e Ausgeben Optionen die mit den o g logisch ODER verkn pft werden k nnen IS_RENDER_MIRROR_UPDOWN Gibt das Bild an der horizontalen Achse gespiegelt aus upsi de down R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiel Bild in Fenster einpassen und upside down darstellen is_RenderBitmap hf nMemID hwnd IS_RENDER_FIT_TO_WINDON IS_RENDER_MIRROR_UPDOWN EEN 82 2000 2007 by IDS Imaging Development System
109. nEnable IS_BL_COMPENSATION_DISABLE Schaltet die Kompensation aus IS_BL_COMPENSATION_ENABLE Aktiviert die Blacklevel Kompensation unter Verwendung des eingestellten Offset Werts IS_GET_BL_COMPENSATION Gibt den aktuellen Modus zur ck IS_GET_BL_OFFSET Gibt den aktuellen Offset zur ck IS_GET_BL_DEFAULT_MODE Gibt den Standard Modus zur ck IS_GET_BL_DEFAULT_OFFSETE Gibt den Standard Offset zur ck IS_GET_BL_SUPPORTED_MODE Gibt die unterst tzten Modi zur ck M gliche Werte IS_BL_COMPENSATION_ENABLE Der verwendete Sensor unterst tzt Blacklevel Kompensation IS_BL_COMPENSATION_OFFSET Beim verwendeten Sensor kann der Offset der Blackle vel Kompensation eingestellt werden IS_IGNORE_PARAMETER Der Parameter nEnable wird ignoriert offset Beinhaltet den offset der f r die Kompensation verwendet wird G ltige Werte liegen zwischen 0 und 255 IS_IGNORE_PARAMETER Der Parameter offset wird ignoriert R ckgabewert IS_SUCCESS IS_NO_SUCCESS aktuelle Einstellung bei IS_GET_BL_COMPENSATION oder eingestellten Offset bei IS_GET_BL_OFFSET eege 100 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 86 is_SetBrightness Syntax INT is_SetBrightness HIDS hf INT Bright Beschreibung is_SetBrightness verstellt die Helligkeit des Bildes digital Der bergabeparameter Bright darf die Werte 0 255 annehmen Die Ver nderung der Helligkeit wird durch die Ver nderung des Luminanzwertes
110. nde Autofunktionalit t verwendet Als De faultwert ist das Fenster immer maximal also immer so gro wie das aktuelle Image AOI Nach nderungen der Bildgeometrie z B durch Neusetzen eines Image AOI werden die Auto Feature AOI immer auf den Wert des zuvor eingestellten Image AOI zur ckge setzt Das bedeuted dass die Auto Feature AOI eventuell neu gesetzt werden m ssen Neben Image AOI sind Binning und Subsampling weitere die Bildgeometrie beeinflus sende Funktionen Auto Whitebalance AOI ist im DirectDraw Modus und im UYVY Modus nicht verf gbar Mit den Funktionen is_SetImagePos siehe 4 111 is _SetImagePos und is_SetimageSize siehe 4 112 is_SetImageSize k nnen Informationen ber die Gr e und Position des AOI ausgelesen werden bergabeparameter hf Handle auf Kamera type IG GET IMAGE AC Image AOI setzen IS_GET_IMAGE_AOI Gibt das aktuelle Image AOI zur ck IS_SET_AUTO_BRIGHT_AOI Mittelwert AOI f r Auto Gain und Auto Shutter setzen IS_GET_AUTO_BRIGHT_AOI Gibt das aktuelle Mittelwert AOI zur ck IS_SET_AUTO_WB_AOI AOI f r Auto Whitebalance setzen IS_GET_AUTO_WB_AOI Gibt das aktuelle Auto Whitebalance AOI zur ck pXPos Horizontale Position des AOI pYPos Vertikale Position des AOI pWidth Breite des AOI pHeight H he des AOI R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 91 Benutzerhandbuch uEye Software Development Kit V2 40 Beispiele Auto
111. ng HIDS hf INT mode Beschreibung Mit is_SetSubSampling kann sowohl in horizontaler als auch in vertikaler Richtung der Sub sampling Modus aktiviert werden Je nach Sensor ist neben zweifachem auch vierfaches Sub sampling m glich Bei zweifachem Subsampling wird jeder zweite Pixel bersprungen wodurch sich die Bildgr e je Subsamplingrichtung halbiert und die Framerate erh ht Dies entspricht einer Hardware Ska lierung des Bildes von 2 1 Bei Farbkameras wird aus technischen Gr nden 4 2 Subsampling verwendet bei dem jeweils zwei Pixel ausgelesen und zwei Pixel bersprungen werden Der Sensor der UI 154x M f hrt bauartbedingt nur ein Color Subsampling durch Dies kann bei feinen Bildstrukturen zu leichten Artefakten f hren Monochrom Sensor Color Sensor Column Horizontal Column Horizontal abedefghijkimnopgr abcdefghijkimnopagr Row Vertical osonourwumw o Row Vertical oonourumnm o Abb 13 zweifaches Subsampling Abb 14 zweifaches Subsampling Column Horizontal Column Horizontal abcdefghijkimnopagr abcdefghijkimnopagr Row Vertical Row Vertical oonourwom o 0 k 2 3 4 5 6 7 8 9 Abb 15 vierfaches Subsampling Abb 16 vierfaches Subsampling a E 2000 2007 by IDS Imaging Development Systems GmbH 135 Benutzerhandbuch uEye Software Development Kit V2 40 bergabeparameter hf Handle auf Kamera mode IS_SUBSAMPLING_DISABLE Deaktiviert das Subsampling IS_SUBSAMPLING_2X_VERTI
112. poration Alle anderen Produkte oder Firmenna men die namentlich in diesem Handbuch erw hnt werden dienen nur zum Zwecke der Identifi kation oder der Beschreibung und k nnen Warenzeichen oder eingetragene Warenzeichen der jeweiligen Eigent mer sein Kontaktaufnahme Besuchen Sie unsere Internetseite Hier erhalten Sie die neuesten Treiber und Informationen zu unserer Soft und Hardware sowie zu unseren Partnern und H ndlern Internet http www ueye de http www ids imaging de Anschrift IDS Imaging Development Systems GmbH Dimbacher Strasse 6 D 74182 Obersulm Fax 07134 96196 99 Email Vertrieb sales ids imaging de Support support ids imaging de ii 2000 2007 by IDS Imaging Development Systems GmbH Inhaltsverzeichnis 1 Einleitung ss ee 1 2 Gelee TTT 2 2 1 Programmierung unter Visual C 6 0 7 0 und 7 1 uursnseessensnsnnnnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnen 2 2 2 Programmierung unter Visual Basel 2 2 3 CAMINFO Datenstruktur des EEPROMS 240rsnnsnsnsnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnannnnnnn nenn 2 2 4 Farb und Speicherformate AAA 3 2 5 Ee Eet EE 4 3 Funktionsbl cke 2 u022440000400040n0080nJnnnnUEnnnn Zusam nnnn nn un nn EENS ENEE EENEG 7 3 1 Initialisierung und Temminierung nen 7 3 2 Bilderfassung und Gpeichermanagement esessseeseesieesieeieesististtinttintttnttnnttnnntnnttnnntnnntnnnennnnene t 7 3 3 Auswahl der Betrieb
113. quence liefert is_GetlmageMem den zuvor aktiven Bildspeicher zur ck bergabeparameter hf Handle auf Kamera pMem Zeiger auf den Anfang des Bildspeichers R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 57 Benutzerhandbuch uEye Software Development Kit V2 40 4 38 is_GetlmageMemPitch Syntax INT is_GetlmageMemfPitch HIDS hf INT pPitch Beschreibung is_GetlmageMemPitch gibt den Zeileninkrement in Bytes zur ck Der Zeileninkrement ist die Anzahl Bytes vom Beginn einer Zeile bis zum Beginn der n chsten Zeile Das Zeileninkrement kann u U gr er sein als aus den beim Aufruf von is_AlloclmageMem bergebenen Parame tern ersichtlich ist Das Zeileninkrement ist immer eine durch 4 teilbare Anzahl Bytes siehe 4 2 is_AlloclmageMem Der Zeileninkrement berechnet sich zu line width bitspixel 1 8 lineinc line adjust adjust 0 wenn line ohne Rest durch 4 teilbar ist adjust 4 rest line 4 wenn line nicht ohne Rest durch 4 teilbar ist bergabeparameter hf Handle auf Kamera pPitch Zeiger auf Variable die dann den Zeileninkrement enth lt R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 39 is_GetLastMemorySequence Syntax INT is_GetLastMemorySequence HIDS hf INT pID Beschreibung Die Funktion is_GetLastMemorySequence gibt die ID der zuletzt aufgenommenen Sequenz im Memoryboard zur ck Dieser Parameter kann dann in Verbindung mi
114. r Konvertierung e Farbmodus e Gamma e White Balance Multipliers bergabeparameter Hf Handle auf Kamera ColorCorrection Aktiviert deaktiviert die Farbkorrektur BayerConversionMode Setzt den Bayer Konvertierungs Modus IS_SET_BAYER_CV_BETTER Bessere Qualit t IS_SET_BAYER_CV_BEST Beste Qualit t h here CPU Belastung ColorMode sets the color mode of the output image IS_SET_CM_RGB32 32 Bit True Colour Mode R G B Dummy IS_SET_CM_RGB24 24 Bit True Colour Mode R G B IS_SET_CM_RGB16 Hi Colour Mode 5R 6G 5B IS_SET_CM_RGB15 Hi Colour Mode 5R 5G 5B IS_SET_CM_Y8 8 Bit Monochrome Bild IS_SET_CM_UYVY 16 Bit UYVY Format Gamma Gammawert multipliziert mit 100 Bereich 1 1000 WhiteBalanceMultipliers Zeiger auf ein Array mit der Rot Gr n und Blauverst rkung R ckgabewert IS_SUCCESS IS_NO_SUCGESS IS_INVALID_COLOR_FORMAT oder IS_INVALID_PARAMETER Beispiel Siehe 4 6 is_Convertlmage 2000 2007 by IDS Imaging Development Systems GmbH 105 Benutzerhandbuch uEye Software Development Kit V2 40 4 92 is_SetDDUpdateTime Syntax INT is_SetDDUpdateTime HIDS hf INT ms Beschreibung is_SetDDUpdateTime setzt das Timer Intervall f r den Update Zyklus des Videobildes im Di rectDraw BackBuffer Modus G ltige Werte sind 20ms bis 2000ms bergabeparameter hf Handle auf Kamera ms Zeit in Millisekunden R ckgabewert IS_SUCCESS IS_NO_SUCCGESS 106 2000 2007 by IDS Imaging Development Systems GmbH
115. r der Blitz eingeschaltet wird in us R ckgabewert IS_SUCCESS IS_NO_SUCCESS aktuelle Einstellungen in Verbindung mit IS_GET_FLASH_DELAY oder IS_GET_FLASH_DURATION DESSERT 2000 2007 by IDS Imaging Development Systems GmbH 113 Benutzerhandbuch uEye Software Development Kit V2 40 4 100 is_SetFlashStrobe Syntax INT is_SetFlashStrobe HIDS hf INT nMode INT nLine Beschreibung is_SetFlashStrobe schaltet den Flash Strobe ein Dabei kann ber den Parameter nMode die Ansteuerung aktiviert oder deaktiviert werden Au erdem l sst sich der aktive Level high oder low setzen Per Default ist der Strobe high aktiv Mit den Konstanten IS_SET_FLASH_HIGH und IS_SET_FLASH_LOW kann der Strobe Aus gang als digitaler Ausgang genutzt werden Die Dauer des Blitzes und die Ausl severz gerung kann ber die Funktion is_SetFlashDelay siehe 4 99 is SetFlashDelay eingestellt werden F r Kameras mit Rolling Shutter Sensoren wird empfohlen die Werte aus der Funktion is_GetGlobalFlashDelays siehe 4 35 is _GetGlobalFlashDelays als Ausl severz gerung und Blitzdauer zu verwenden da es sonst zu unerwarteten Ergebnissen kommen kann Beim Blitzen im Capturemodus ist hierauf beson ders zu achten F r die Modi high aktiv und low aktiv muss der jeweilige Parameter passend zum Kameramo dus gew hlt werden IS_SET_FLASH_LO ACTIVE und IS_SET_FLASH_HI ACTIVE werden f r den Triggermodus siehe 4 98 is_SetExternalTrigger ben tigt I
116. rd kann zus tzlich gepr ft werden ob ein bertragungsfehler oder ein Fehler im Pixelpfad aufgetreten ist bergabeparameter hf Handle auf Kamera pbo pbo IS_TRANSFER_FAILED vor dem Funktionsaufruf pbo enth lt den Digitalisierstatus IS_VIDEO_NOT_FINISH Bild noch nicht fertig digitalisiert IS_VIDEO_FINISH Bild ist fertig digitalisiert pbo IS_TRANSFER_FAILED vor dem Funktionsaufruf pbo enth lt den Digitalisierstatus IS_VIDEO_NOT_FINISH Bild noch nicht fertig digitalisiert IS_VIDEO_FINISH Bild ist fertig digitalisiert IS_TRANSFER_FAILED bertragungsfehler oder Problem beim Konvertieren z B Zielspei cher ung ltig R ckgabewert IS_SUCCESS IS_NO_SUCCESS 70 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 57 is_LoadBadPixelCorrectionTable Syntax INT is_LoadBadPixelCorrectionTable HIDS hf char File Beschreibung is_LoadBadPixelCorrectionTable l dt eine zuvor mit der Funktion SaveBadPixelCorrection Table gespeicherte Tabelle File gibt die Datei an in der die Koordinaten gespeichert wurden bei bergabe eines NULL Zeigers wird ein Dialog zur Auswahl der Datei angezeigt bergabeparameter hf Handle auf Kamera File Zeiger auf Datei mit gespeicherten Koordinaten Es kann so wohl der absolute als auch der relative Pfad bergeben wer den R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 58 is_Loadimage Syntax INT is_LoadlImage HIDS h
117. riggermodus einschalten und High Active Blitzmodus setzen is_SetExternalTrigger hf IS_SET_TRIG_SOFTWARE is_SetFlashStrobe hf IS_SET_FLASH_HI_ACTIVE 0 is_FreezeVideo hf IS_WAIT 4 101 is_SetFrameRate Syntax INT is_SetFrameRate HIDS hf double FPS double newFPS Beschreibung Durch Aufruf der Funktion is_SetFrameRate kann die gew nschte Anzahl an Bildern pro Se kunde mit der der Sensor arbeitet gesetzt werden Wird die Framerate zu hoch eingestellt kann nicht mehr jedes Bild eingelesen werden wodurch die tats chliche Framerate absinkt Da hier ebenfalls wie bei der Exposure Zeit nicht jeder beliebige Wert eingestellt werden kann wird nach Aufruf dieser Funktion die neue Framerate ber den Parameter newFPS zur ckge geben Genauere Details hierzu befinden sich in der Beschreibung zum uEye Timing hnlich wie bei der Exposure Zeit wirken sich nderungen an der Fenstergr e oder an dem Pixelclock auf die Framerate aus Die Framerate beeinflussende Funktionen e is _SetlmageSize e is_SetPixelClock bergabeparameter hf Handle auf Kamera FPS Gew nschte Anzahl an Bildern pro Sekunde IS_GET_FRAMERATE Gibt nur die aktuelle Framerate ber den Parameter newFPS zur ck IS_GET_DEFAULT_FRAMERATE Gibt den Standard Framerate zur ck newFPS Gibt die tats chlich eingestellte Framerate zur ck R ckgabewert IS_SUCCESS oder IS_NO_SUCCESS 116 2000 2007 by IDS Imaging Development Systems GmbH Kapit
118. rt EN SetExternalTrigger SetMemoryMode A CaptureVideo KH SetExternalTrigger gt N Save Image to Memory assign SequencelD a assign Imagelndex n E increment Imagelndex n Image n 1 N Io Image n 2 N We l Sa mage at position Image n N IN ya N n StopLiveVideo Timeout 3 Ki Es S yes f AN IN es Timeout Trigger SCH gt lt f N X SS 8 by N Ba es Y i NO SUCCESS success Abb 8 Pre Trigger Modus Post Trigger In diesem Modus wird mit der Bildaufnahme erst begonnen nachdem das Triggersignal regis triert wurde e Vorbereitung Mit der Funktion is_SetExternalTrigger wird der Triggereingang der Kamera aktiviert Die Kamera wird mit der Funktion is_SetMemoryMode f r die Speicherung vorbereitet Ne ben der Anzahl an Bildern die aufgenommen werden soll wird hier noch die Zeit zwischen zwei Aufnahmen angegeben Die maximal m gliche Anzahl Bilder die im Speicher gehalten werden k nnen ist abh ngig von der eingestellten Bildgr e weshalb diese nach Akti vierung des Memorymodus nicht mehr zu ndern ist Die Reihenfolge der Funktionen is_SetIMemoryMode und is_SetExternalTrigger ist beliebig Wird mit is_SetExternalTrigger hCamera IS_SET_TRIG_OFF der Trigger deaktiviert so wird die Auf nahme direkt beim Aufruf von is_FreezeVideo gestartet 2000 2007 by IDS Imaging Development Systems GmbH 15 Benutzerhandbuch uEye Sof
119. rt IS_SUCCESS Das Bild wurde fehlerfrei geladen IS_FILE_READ_INVALID_BMP_ID Das Bitmapformat des zu ladenden Bildes ist nicht g ltig IS_FILE_READ_OPEN_ERROR Die Datei kann nicht ge ffnet werden 72 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 60 is_LoadParameters Syntax INT is_LoadParameters HIDS hf char pFilename Beschreibung is_LoadParameters l dt die Parameter einer Kamera die zuvor mit is_SaveParameters als ini Datei gespeichert wurden Wird f r pFilename der Wert NULL bergeben wird der Datei ff nen Dialog von Windows angezeigt a a a a a ul Es k nnen nur kameraspezifische ini Dateien geladen werden Beim Laden einer ini Datei ist zu ber cksichtigen dass bereits allokierter Speicher den Parame tern des ini Files hinsichtlich Bildgr e AOI und Farbtiefe bereinstimmt Wenn das nicht der Fall ist f hrt dies zu Darstellungsfehlern bergabeparameter hf Handle auf Kamera pFilename Zeiger auf Dateiname Es kann sowohl der absolute als auch der relative Pfad bergeben werden R ckgabewert IS_SUCCESS IS_NO_SUCCGESS Beispiel ini Datei Sensor Sensor Ul122x M Image size Start X 0 Start Y 0 Start X absolute 0 Start Y absolute 0 Width 752 Height 480 Binning 0 Subsampling 0 Timing Pixelclock 20 Framerate 30 003810 Exposure 33 329100 Parameters Colormode 6 Brightness 100 Contrast 215 Gamma 1 000000 Blacklevel
120. rt von 0 255 IS_GET_AUTO_REFERENCE Gibt den Sollwert f r AutoGain AutoShutter zur ck IS_SET_AUTO_GAIN_MAX Obere Regelgrenze f r AutoGain setzen IS_GET_AUTO_GAIN_MAX Gitbt die obere Regelgrenze f r AutoGain zur ck IS_SET_AUTO_SHUTTER_MAX Obere Regelgrenze f r AutoShutter setzen IS_ IS_ IS_ GET_AUTO_SHUTTER_MAX SET_AUTO_SPEED GET_AUTO_SPEED SET_AUTO_WB_OFFSET GET_AUTO_WB_OFFSET SET_AUTO_WB_GAIN_RANGE GET_AUTO_WB_GAIN_RANGE SET_AUTO_WB_SPEED GET_AUTO_WB_SPEED SET_AUTO_WB_ONCE GET_AUTO_WB_ONCE pvali pval2 Gibt die obere Regelgrenze f r AutoShutter zur ck Setzt den Geschwindigkeitswert der Autofunktion Gibt den Geschwindigkeitswert der Autofunktion zu r ck Setzt den Offset f r den roten und blauen Kanal Gibt die Offsetwerte f r den roten und blauen Kanal zur ck Setzt die Regelgrenzen der Auto Whitebalance Funkti on Gibt den Regelbereich der Auto Whitebalance Funkti on zur ck Setzt die Geschwindigkeit der Auto Whitebalance Funktion Gibt den Geschwindigkeitsbereich der Auto Whiteba lance Funktion zur ck Setzt das automatische Abschalten der Auto Whiteba lance Funktion Gibt den Zustand der automatischen Abschaltung zu r ck bergabeparameter Wert bergabeparameter Wert Die Parameter pvalT und pval2 k nnen je nach verwendetem Typ des Parameters param un terschiedliche Werte annehmen Auto Brightness Funktion F r die Enable Paramet
121. rung und Terminierung Funktionsliste is_ExitCamera is_InitCamera is_LoadParameters is_SaveParameters is_SetCameralD Schlie en der Kamera und Freigeben der mit dem SDK ange legten Bildspeicher Initialisierung der Hardware Laden und anwenden der Kamera Parameter Speichert die aktuellen Kamera Parameter Setzt eine neue Kamera ID Tabelle 3 Funktionsliste Initialisierung und Terminierung 3 2 Bilderfassung und Speichermanagement Funktionsliste is_AlloclmageMem is_CaptureVideo is_Convertlmage is_CopylmageMem is_CopylmageMemLines is_FreelmageMem is_FreezeVideo is_GetActivelmageMem is_GetBusSpeed is_GetlmageHistogram is_GetlmageMem is_GetlmageMemPitch is_HasVideoStarted is_InquirelmageMem is_IsVideoFinish is_SavelmageMem is_SetAllocatedlmageMem is_SetBayerConversion is_SetlmageMem is_SetTestlmage is_StopLiveVideo Bildspeicher anlegen Live Video erfassen Wandelt ein RAW Bayer Bild in das gew nschte Format um Bild in vom Anwender definierten Speicher kopieren Ausgew hlte Zeilen des Bildes in vom Anwender definierten Speicher kopieren Einen allokierten Bildspeicher wieder freigeben Ein Bild erfassen und auf Zielbildspeicher schreiben Snap Gibt Nummer und Adresse des aktiven Bildspeichers zur ck Pr fen ob Kamera an einem USB 2 0 Hostcontroller ange schlossen ist Berechnet das Histogramm der bergebenen Abbildung Gibt den Anfangszeiger auf den Bildspeicher zur ck Gibt den Zeilenoffset n zu n 1
122. s GmbH Kapitel 4 Beschreibung der Funktionen 4 70 is_ResetMemory Syntax INT is_ResetMemory HIDS hf INT reserved Beschreibung Gespeicherte Bilddaten bleiben im Speicher des Memoryboards erhalten solange die Kamera mit Strom versorgt wird Dadurch ist der Zugriff auf die Daten solange m glich bis der Speicher des Memoryboards durch den Aufruf von is_ResetMemory gel scht wird bergabeparameter hf Handle auf Kamera reserved Wird aktuell nicht verwendet R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 71 is_ResetToDefault Syntax INT is_ResetToDefault HIDS hf Beschreibung is_ResetToDefault setzt alle Parameter auf die kameraspezifischen Standardwerte zur ck bergabeparameter hf Handle auf Kamera R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 83 Benutzerhandbuch uEye Software Development Kit V2 40 4 72 is_SaveBadPixelCorrectionTable Syntax INT is_SaveBadPixelCorrectionTable HIDS hf char File Beschreibung is_SaveBadPixelCorrectionTable speichert die aktuelle benutzerdefinierte Hotpixelliste in die mit dem Parameter File angegebene Datei Bei bergabe des Wertes NULL f r den Parameter File wird ein Dialog zur Dateiauswahl ange zeigt bergabeparameter hf Handle auf Kamera File Zeiger auf die Datei in der die Daten gespeichert werden Es kann sowohl der absolute als auch der relative Pfad berge ben werden R ckgabewert
123. s_HasVideoStarted K is_HideDDOverlay KI is_InquirelmageMem Il L L is_IsVideoFinish K K is_Loadlmage K is_LoadlmageMem KI is_LockDDMem K is_LockDDOverlayMem is_LockSegBuf SI is_PrepareStealVideo K is_ReleaseDC is_RenderBitmap KI is_Savelmage K is_SavelmageEX K is_SavelmageMem EN L is_SavelmageMemEx EN L is_SetAllocatedlmageMem K is_SetBayerConversion KI is_SetBinning K K is_SetColorMode SI is_SetConvertParam EN is_SetDisplayMode K DI is_SetDisplayPos K is_SetHwnd K is_SetlmageMem EN is_SetlmagePos K K 20 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke is_SetlmageSize is_SetKeyColor is_SetRopEffect is_SetSaturation is_SetSubSampling is_ShowDDOverlay is_StealVideo is_StopLiveVideo is_UnlockDDMem is_UnlockDDOverlayMem is_UnlockSegBuf is_UpdateDisplay nur im Stealmode Speicher in DD Modes nicht notwendig Tabelle 15 G ltigkeit der Funktionen DirectDraw wird unter LINUX nicht unterst tzt 2000 2007 by IDS Imaging Development Systems GmbH 21 Benutzerhandbuch uEye Software Development Kit V2 40 3 14 Nicht unterst tze Funktionen Die nachfolgend aufgef hrten Funktionen sind spezielle Funktionen f r die FALCON Framegrab ber Familie und werden von der uEye Kamera Familie nicht unterst tzt is_GetCurrentField is_GetIRQ is_GetPciSlot is_OvISurfaceOffWhileMove is_ScaleDDOverlay is_SetAGC is_SetCaptureMode is_SetD
124. s_SetAllocatedlmageMem Zus tzlich muss wie bei is_AlloclmageMem die Gr e des Bildes angegeben werden Eine Speicher ID wird zur ckgegeben Diese wird f r andere Funk tionen evtl ben tigt is_SetAllocatedIlmageMem hf width height bitspixel pcMem amp ID size gt width height bitspixel 8 Der Bildspeicher kann nun wie blich verwendet werden Sequenzen sind ebenso m glich Der Speicherbereich muss mit der Funktion is_FreelmageMem hf pcMem ID wieder aus der Treiber Verwaltung genommen werden Hierbei wird der Speicher jedoch NICHT freigegeben Der Benutzer muss daf r sorgen dass der Speicher freigegeben wird e GilobalUnlock hgMem e GilobalFree hgMem bergabeparameter hf Handle auf Kamera width Breite des Bildes height H he des Bildes bitspixel Farbtiefe des Bildes Bits pro Pixel pcimgMem Zeiger auf den Speicheranfang des allokierten Speichers pid Enth lt dann die ID f r diesen Speicher R ckgabewert IS_SUCCESS IS_NO_SUCCESS ee 90 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 79 is_SetAOl Syntax INT is_SetAOlI HIDS hf INT type INT pXPos INT pYPos INT pWidth INT pHeight Beschreibung Mit is_SetAOl kann die Gr e und Position eines AOI ber einen Befehlsaufruf gesetzt wer den M gliche AOI sind e Image AOI e Auto Brightness AOI e Auto Whitebalance AOI Die Auto Bildbereiche werden f r die entspreche
125. schen 0 und 255 Die Board ID ist ung ltig G ltige IDs liegen zwischen 1 und 255 Alle Kameras sind in Verwendung Ein Timeout trat auf Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden Einer der bergebenen Parameter ist ausserhalb des g l tigen Bereichs oder f r diesen Sensor nicht unterst tzt bzw in diesem Modus nicht zug nglich Es konnte kein Speicher allokiert werden Die Kamera ist an einem Port verbunden der nicht den High Speed Standard USB 2 0 unterst tzt Kameras ohne Speicher k nnen nicht an USB 1 1 Ports betrieben wer den Es l uft bereits eine Aufnahme die beendet werden muss bevor eine neue begonnen werden kann 2000 2007 by IDS Imaging Development Systems GmbH 147 Benutzerhandbuch uEye Software Development Kit V2 40 Nr 141 143 144 145 147 148 151 152 153 154 155 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 Fehler IS_MEMORY_BOARD_ACTIVATED IS_NO_MEMORY_BOARD_CONNECTED IS_TOO_LESS_MEMORY IS_IMAGE_NOT_PRESENT IS_MEMORYBOARD_DISABLED IS_TRIGGER_ACTIVATED IS_CRC_ERROR IS_NOT_YET_RELEASED IS_NOT_CALIBRATED IS_WAITING_FOR_KERNEL IS_NOT_SUPPORTED IS_OPERATION_ABORTED IS_BAD_STRUCTURE_SIZE IS_INVALID_BUFFER_SIZE IS_INVALID_PIXEL_CLOCK IS_INVALID_EXPOSURE_TIME IS_AUTO_EXPOSURE_RUNNING IS_CANNOT_CREATE_BB_SURF IS_CANNOT_CREATE_BB_MIX IS_BB_OVLMEM_N
126. sfer Post Processing e Delay IS_TRIGGER IS_FRAME Abb 5 Events bei Einzeltriggeraufnahme Events im Livemodus Sequenz mit 3 Bildern Pe is_CaptureVideo e l Jo H Exposure Transfer Post Processing IS_FRAME IS_FRAME IS_FRAME IS_FRAME y IS_SEQUENCE IS_STEAL_VIDEO Abb 6 Events im Livemodus 2000 2007 by IDS Imaging Development Systems GmbH 11 Benutzerhandbuch uEye Software Development Kit V2 40 Events im Memorymodus is_SetMemoryMode 3 is_Transferlmage 1 is_Freezelmage is_Transferlmage 2 is_Transferlmage 3 Exposure Storage Transfer Post Processing IS_FRAME IS_FRAME IS_FRAME v IS_MEMORY_MODE_FINISH Abb 7 Events im Memorymodus 3 10 Steuerung der Ein Ausg nge Funktionsliste is_ForceTrigger Ausl sen eines Hardwaretriggers is_GetGlobalFlashDelays Verz gerungs und Einschaltzeit des Blitzausgangs bei Rol ling Shutter Sensoren ermitteln is_SetExternalTrigger Aktiviert den externen Triggereingang oder liest den anlie genden Signalpegel aus is_SetFlashDelay Verz gerungs und Einschaltzeit des Blitzausgangs setzen is_SetFlashStrobe Setzt den Flash Strobe Ausgang Blitzansteuerung oder die statische Ausgabe is_SetlO nur UI 1543 M Setzen der zus tzlichen digitalen Ausg nge is_SetTriggerDelay Verz gerungszeit des Triggersignals einstellen
127. smodi und R cklesen der Eimnstellungen 8 3 4 Double und Mehrfach Buffering AAA 9 3 5 Lesen und Schreiben des EEDROMS nn 9 3 6 Speichern und Laden von Bildern nen 9 KENE EE 9 3 8 Zus tzliche DirectDraw Funktionen ssesssessseessessseesseessrssnntntsnntnntnnstnnnttnuttnunnnnstnnnnnnnnnnnsnnnnnn nnn 10 3 9 Event Handling Interrupt gesteuerter Bideinzug 10 3 10 Steuerung der Ein Ausg nge 12 3 11 DC Funktionen nur ue EI 12 3 12 Memory Handling der Kamera AA 13 3 13 G ltigkeit in Darsitellungemoct nunne nnen 20 3 14 Nicht unterst tze Funktionen nn 22 4 Beschreibung der Funktionen uu 2 us4000nn000nnnnnannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnannnnannnnnn 23 4 1 iS ele Be Ee EE 24 4 2 je AlloelmageMem 4 2 221 aea Rees 25 kO EE E 26 4 4 iS Capture le E DEE 27 4 5 Ce Ee Ee 28 4 6 i5 Convetlmage EE 29 47s i ee Ou Et E EE 20 4 8 Je Copvlmagekeml nes EN 4 9 IS DisableBDOverlay uu ru 1 0 una lknenanns nad NEeeEEE CERN 31 2 10 18DisableEVent un s2 unke rule 32 dt e Enabienglobwikzs eessen S Seege 33 4 12 is EnableDDOVENay EE 34 2000 2007 by IDS Imaging Development Systems GmbH iji Benutzerhandbuch uEye Software Development Kit V2 40 4 13 1S EnableEvent 2 R ner Eheim 35 4 14 Is Enablekessage sicilianino aniidae iaiaaeaia aaidaki atandan 36 4 15 Is O EIE E E E E E T E E E E E T 37 4 16 IS EE 38 4 17 18 Force Re Le EE 39 S ST
128. speichers is_GetDDOvISurface Gibt Zeiger auf DirectDraw Surface zur ck is_HideDDOverlay Blendet das Overlay aus is_LockDDMem Freigabe des Zugriffs auf Back Buffer der VGA Karte is_LockDDOverlayMem Gibt den Zugriff auf den Overlayspeicher frei is_ReleaseDC Freigabe Device Context Handle des Overlays is_SetDDUpdateTime Timer Intervall f r den Update Zyklus setzen is_SetKeyColor Setzt die Keying Farbe f r die Overlay Darstellung is_ShowDDOverlay Overlay anzeigen is_StealVideo Stiehlt ein Bild aus einem DirectDraw Live Modus und legt dieses im Bildspeicher im RAM ab is_UnlockDDMem Sperrt Zugriff auf den Back Buffer der VGA Karte is_UnlockDDOverlayMem Sperrt den Zugriff auf den Overlayspeicher Tabelle 10 Funktionsliste Zus tzliche DirectDraw Funktionen 3 9 Event Handling Interrupt gesteuerter Bildeinzug Funktionsliste is_DisableEvent Sperren der Event Objekte is_EnableEvent Freigabe der Event Objekte is_EnableMessage Ein ausschalten der Windows Benachrichtigungen is_ExitEvent Verlassen des Event Handlers is_InitEvent Einrichten des Event Handlers is_EnableAutoExit Kamera Ressourcen werden beim Abziehen des USB Kabels automatisch freigegeben Tabelle 11 Funktionsliste Event Handling 10 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke Events bei Einzeltriggeraufnahme is_SetExternalTrigger IS_SET_TRIG_HI_LO is_Freezelmage Trigger Exposure il Tran
129. ssen 46 2000 2007 by IDS Imaging Development Systems GmbH Kapitel4 Beschreibung der Funktionen 4 24 is_GetCameralnfo Syntax INT is_GetCameralnfo HIDS hf PCAMINFO plnfo Beschreibung Die Funktion is_GetCameralnfo liest die fest im EEPROM hinterlegten Daten aus und schreibt diese in die Datenstruktur auf die plnfo zeigt Die Datenstruktur ist in Kapitel 2 3 CAMINFO Da tenstruktur des EEPROMS beschrieben Das Lesen und Schreiben eigener Daten in und aus dem EEPROM wird ber die Funktionen is_ReadEEPROM und is_WriteEEPROM durchgef hrt bergabeparameter hf Handle auf Kamera piInfo Zeiger auf eine Datenstruktur CAMINFO R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 47 Benutzerhandbuch uEye Software Development Kit V2 40 4 25 is_GetCameralist Syntax INT is_GetCameralist PUEYE_CAMERA_LIST pucl Beschreibung Mit der Funktion is_GetCameraList k nnen Informationen ber die angeschlossenen Kameras abgefragt werden In den nachfolgenden Tabellen werden die verwendeten Strukturen erl utert UEYE_CAMERA_LIST ULONG dwCount Anzahl der am System angeschlossenen Kameras UEYE_CAMERA_INFO uci 1 Platzhalter f r 1 n Strukturen UEYE_CAMERA_INFO UEYE_CAMERA_INFO DWORD dwCameralD Benutzerdefinierbare Kamera ID DWORD dwDevicelD Systeminterne Ger te ID DWORD dwSensorlD Sensor ID DWORD dwInUse 1 Kamer in Verwendung 0 Kamera nicht in Verwendung
130. sten Wertes verwenden wird Durch Setzen eines Wertes wird die Auto Funktionalit t wieder deaktiviert siehe auch 4 105 is_SetHardwareGain Die AutoExposure Funtkionalit t kann mit der Funktion is_SetExposureTime aktiviert werden wenn der Parameter IS_SET_ENABLE_AUTO_SHUTTER verwendet wird Durch Setzen eines Wertes wird die Auto Funktionalit t wieder deaktiviert siehe auch 4 97 is_SetExposure Time R ckgabewert IS_SUCCESS IS_NO_SUCCESS Beispiele Auto Gain aktivieren Double dEnable 1 int ret is_SetAutoParameter m_hCam IS_SET_ENABLE_AUTO_GAIN amp dEnable 0 Helligkeitssollwert auf 128 stellen double soll 128 int ret is_SetAutoParameter m_hCam IS_SET_AUTO_REFE 0 ro 0 ENCE amp soll 2000 2007 by IDS Imaging Development Systems GmbH 95 Benutzerhandbuch uEye Software Development Kit V2 40 Shutter Regelgrenze zur cklesen double maxShutter int ret is_SetAutoParameter m_hCam IS_GET_AUTO_SHUTTER_MAX amp max Shutter Di 4 81 is_SetBadPixelCorrection Syntax INT is_SetBadPixelCorrection HIDS hf INT nEnable INT threshold Beschreibung is_SetBadPixelCorrection schaltet die Hotpixel Korrektur ein oder aus Dabei kann zwischen drei unterschiedlichen Varianten gew hlt werden bergabeparameter hf Handle auf Kamera nEnable IS_BPC_DISABLE Schaltet die Korrektur aus IS_BPC_ENABLE_HARDWARE Aktiviert die Har
131. t Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 52 is_InitCamera Syntax INT is_InitCamera HIDS phf HWND hWnd Beschreibung is_InitCamera ffnet den Treiber und stellt den Kontakt zur Hardware her In dieser Funktion wird nach erfolgreicher Initialisierung das Handle auf die Kamera vergeben Alle nachfolgenden Funktionen ben tigen diesen Handle als ersten Parameter Wenn kein DirectDraw zur Bildaus gabe verwendet wird kann hWnd NULL bergeben werden Damit mehrere uEye Kameras parallel in einem System arbeiten k nnen Multikamera Betrieb muss bei der Initialisierung entschieden werden welche Kamera initialisiert werden soll Im EEPROM ist eine Kamera ID festgelegt siehe auch 4 24 is GetCameralnfo bzw die Struktur IDSINFO mit dem Eintrag Select Soll mit is_InitCamera eine bestimmte Kamera angespro chen werden so muss zuvor das Handle hfmit der gew nschten Kamera ID initialisiert werden Ist der Multikamera Betrieb nicht erw nscht muss das Handle hf vor dem Aufruf von is_InitCamera mit 0 initialisiert werden 0 bedeutet dass die erste nicht benutzte Kamera ver wendet wird Im Allgemeinen ist das uEye SDK thread safe Die API Funktionsaufrufe erfolgen alle in critical sections Auf Grund interner DirectDraw Strukturen empfehlen wird dringend die folgenden Funk tionen nur aus einem Thread heraus aufzurufen um ein unvorhersehbares Verhalten Ihrer Appli kation zu vermeiden e is_InitCamera e is_SetDisp
132. t Wan Beschreibung Die Funktion is_StealVideo leitet das Stehlen eines Bildes im DirectDraw Livemodus ein Das gestohlene Bild wird dabei in den aktuellen aktiven Bildspeicher im RAM geschrieben Dabei wird das mit der Funktion is_SetColorMode eingestellte Farbformat verwendet Mit der Funktion is_PrepareStealVideo kann voreingestellt werden ob das Bild umgeleitet werden muss oder kopiert werden kann Bei Verwendung der Option Kopieren wird das Bild mit DirectDraw angezeigt und in den aktuell aktiven Bildspeicher kopiert Siehe auch Abb 6 Events im Livemodus unter 3 9 Event Handling Interrupt gesteuerter Bild einzug bergabeparameter hf Handle auf Kamera Wait IS_WAIT Funktion wartet bis Bild im Speicher ist IS_DON T_WAIT Funktion kehrt sofort zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS 140 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 127 is_StopLiveVideo Syntax INT is_StopLiveVideo HIDS hf INT Wait Beschreibung Die Funktion is_StopLiveVideo stoppt den Live Modus und friert das Bild im Speicher der VGA Karte oder im Systemspeicher des PCs ein ber den bergabeparameter Wait wird das R ckkehrverhalten der Funktion gesteuert Es kann zwischen den beiden Modi Funktion kehrt sofort zur ck und die Funktion wartet bis das letzte Bild fertig aufgenommen ist gew hlt werden Im ersten Fall wird das Bild im Hintergrund fertig digitalisiert Durch d
133. t der Funktion is_Transferlmage verwendet werden um Bilder aus dem Kameraspeicher auszulesen bergabeparameter hf Handle auf Kamera pID Gibt die ID der zuletzt aufgenommenen Sequenz im Speicher zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS 58 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 40 is_GetMemorySequenceWindow Syntax INT is_GetMemorySequenceWindow HIDS hf INT nID INT left INT top INT right INT bottom Beschreibung Mit der Funktion is_GetMemorySequenceWindow kann die Fenstergr e zu einer angegebe nen Memoryboard Sequenz abgefragt werden Als Parameter wird die gew nschte Sequenz ID ben tigt bergabeparameter hf Handle auf Kamera niD Sequenz ID zu der die Fensterkoordinaten abgefragt werden left Gibt die Anfangs Spalte zur ck top Gibt die Anfangs Zeile zur ck right Gibt die End Spalte zur ck bottom Gibt die End Zeile zur ck R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 41 is_GetNumberOfCameras Syntax INT is_GetNumberOfCameras INT pnNumCams Beschreibung is_GetNumber fCameras gibt die Anzahl der am PC angeschlossenen uEye Kameras zur ck bergabeparameter pnNumCams Gibt die Anzahl angeschlossener Kameras zur ck R ckgabewert IS_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 59 Benutzerhandbuch uEye Software Development Kit V2 40 4 42 is_GetNumberOfMemorylmages Syntax INT
134. t gespeichert bergabeparameter hf Handle auf Kamera File Name der BMP Bilddatei NULL gt Speichern unter Dialogbox wird ge ffnet Es kann sowohl der absolute als auch der relative Pfad ber geben werden R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 85 Benutzerhandbuch uEye Software Development Kit V2 40 4 74 is_SavelmageEX Syntax INT is_SavelmageEx HIDS hf char File INT fileFormat INT Param Beschreibung Speichert ein Bild als Bitmap oder JPG in eine Datei siehe auch 4 73 is_Savelmage Die Bil der werden aus dem aktiven Bildspeicher ausgelesen Das Bitmap wird mit der Farbtiefe 8 15 16 24 oder 32 Bit gespeichert wie der Bildspeicher allokiert wurde bzw wie der aktuelle Farbmodus bei DirectDraw Ausgabemodi eingestellt ist Einige Bildbearbeitungsprogramme un terst tzen keine 15 Bit 16 Bit oder 32 Bit Bitmaps und k nnen somit in diesen Modi gespeicher te Bilder nicht einlesen Der Dateiname kann sowohl absolute als auch relative Pfadangaben enthalten bergabeparameter hf Handle auf Kamera File Name der BMP Bilddatei NULL gt Speichern unter Dialogbox wird ge ffnet Es kann sowohl der absolute als auch der relative Pfad ber geben werden fileFormat bestimmt das Ausgabeformat der Datei IS_IMG_BMP Bitmap IS_IMG_JPG JPEG Param Wenn JPEG als Dateiformat gew hlt wird kann mit Param die Qualit t zwischen 1 und 100 eingestellt werden W
135. tError HIDS hf INT pErr char ppcErr Beschreibung is_GetError fragt den letzten aufgetretenen Fehler ab und liefert Fehlercode und Fehlermel dung zur ck Die letzte Fehlermeldung wird nicht gel scht aber durch neu eintretende Fehler berschrieben bergabeparameter hf Handle auf Kamera PErr Zeiger auf Variable die dann den Fehlercode enth lt PpcErr Zeiger auf String der dann den Fehlertext enth lt R ckgabewert IS_SUCCESS IS_NO_SUCCESS 52 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 4 Beschreibung der Funktionen 4 32 is_GetExposureRange Syntax INT is_GetExposureRange HIDS hf double min double max double intervall Beschreibung Mit is_GetExposureRange k nnen die f r das momentan eingestellte Timing Pixeltakt Fra merate m glichen Exposure Werte in Millisekunden abgefragt werden Die m glichen Zeiten liegen zwischen min und max und k nnen in intervall gro en Schritten eingestellt werden bergabeparameter hf Handle auf Kamera min Enth lt die minimal m gliche Exposure Zeit max Enth lt die maximal m gliche Exposure Zeit intervall Enth lt die Schrittweite mit der die Bilddauer ge ndert wer den kann R ckgabewert IS_SUCCESS IS_NO_SUCCESS 4 33 is_GetFramesPerSecond Syntax INT is_GetFramesPerSecond HIDS hf double dbIFPS Beschreibung is_GetFramesPerSecond gibt im Livetrieb siehe 4 4 is CaptureVideo die Anzahl der tats ch lich einge
136. tHardwareGain kann der Parameter nMode auf einen der IS_INQUIRE_x_FACTOR Werte gesetzt werden Der Wer tebereich f r nFactor liegt in diesem Fall von 0 bis 100 Der Parameter nFactor muss f r das Setzen der Verst rkung mit IS_GET_x_GAIN_FACTOR als Integer Wert mit einem Bereich von 100 bis Maximum festgelegt sein Das Maximum kann mit IS_INQUIRE_x_FACTOR und einem Wert von 100 f r nFactor abgefragt werden Ein Ver st rkungsfaktor mit dem Wert 100 entspricht keiner Verst rkung ein Wert von 200 einem Ver st rkungsfaktor von zwei usw Der R ckgabewert entspricht der gesetzen Verst rkung Diese kann von der gew nschten ab weichen da nur bestimmte Werte gesetzt werden k nnen Es wird immer der Verst rkungswert gesetzt der der Vorgabe am n chsten liegt Je nach Zeitpunkt der nderung der Verst rkung wirkt sich diese erst bei der Aufnahme des n chsten Bildes aus bergabeparameter hf nMode IS_GET_MASTER_GAIN_FACTOR IS_GET_RED_GAIN_FACTOR IS_GET_GREEN_GAIN_FACTOR IS_GET_BLUE_GAIN_FACTOR IS_SET_MASTER_GAIN_FACTOR IS_SET_RED_GAIN_FACTOR IS_SET_GREEN_GAIN_FACTOR IS_SET_BLUE_GAIN_FACTOR IS_GET_DEFAULT_MASTER_GAIN_FACTOR IS_GET_DEFAULT_RED_GAIN_FACTOR IS_GET_DEFAULT_GREEN_GAIN_FACTOR IS_GET_DEFAULT_BLUE_GAIN_FACTOR IS_INQUIRE_MASTER_GAIN_FACTOR IS_INQUIRE_RED_GAIN_FACTOR IS_INQUIRE_GREEN_GAIN_FACTOR IS_INQUIRE_BLUE_GAIN_FACTOR Handle auf Kamera R ckgabe der Master Verst rkung R ckgab
137. tene Fenster wird dabei an den Anfang des Speichers kopiert Soll das Bild an denselben Offset innerhalb des Speichers kopiert werden kann die neue Position mit den Pa rametern IS_SET_IMAGE_POS_X_ABS und IS_SET_IMAGE_POS_Y_ABS logisch Oder ver kn pft werden Beispiel x 20 y 20 x 20 IS_SET_IMAGE_POS_X_ABS y 20 x 20 IS_SET_IMAGE_POS_X_ABS y 20 IS_SET_IMAGE_POS_Y_ABS Sensor Bildfl che Speicher Abbild ee 126 2000 2007 by IDS Imaging Development Systems GmbH Randbedingungen Siehe 4 79 is_SetAOl bergabeparameter hf x 0 xMax IS_GET IMAGE POS_X IS_GET IMAGE POS_X_ABS IS_GET IMAGE POS_X_MIN IS_GET IMAGE POS_X_MAX IS_GET IMAGE POS_X_INC IS_GET IMAGE POS_Y IS_SET IMAGE POS_Y_ABS IS_GET IMAGE POS_Y_MIN IS_GET IMAGE POS_Y_MAX IS_GET IMAGE POS_Y_INC y 0 yMax R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_IMAGE_POS_X und IS_GET_IMAGE_POS_Y als bergabeparameter f r x sonst IS SUCCESS SG NO SUCCESS Kapitel4 Beschreibung der Funktionen Handle auf Kamera Horizontale Position R cklesen der aktuellen X Position R cklesen ob die X Position f r den aktuellen Speicher ber nommen wurde Kleinster Wert f r die horizontale AOI Position Gr
138. tionen der erforderliche Regelbereich bei m g lichst hoher Framerate zur Verf gung Bei der Regelung des Wei abgleichs werden die RGB Gain Einstellungen der Kamera im Be reich 0 100 solange ver ndert bis der rote bzw der blaue Kanal die mittlere Helligkeit des gr nen Kanals erreichen Um eine gew nschte Farbwiedergabe zu erhalten k nnen die Soll werte f r den roten und den blauen Kanal durch einen Offset relativ zum gr nen Kanal einge stellt werden Die Geschwindigkeiten der Autofunktionen k nnen in einem Bereich von 0 100 eingestellt werden Dadurch wird die D mpfung oder Tr gheit der Regelung beeinflusst Hohe Geschwin digkeit 100 resultiert in einer kleinen D mpfung f r eine schnell reagierende Regelung und umgekehrt Hierbei verwenden die Regelung f r die mittlere Helligkeit und die Regelung f r die Farbwiedergabe getrennte Geschwindigkeiten Durch das Setzen des Parameters IS_SET_AUTO_WB_ONCE kann die Regelung des Wei abgleichs automatisch beendet werden sobald die Zielvorgabe erreicht wurde Das Ende der Regelung wird dem System ber ein Event Message mitgeteilt siehe auch 4 53 is_InitEvent Alternativ bleibt die Regelung weiterhin aktiv und reagiert auf Abweichungen von der Zielvorga be Bei eingeschaltetem AutoShutter ist die Einstellung des Pixelclock ber die Funktion is_SetPixelClock deaktiviert AutoFramerate ist nur bei eingeschalteter AutoShutter Regelung m glich da die Au toFramerate d
139. tware Development Kit V2 40 e Aufnahme Dieser Modus wird durch den Aufruf von is_FreezeVideo aktiviert Ein optionaler timeout Wert gibt an wie lange auf das Triggersignal gewartet werden soll So lange dieses Signal nicht eintrifft befindet sich die Kamera in Bereitschaft Beim Auftreten eines Triggersignals startet die Bildaufnahme und es wird die mit is_SetMemoryMode angegebene Anzahl an Bil dern aufgenommen Ist diese Anzahl Bilder fertig aufgenommen wird eine eindeutige Se quenz Id vergeben unter der diese Bilder zu einem sp teren Zeitpunkt indiziert werden k n nen L uft jedoch der timeout ab bevor alle Bilder aufgenommen wurden ist die gesamte Sequenz ung ltig Sequenz Id 0 und ein Fehler wird gemeldet Die Id einer Sequenz kann nachdem alle Bilder aufgenommen wurden mit dem Befehl is_GetLastMemorySequence ab gerufen werden e Codebeispiel int nNumberOflmages 5 nSequence 0 is_SetExternalTrigger hCamera IS_TRIG_HI_LO wenn die Speicherung so vieler Bilder m glich ist if is_SetMemoryMode hCamera nNumberOflmages 100 IS_SUCCESS starte Bildaufnahme und warten auf Triggersignal is_FreezeVideo hCamera IS_WAIT Sequenz ist g ltig is_GetLastMemorySequence hCamera amp nSequence if nSequence 0 is_TransferImage hCamera 0 nSequence 1 0 16 2000 2007 by IDS Imaging Development Systems GmbH Kapitel 3 Funktionsbl cke Start Ha
140. ue Beschreibung Die Funktion is_SetHardwareGain dient zum Steuern der in der Kamera befindlichen Verst r ker die unabh ngig voneinander von 0 bis 100 eingestellt werden k nnen ber die Funk tion is_GetSensorlnfo kann abgefragt werden welche Verst rker vorhanden sind Je nach Zeitpunkt der nderung der Verst rkung wirkt sich diese erst bei der Aufnahme des n chsten Bildes aus bergabeparameter hf Handle auf Kamera nMaster Gesamt Verst rkung IS_IGNORE_PARAMETER Master Verst rkung nicht ver ndern IS_GET_MASTER_GAIN R ckgabe der Master Verst rkung IS_GET_RED_GAIN R ckgabe der Rot Verst rkung IS_GET_GREEN_GAIN R ckgabe der Gr n Verst rkung IS_GET_BLUE_GAIN R ckgabe der Blau Verst rkung IS_GET_DEFAULT_MASTER R ckgabe der Standard Master Verst rkung IS_GET_ DEFAULT_RED R ckgabe der Standard Rot Verst rkung IS GET DEFAULT_GREEN R ckgabe der Standard Gr n Verst rkung IS_GET_ DEFAULT_BLUE R ckgabe der Standard Blau Verst rkung nRed Rotkanal IS_IGNORE_PARAMETER Rot nicht ver ndern nGreen Gr nkanal IS_IGNORE_PARAMETER Gr n nicht ver ndern nBlue Blaukanal IS_IGNORE_PARAMETER Blau nicht ver ndern Bei Verwendung der Konstanten IS_SET_ENABLE_AUTO_GAIN f r den Parameter EXP wird die AutoGain Funktionalit t aktiviert Durch Setzen eines Wertes wird diese wieder deaktiviert siehe auch 4 80 is SetAutoParameter R ckgabewert Aktuelle Einstellung in Verbindung mit IS_GET_MASTER_GAIN
141. ung der Funktionen 4 19 is_FreezeVideo Syntax INT is_FreezeVideo HIDS hf INT Wait Beschreibung is_FreezeVideo digitalisiert ein Bild und legt es im aktiven Bildspeicher ab Im DirectDraw Mo dus wird das Bild in den DirectDraw Buffer digitalisiert direkt in die VGA Karte oder einen BackBuffer Wird mit Ringbuffering gearbeitet so erfolgt die Bildaufnahme nur in den 1 Bild speicher der Sequenz Erfolgt nach dem Aufruf der Funktion mit dem Parameter IS_DONT_WAIT eine Ver nderung der Kameraeinstellungen Exposure Pclk AOI wird die Aufnahme abgebrochen und die neuen Kameraeinstellungen werden bernommen Die Bildaufnahme erfolgt getriggert wenn der Triggermodus mit is_SetExternalTrigger zuvor aktiviert wurde Nach Aktivierung des Memorymodus mit is_SetMemoryMode oder is_MemoryFreeze Video werden die mit is_FreezeVideo erfassten Bilder im Kameraspeicher abgelegt Um wieder eine Bilderfassung ohne Memorymode zu erm glichen muss der Memorymode mit der Funktion is_SetMemoryMode IS_MEMORY_MODE_DISABLE 0 siehe 4 116 is_SetMemoryMode wieder abgeschaltet werden bergabeparameter hf Handle auf Kamera Wait IS_WAIT Funktion wartet bis Bild aufgenommen ist Wenn die 4 fache Framezeit berschritten wurde wird dies mit einem Timout quittiert IS_DONT_WAIT Funktion kehrt sofort zur ck 10 lt Wait lt 21474836 Wartezeit in 10 ms Schritten Maximal kann 214748 36 Se kunden gewartet werden Dies entspric
142. unktion f r Rolling Shutter Kameras zu realisieren Somit kann eine Rolling Shutter Kamera als Global Shutter Kamera betrieben werden wenn die zu erfassende Bild szene in der Blitzpause zwischen zwei Bildern dunkel ist Wird die Belichtungszeit zu kurz eingestellt so dass kein globaler Blitz mehr m glich ist wird IS_NO_SUCCESS zur ckgegeben bergabeparameter hf Handle auf Kamera ulDelay Zeit um die der Blitz verz gert wird in us ulDuration Zeit in der der Blitz eingeschaltet wird in us R ckgabewert IS_SUCCESS IS_NO_SUCCESS 2000 2007 by IDS Imaging Development Systems GmbH 55 Benutzerhandbuch uEye Software Development Kit V2 40 4 36 is_GetlmageHistogram Syntax INT is_GetlmageHistogram HIDS hf int nID INT ColorMode DWORD pHistoMem Beschreibung is_GetlmageHistogram berechnet das Histogramm des bergebenen Bildes Dabei werden die Farbformate RGB32 RGB24 RGB16 RGB15 Raw Bayer und Y8 unterst tzt bergabeparameter Hf Handle auf Kamera niD Memory ID ColorMode Farbmodus des Bildes mit Memory ID nID IS_SET_CM_RGB32 DWORD Array 256 3 IS_SET_CM_RGB24 DWORD Array 256 3 IS_SET_CM_RGB16 DWORD Array 256 3 IS_SET_CM_RGB15 DWORD Array 256 3 IS_SET_CM_BAYER DWORD Array 256 3 IS_SET_CM_Y8 DWORD Array 256 pHistoMem Zeiger auf ein DWORD Array R ckgabewert IS_SUCCESS IS_NO_SUCCESS IS_NULL_POINTER invalid array IS_INVALID_COLOR_FORMAT nicht unterst tztes Farbformat IS_INVALID_P
143. unktionen 4 129 is_TransferMemorySequence Syntax INT is_TransferMemorySequence HIDS hf INT seqID INT StartNr INT nCount INT nSegPos Beschreibung Die Funktion is_TransferMemorySeqguence wird verwendet um mehrere Bilder aus dem Kame raspeicher in eine SDK Sequenz einzulesen Der SDK Sequenz muss zuvor mit is_AddToSequence gen gend mit is_AllocateMemory angelegter Speicher hinzugef gt wor den sein Als Parameter wird die ID der Kameraspeicher Sequenz ben tigt Au erdem kann die Startnummer ab der Bilder eingelesen werden angegeben werden Mit nCount wird festgelegt wie viele Bilder ab StartNr bertragen werden sollen Der letzte Parameter dient dazu die Bilder ab nSegPos in die Sequenz zu bertragen Beispiel bertragen von 3 Bildern aus der Kamerasequenz 1 ab Bild Nummer 2 in die SDK Sequenz ab Position 3 Aufruf is_TransferMemorySequence hf 1 2 3 3 SDK Sequenz Kameraspeicher SegNr 1 1 1 2 2 3 e h 4 5 u 5 bergabeparameter hf Handle auf Kamera seqID Die ID der Sequenz im Kameraspeicher aus der die Bilder eingelesen werden StartNr Bildindex ab dem Bilder aus der Sequenz eingelesen werden nCount Anzahl an Bildern die aus dem Speicher in die Sequenz bertragen werden 0 Alle Bilder der Sequenz ab StartNr werden bertragen nSeqPos Anfangsposition der Sequenz R ckgabewert IS_SUCCESS IS_IMAGE_N
144. ur gleichzeitigen Aktivierung von horizontalem und vertikalem Binning k nnen die horizontalen und vertikalen Binningparameter durch ein logisches ODER verkn pft werden bergabeparameter hf Handle auf Kamera mode IS_BINNING_DISABLE Deaktiviert das Binning IS_BINNING_2X_VERTICAL Aktiviert zweifaches Binning in vertikaler Richtung IS_BINNING_4X_VERTICAL Aktiviert vierfaches Binning in vertikaler Richtung IS_BINNING_2X_HORIZONTAL Aktiviert zweifaches Binning in horizontaler Richtung IS_BINNING_4X_HORIZONTAL Aktiviert vierfaches Binning in horizontaler Richtung IS_GET_BINNING Gibt die aktuelle Einstellung zur ck IS_GET_SUPPORTED_BINNING Gibt die unterst tzten Binning Modi zur ck IS_GET_BINNING_TYPE Der R ckgabewert gibt an ob die Kamera farberhaltendes Binning verwendet S_BINNING_COLOR oder nicht IS_BINNING_MONO R ckgabewert IS_SUCCESS IS_NO_SUCCESS oder die aktuellen Einstellungen bei IS_GET_BINNING 2000 2007 by IDS Imaging Development Systems GmbH 99 Benutzerhandbuch uEye Software Development Kit V2 40 4 85 is_SetBlCompensation Syntax INT is_SetBlCompensation HIDS hf INT nEnable INT offset INT reserved Beschreibung is_SetBlCompensation aktiviert die Blacklevel Kompensation mit der die Bildqualit t unter Umst nden verbessert werden kann Je nach Zeitpunkt der nderung der Kompensation wirkt sich diese erst bei der Aufnahme des n chsten Bildes aus bergabeparameter hf Handle auf Kamera
145. wird zuerst ein Bild in den Kameraspeicher bertragen und anschlie end in den angegeben Bildspeicher eingelesen Der Vorteil dieser Funktion besteht darin dass ein aufgenommenes Bild auch bei starker Rechnerbelastung ohne Transferfehler sicher bertragen werden kann Erfolgt nach dem Aufruf der Funktion mit dem Parameter IS_DONT_WAIT eine Ver nderung der Kameraeinstellungen Exposure Pclk AOI wird die Aufnahme abgebrochen und die neuen Kameraeinstellungen werden bernommen Bei Aufruf der Funktion is_MemoryFreezeVideo wird automatisch der Memorymode aktiviert Um anschlie end wieder eine Bilderfassung ohne Memorymode zu erm glichen muss der Me morymode mit der Funktion is_SetMemoryMode IS_MEMORY_MODE_DISABLE 0 siehe 4 116 is_SetMemoryMode wieder abgeschaltet werden bergabeparameter hf Handle auf Kamera nMemID ID des Speichers in den das Bild bertragen wird bei 0 wird der momentan aktive Speicher verwendet Wait IS_WAIT Funktion wartet bis Bild aufgenommen ist IS_DONT_WAIT Funktion kehrt sofort zur ck 10 lt Wait lt 21474836 Wartezeit in 10 ms Schritten Maximal kann 214748 36Sekun den gewartet werden F r 1 lt Wait lt 10 wird Wait 10 gesetzt Bsp Wait 100 gt 1 sec warten R ckgabewert IS_SUCCESS IS_NO_SUCCESS 78 2000 2007 by IDS Imaging Development Systems GmbH 4 65 is_PrepareStealVideo Syntax Kapitel 4 Beschreibung der Funktionen INT is_PrepareStealVideo HIDS hf

Download Pdf Manuals

Related Search

Related Contents

Philips D721 Telephone User Manual  新着資料一覧表(6月1日～6月7日） No. 資料名 著者名 出版者 資料  Manual De Instalación Y Especificaciones Técnicas Del Globalblock  3B SCIENTIFIC® PHYSICS    Service Manual - Michael Jay Lissner  

Copyright © All rights reserved. Failed to retrieve file