reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb (Operator)

Name

reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb — Initialisieren des HALCON-Systems.

Signatur

reset_obj_db( : : DefaultImageWidth, DefaultImageHeight, DefaultChannels : )

Beschreibung

reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb initialisiert das HALCON-System. Dabei legt der Operator die fünf Relationen (Grauwertdaten, Regionendaten, XLDs, Bildobjekte und ObjektTupel) an (siehe auch count_relationcount_relationCountRelationcount_relationCountRelationCountRelation), 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")set_system("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 DefaultImageWidthDefaultImageWidthDefaultImageWidthDefaultImageWidthDefaultImageWidthdefaultImageWidth und DefaultImageHeightDefaultImageHeightDefaultImageHeightDefaultImageHeightDefaultImageHeightdefaultImageHeight 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_windowOpenWindowopen_windowOpenWindowOpenWindow) 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")set_system("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 DefaultChannelsDefaultChannelsDefaultChannelsDefaultChannelsDefaultChannelsdefaultChannels 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_systemGetSystemget_systemGetSystemGetSystem abgefragt werden.

Achtung

Wird reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb 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)reset_obj_db(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_systemSetSystemset_systemSetSystemSetSystem angeschaltet, werden durch den Aufruf von reset_obj_dbreset_obj_dbResetObjDbreset_obj_dbResetObjDbResetObjDb alle ikonischen Objekte in der Datenbank gelöscht