HALCON Website / HALCON Operator-Referenz / Datei / XLD
KlassenKlassenKlassenKlassen | | | | Operatoren

read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf (Operator)

Name

read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf — Lesen von XLD-Polygonen aus einer DXF-Datei.

Signatur

read_polygon_xld_dxf( : Polygons : FileName, GenParamNames, GenParamValues : DxfStatus)

Herror read_polygon_xld_dxf(Hobject* Polygons, const char* FileName, const char* GenParamNames, double GenParamValues, char* DxfStatus)

Herror T_read_polygon_xld_dxf(Hobject* Polygons, const Htuple FileName, const Htuple GenParamNames, const Htuple GenParamValues, Htuple* DxfStatus)

Herror read_polygon_xld_dxf(Hobject* Polygons, const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, char* DxfStatus)

Herror read_polygon_xld_dxf(Hobject* Polygons, const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* DxfStatus)

HXLDPoly HXLDPoly::ReadPolygonXldDxf(const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, char* DxfStatus)

HXLDPolyArray HXLDPolyArray::ReadPolygonXldDxf(const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* DxfStatus)

void ReadPolygonXldDxf(HObject* Polygons, const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* DxfStatus)

HTuple HXLDPoly::ReadPolygonXldDxf(const HString& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues)

HString HXLDPoly::ReadPolygonXldDxf(const HString& FileName, const HString& GenParamNames, double GenParamValues)

HString HXLDPoly::ReadPolygonXldDxf(const char* FileName, const char* GenParamNames, double GenParamValues)

void HOperatorSetX.ReadPolygonXldDxf(
[out] IHUntypedObjectX** Polygons, [in] VARIANT FileName, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues, [out] VARIANT* DxfStatus)

VARIANT HXLDPolyX.ReadPolygonXldDxf(
[in] BSTR FileName, [in] VARIANT GenParamNames, [in] VARIANT GenParamValues)

static void HOperatorSet.ReadPolygonXldDxf(out HObject polygons, HTuple fileName, HTuple genParamNames, HTuple genParamValues, out HTuple dxfStatus)

HTuple HXLDPoly.ReadPolygonXldDxf(string fileName, HTuple genParamNames, HTuple genParamValues)

string HXLDPoly.ReadPolygonXldDxf(string fileName, string genParamNames, double genParamValues)

Beschreibung

read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf liest den Inhalt der DXF-Datei FileNameFileNameFileNameFileNameFileNamefileName (DXF-Version AC1009, AutoCAD Release 12) und wandelt ihn in die XLD-Polygone PolygonsPolygonsPolygonsPolygonsPolygonspolygons. Wenn kein absoluter Pfad in FileNameFileNameFileNameFileNameFileNamefileName angegeben wird, wird die DXF-Datei im aktuellen Verzeichnis des HALCON-Prozesses gesucht.

Der Ausgabeparameter DxfStatusDxfStatusDxfStatusDxfStatusDxfStatusdxfStatus enthält Informationen über die Anzahl der gelesenen Polygone und, falls erforderlich, Hinweise auf Teile der DXF-Datei, die nicht gelesen werden konnten.

Der Operator read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf unterstützt die folgenden DXF-Elemente:

Die X- und Y-Koordinaten der DXF-Elemente werden in den Spalten- und Zeilenkoordinaten der XLD-Polygone PolygonsPolygonsPolygonsPolygonsPolygonspolygons gespeichert. Die Z-Koordinaten der DXF-Elemente werden nicht berücksichtigt.

DXF-Elemente vom Typ CIRCLE, ARC, ELLIPSE und SPLINE werden durch XLD-Polygone approximiert. Die Genauigkeit dieser Approximation kann über die beiden generischen Parameter 'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points" und 'max_approx_error'"max_approx_error""max_approx_error""max_approx_error""max_approx_error""max_approx_error" gesteuert werden (bei SPLINE nur 'max_approx_error'"max_approx_error""max_approx_error""max_approx_error""max_approx_error""max_approx_error"). Generische Parameter werden durch Angabe des Parameternamens in GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames und des dazugehörigen Wertes in GenParamValuesGenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues gesetzt. Der Parameter 'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points" legt fest, wieviele Stützpunkte mindestens für die Approximation verwendet werden. Der Parameter 'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points" bezieht sich immer auf den entsprechenden Vollkreis bzw. die gesamte Ellipse, auch für ARCs oder Ellipsenbögen, d.h., wenn 'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points" auf den Wert 50 gesetzt ist und ein DXF-Element vom Typ ARC eingelesen wird, das einen Halbkreis darstellt, so wird dieser durch mindestens 25 Stützpunkte dargestellt. Der Parameter 'max_approx_error'"max_approx_error""max_approx_error""max_approx_error""max_approx_error""max_approx_error" legt fest, wie groß die maximale Abweichung des XLD-Polygons von dem idealen Kreis bzw. der idealen Ellipse sein darf (Einheit: Pixel). Für die Bestimmung der Genauigkeit der Approximation werden beide Kriterien ausgewertet und dasjenige verwendet, das zu einer genaueren Approximation führt.

Die intern verwendeten Defaultwerte für die generischen Parameter sind:

Um eine genauere Approximation zu erreichen, muss entweder ein größerer Wert für 'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points" oder ein kleinerer Wert für 'max_approx_error'"max_approx_error""max_approx_error""max_approx_error""max_approx_error""max_approx_error" verwendet werden.

Beachten Sie, dass das Einlesen einer DXF-Datei mit read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf geometrisch zu dem gleichen Ergebnis führt wie das Einlesen der Datei mit read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf. Lediglich die Datenstruktur, in der das Ergebnis zurückgegeben wird, ist eine andere.

Parallelisierung

Parameter

PolygonsPolygonsPolygonsPolygonsPolygonspolygons (output_object)  xld_poly(-array) → objectHXLDPolyHXLDPolyHXLDPolyHXLDPolyXHobject *

Eingelesene XLD-Polygone.

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Name der DXF-Datei.

Dateiendung: .dxf

GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames (input_control)  attribute.name(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der generischen Parameter, die für den DXF-Input eingestellt werden sollen.

Defaultwert: []

Werteliste: 'max_approx_error'"max_approx_error""max_approx_error""max_approx_error""max_approx_error""max_approx_error", 'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points"

GenParamValuesGenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues (input_control)  attribute.value(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*) (double / Hlong / BSTR) (double / Hlong / char*)

Werte der generischen Parameter, die für den DXF-Input eingestellt werden sollen.

Defaultwert: []

Wertevorschläge: 0.1, 0.25, 0.5, 1, 2, 5, 10, 20

DxfStatusDxfStatusDxfStatusDxfStatusDxfStatusdxfStatus (output_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Statusinformationen.

Ergebnis

Wenn die Parameter korrekt sind und die angegebene Datei gelesen werden konnte, liefert read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

write_polygon_xld_dxfwrite_polygon_xld_dxfWritePolygonXldDxfwrite_polygon_xld_dxfWritePolygonXldDxfWritePolygonXldDxf

Siehe auch

write_polygon_xld_dxfwrite_polygon_xld_dxfWritePolygonXldDxfwrite_polygon_xld_dxfWritePolygonXldDxfWritePolygonXldDxf, read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH