reset_obj_dbreset_obj_dbResetObjDbResetObjDb (Operator)

Name

reset_obj_dbreset_obj_dbResetObjDbResetObjDb — Initialisieren des HALCON-Systems.

Signatur

Beschreibung

reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb initialisiert das HALCON-System. Dabei legt der Operator die fünf Relationen (Grauwertdaten, Regionendaten, XLDs, Bildobjekte und ObjektTupel) an (siehe auch count_relationcount_relationCountRelationCountRelationCountRelation), die für die Bildverarbeitung mit HALCON nötig sind. Wurde die HALCON-Datenbank angeschaltet (set_system('database','true')set_system("database","true")SetSystem("database","true")SetSystem("database","true")SetSystem("database","true")) und sind die Relationen bereits vorhanden, dann werden alle in den Relationen gelisteten Daten gelöscht!

Die DefaultImageWidthDefaultImageWidthDefaultImageWidthDefaultImageWidthdefaultImageWidth und DefaultImageHeightDefaultImageHeightDefaultImageHeightDefaultImageHeightdefaultImageHeight geben die Startwerte für das globale maximale Bildformat an. Wenn das erste erzeugte Objekt ein Bild ist werden die Werte jedoch nur dann mit der neuen Bildgröße überschrieben, falls diese die initialen Werte übersteigt. Wird statt einem Bild zuerst eine Region erzeugt, dann werden die Werte nur verändert, wenn das neue Bild größer als der Vorgabewert ist. Dies gilt aber nicht nur bei dem ersten Bild, das erzeugt, bzw. eingelesen wird: Das globale Bildformat wird immer vergrößert wenn größere Bilder erzeugt werden.

Das globale Bildformat hat Bedeutung beim Öffnen von Fenstern (open_windowopen_windowOpenWindowOpenWindowOpenWindow) und bei Speicherabschätzungen sowie Clipping von Regionen. Regionen werden, sofern der Clip-Modus eingeschaltet ist (set_system('clip_region','true')set_system("clip_region","true")SetSystem("clip_region","true")SetSystem("clip_region","true")SetSystem("clip_region","true")) an dem globalen Bildformat geclippt. Dies kann dann zu Problemen führen, wenn Bilder unterschiedlicher Größe verwendet werden. In diesem Fall ist nur garantiert, dass eine Region kleiner oder gleich dem Bildformat der größten Bildes ist.

Der Parameter DefaultChannelsDefaultChannelsDefaultChannelsDefaultChannelsdefaultChannels gibt die häufigste Anzahl von Kanälen eines Bildobjektes an. Dieser Wert kann auch auf 0 gesetzt werden, wenn viele Regionen verwendet werden. Wenn mehr Kanäle für ein Bild nötig sind, als bei der Initialisierung angegeben wurde, dann wird für dieses Bild die Anzahl dynamisch erweitert. Wenn weniger Kanäle benötigt werden als bei der Initialisierung angegeben, dann werden die überzähligen Kanäle auf undefiniert gesetzt. Dies wirkt für den Anwender, als wären sie nicht vorhanden; es wird jedoch unnötiger Speicher allokiert.

Die Parameterwerte können mit get_systemget_systemGetSystemGetSystemGetSystem abgefragt werden.

Achtung

Wird reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb am Anfang einer HALCON-Sitzung nicht aufgerufen, dann wird HALCON automatisch mit reset_obj_db(128,128,0)reset_obj_db(128,128,0)ResetObjDb(128,128,0)ResetObjDb(128,128,0)ResetObjDb(128,128,0) initialisiert - mit entsprechendem Nebeneffekt beim Clipping von Regionen. Wurde die Datenbank mit Hilfe des Parameterwertes 'database' des Operators set_systemset_systemSetSystemSetSystemSetSystem angeschaltet, werden durch den Aufruf von reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb alle ikonischen Objekte in der Datenbank gelöscht

Ausführungsinformationen

• Multithreading-Typ: exclusive (läuft parallel nur zu unabhängigen Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

Sind die Parameterwerte korrekt, dann liefert reset_obj_dbreset_obj_dbResetObjDbResetObjDbResetObjDb den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Exeptionbehandlung durchgeführt.

Siehe auch

get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoGetChannelInfo, count_relationcount_relationCountRelationCountRelationCountRelation

Modul

Foundation