FALCON/EAGLE-Benutzerhandbuch 4.62

Syntax

INT is_DirectRenderer (HIDS hCam, UINT nMode, void* pParam, UINT nSize)

Beschreibung:

is_DirectRenderer() fasst erweiterte Darstellungsfunktionen zusammen und bietet die Möglichkeit, Overlay-Daten flackerfrei ins Livebild einzublenden. Unter Windows werden Grafikkarten-Funktionen der Direct3D-Bibliothek unterstützt.

•Um die Direct3D-Funktionen nutzen zu können, muss eine entsprechende Version der Microsoft DirectX 9 Runtime auf dem System installiert sein. Installationspakete sind auf den Microsoft Webseiten verfügbar (Stichwort: "DirectX End-User runtime").

•Die Grafikkarte muss mindestens eine Texturgröße (Overlay-Größe) von 768x576 Pixel bei PAL bzw. 640x480 Pixel bei NTSC unterstützen. Die maximale Texturgröße kann über den Parameter DR_GET_MAX_OVERLAY_SIZE abgefragt werden.

•Aktiviert wird die Direct3D Darstellung wie folgt:
is_SetDisplayMode(h, IS_SET_DM_DIRECT3D)

•Für die Darstellung im Direct3D-Modus können verschiedene Farbmodi verwendet werden. Die höchste Leistung wird jedoch erzielt, wenn der Farbmodus des FALCON identisch zum Farbmodus des Windows Desktops ist. In Verbindung mit modernen leistungsfähigen Grafikkarten kann als Grab-Farbformat meist YUV4:2:2 verwendet werden. Dieses Format ist ein 16-Bit pro Pixel Format und weist eine reduzierte PCI/PCIe Busbelastung gegenüber z.B. dem RGB32 Format auf.

•Es kommt vor, dass interne Direct3D Buffer ungültig werden, wenn der Desktop nach bestimmten Aktionen reaktiviert wird (z.B. ein Bildschirmschoner wird durch eine Eingabe inaktiv; nach einem Strg-Alt-Entf). In diesem Fall sind die gezeichneten Overlay-Daten intern verloren. Die Applikation wird jedoch über eine Message (Overlay-Lost-Message) aus dem FALCON Treiber über diese Situation benachrichtigt, so dass diese die Overlay-Daten neu zeichnen kann (Message-Beispiel siehe unten). Diese Message wird sowohl an das Anzeigefenster, als auch an das Elternfenster des Anzeigefensters gesendet. Damit kann die Nachricht auch empfangen werden, wenn das Control, das zur Anzeige verwendet wird, selbst keine Nachrichten verarbeitet. Ausgewertet muss die Nachricht jedoch nur in einem der beiden Fensterhandler.

•Unter Direct3D kann ein stufenloses Skalieren der Darstellung genutzt werden (siehe DR_ENABLE_SCALING). Allerdings können in Verbindung mit der Interlaced-Aufnahme der Bilddaten beim Herunterskalieren subjektiv schlechtere Skalierungsergebnisse auftreten, im Vergleich zur Bilderfassung direkt in der benötigten skalierten Bildgröße.

•Während der Direct3D Modus aktiv ist sind einige FALCON SDK Funktionen nicht nutzbar (Liste siehe unten).

Übergabeparameter

Rückgabewerte

Während des Direct3D Modus nicht nutzbare Funktionen

•is_SetVideoMode()

•is_SetColorMode()

•is_SetImageSize()

•is_UpdateDisplay()

•is_EnableDDOverlay()

•is_DisableDDOverlay()

•is_ScaleDDOverlay()

•is_ShowDDOverlay()

•is_HideDDOverlay()

•is_OvlSurfaceOffWhileMove()

•is_GetDC()

•is_ReleaseDC

•is_SetDDUpdateTime

•is_LockDDOverlayMem

•is_UnlockDDOverlayMem

•is_LockDDMem

•is_UnlockDDMem

•is_GetDDOvlSurface

•is_SetKeyColor

•is_SetKeyOffset

•is_AddToSequence

Beispiele

//------------------------------------

// DC-Handle

//------------------------------------

// DC-Handle auf das Overlay holen

HDC hDC;

is_DirectRenderer (h, DR_GET_OVERLAY_DC, (void*)&hDC, sizeof (hDC));

// DC-Handle freigeben

is_DirectRenderer (h, DR_RELEASE_OVERLAY_DC, NULL, NULL);

 

//------------------------------------

// Overlay-Größe

//------------------------------------

//Maximale Größe des Overlay-Bereichs abfragen

UINT OverlaySize[2];

is_DirectRenderer (h, DR_GET_MAX_OVERLAY_SIZE,

        (void*)OverlaySize, sizeof(OverlaySize));

INT nWidth = OverlaySize[0];

INT nHeight = OverlaySize[1];

//Größe des Overlay-Bereichs setzen

UINT Size[2];

Size[0] = 100;

Size[1] = 120;

is_DirectRenderer (h, DR_SET_OVERLAY_SIZE, (void*)Size, sizeof (Size));

//Position des Overlay-Bereichs setzen

UINT Position[2];

Position[0] = 20;

Position[1] = 0;

is_DirectRenderer (h, DR_SET_OVERLAY_POSITION,

        (void*)Position, sizeof (Position));

 

//------------------------------------

// Key-Farbe

//------------------------------------

//Aktuelle Key-Farbe auslesen

UINT OverlayKeyColor[3];

is_DirectRenderer (h, DR_GET_OVERLAY_KEY_COLOR,

        (void*)OverlayKeyColor, sizeof(OverlayKeyColor));

INT nRed   = OverlayKeyColor[0];

INT nGreen = OverlayKeyColor[1];

INT nBlue = OverlayKeyColor[2];

//Neue Key-Farbe setzen

OverlayKeyColor[0] = GetRValue(m_rgbKeyColor);

OverlayKeyColor[1] = GetGValue(m_rgbKeyColor);

OverlayKeyColor[2] = GetBValue(m_rgbKeyColor);

is_DirectRenderer (h, DR_SET_OVERLAY_KEY_COLOR,

        (void*)OverlayKeyColor, sizeof(OverlayKeyColor));

 

//------------------------------------

// Anzeige

//------------------------------------

//Overlay anzeigen

is_DirectRenderer (h, DR_SHOW_OVERLAY, NULL, NULL);

//Overlay ausblenden

is_DirectRenderer (h, DR_HIDE_OVERLAY, NULL, NULL);

 

//------------------------------------

// Skalierung

//------------------------------------

//Skalierung aktivieren

is_DirectRenderer (h, DR_ENABLE_SCALING, NULL, NULL);

//Skalierung deaktivieren

is_DirectRenderer (h, DR_DISABLE_SCALING, NULL, NULL);

 

//------------------------------------

// Transparenz

//------------------------------------

//Halbtransparentes Overlay aktivieren

is_DirectRenderer (h, DR_ENABLE_SEMI_TRANSPARENT_OVERLAY, NULL, NULL);

//Halbtransparentes Overlay deaktivieren

is_DirectRenderer (h, DR_DISABLE_SEMI_TRANSPARENT_OVERLAY, NULL, NULL);

 

//------------------------------------

// Synchronisation

//------------------------------------

//Auto-Synchronisation aktivieren

is_DirectRenderer (h, DR_SET_VSYNC_AUTO, NULL, NULL);

//Benutzerdefinierte Synchronisation: Bereich abfragen + Sync-Pos. setzen

UINT UserSync[2];

is_DirectRenderer (h, DR_GET_USER_SYNC_POSITION_RANGE,

        (void*)UserSync, sizeof (UserSync));

INT Min = UserSync[0];

INT Max = UserSync[1];

INT SyncPosition = 400;

is_DirectRenderer (h, DR_SET_USER_SYNC,

        (void*)&SyncPosition, sizeof (SyncPosition));

//Synchronisation deaktivieren

is_DirectRenderer (h, DR_SET_VSYNC_OFF, NULL, NULL);

 

//------------------------------------

// BMP-Datei

//------------------------------------

//Overlay aus BMP-Datei laden

is_DirectRenderer (h, DR_LOAD_OVERLAY_FROM_FILE,

        (void*)”c:\test.bmp”, NULL);

 

//------------------------------------

// Löschen

//------------------------------------

//Overlay-Bereich löschen

is_DirectRenderer (h, DR_CLEAR_OVERLAY, NULL, NULL);

 

//------------------------------------

// Steal-Funktion

//------------------------------------

//Farbmodus für kopiertes Bild abfragen und setzen

INT nColorMode;

is_DirectRenderer (h, DR_GET_STEAL_FORMAT,

        (void*)&nColorMode, sizeof (nColorMode));

nColorMode = IS_CM_Y8;

is_DirectRenderer (h, DR_SET_STEAL_FORMAT,

        (void*)&nColorMode, sizeof (nColorMode));

//Bild kopieren, Funktion wartet

INT nwait = IS_WAIT;

is_DirectRenderer(h, DR_STEAL_NEXT_FRAME,

        (void*)&wait, sizeof (wait));

 

//------------------------------------

// Fenster-Handle

//------------------------------------

//Setzt ein neues Fenster-Handle für die Bildausgabe

is_DirectRenderer (h, DR_SET_HWND, (void*)&hWnd, sizeof (hWnd));

 

//------------------------------------

// Kompatibilität

//------------------------------------

//Kompatibilität der Grafikkarte prüfen

INT nRet = is_DirectRenderer (h, DR_CHECK_COMPATIBILITY, NULL, NULL);

if (nRet == IS_DR_DEVICE_CAPS_INSUFFICIENT )

//Grafikkarte unterstützt keine uEye Direct3D-Funktionen

 

//------------------------------------

// Farbmodus prüfen

//------------------------------------

INT nVgaMode;

// Aktuellen Farbmodus des Desktops ermitteln

INT nRet = is_GetColorDepth(h, NULL, &nVgaMode);

INT Modes[2];

Modes[0] = IS_SET_CM_RGB16;   // Quellmodus des FALCON (z.B.)

Modes[1] = nVgaMode;       // Zielmodus der Grafikkarte

// Quell- und Zielmodus prüfen

nRet = is_DirectRenderer(h, DR_CHECK_COLOR_MODE_SUPPORT, Modes,

            2 * sizeof(INT));

if (nRet == IS_DR_DEVICE_CAPS_INSUFFICIENT )

//Grafikkarte unterstützt die angegebene Farbraumkonvertierung nicht

 

//------------------------------------

// "Overlay Lost" Nachricht

//------------------------------------

// Beispiel für einen Nachrichtenhandler in MFC Applikationen

// in XX_sample.h

afx_msg LRESULT OnFalconMessage(WPARAM wParam, LPARAM lParam);

 

// in XX_sample.cpp

BEGIN_MESSAGE_MAP(...)

...

ON_MESSAGE(IS_FALCON_MESSAGE, OnFalconMessage)

END_MESSAGE_MAP()

 

LRESULT CXX_class::OnFalconMessage(WPARAM wParam, LPARAM lParam)

{

  switch(wParam)

  {

      case IS_MSG_OVERLAY_DATA_LOST:

    // redraw the overlay data here

    ...

          break;

  } // end switch(wParam)

  return 0;

} // end  LRESULT CXX_class::OnFalconMessage