Name
read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf — Lesen von XLD-Konturen aus einer DXF-Datei.
Herror read_contour_xld_dxf(Hobject* Contours, const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, char* DxfStatus)
Herror read_contour_xld_dxf(Hobject* Contours, const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* DxfStatus)
HXLDCont HXLDCont::ReadContourXldDxf(const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, char* DxfStatus)
HXLDContArray HXLDContArray::ReadContourXldDxf(const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* DxfStatus)
void ReadContourXldDxf(HObject* Contours, const HTuple& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues, HTuple* DxfStatus)
HTuple HXLDCont::ReadContourXldDxf(const HString& FileName, const HTuple& GenParamNames, const HTuple& GenParamValues)
HString HXLDCont::ReadContourXldDxf(const HString& FileName, const HString& GenParamNames, double GenParamValues)
HString HXLDCont::ReadContourXldDxf(const char* FileName, const char* GenParamNames, double GenParamValues)
read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf liest den Inhalt der DXF-Datei
FileNameFileNameFileNameFileNameFileNamefileName (DXF-Version AC1009, AutoCAD Release 12)
und wandelt ihn in die XLD-Konturen ContoursContoursContoursContoursContourscontours.
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 Konturen und, falls erforderlich,
Hinweise auf Teile der DXF-Datei, die nicht gelesen werden
konnten.
Der Operator read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf unterstützt die
folgenden DXF-Elemente:
-
POLYLINE
-
2D-Kurven, die aus Liniensegmenten bestehen
-
Geschlossene 2D-Kurven, die aus Liniensegmenten bestehen
-
LWPOLYLINE
-
LINE
-
POINT
-
CIRCLE
-
ARC
-
ELLIPSE
-
SPLINE
-
BLOCK
-
INSERT
Die X- und Y-Koordinaten der DXF-Elemente werden in den Spalten- und
Zeilenkoordinaten der XLD-Konturen ContoursContoursContoursContoursContourscontours gespeichert.
Die Z-Koordinaten der DXF-Elemente werden nicht berücksichtigt.
Wenn die Datei mit dem Operator write_contour_xld_dxfwrite_contour_xld_dxfWriteContourXldDxfwrite_contour_xld_dxfWriteContourXldDxfWriteContourXldDxf
erstellt wurde, werden alle Attribute und globalen Attribute
eingelesen, die für die ursprüngliche XLD-Kontur definiert waren.
Das heißt, read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf unterstützt die erweiterten
Elementdaten, die von write_contour_xld_dxfwrite_contour_xld_dxfWriteContourXldDxfwrite_contour_xld_dxfWriteContourXldDxfWriteContourXldDxf geschrieben werden.
Das Einlesen dieser Attribute kann durch Setzen des
generischen Parameters 'read_attributes'"read_attributes""read_attributes""read_attributes""read_attributes""read_attributes" auf
'false'"false""false""false""false""false" verhindert werden. Generische Parameter werden
durch Angabe des Parameternamens in GenParamNamesGenParamNamesGenParamNamesGenParamNamesGenParamNamesgenParamNames und des
dazugehörigen Wertes in GenParamValuesGenParamValuesGenParamValuesGenParamValuesGenParamValuesgenParamValues gesetzt.
DXF-Elemente vom Typ CIRCLE, ARC, ELLIPSE und SPLINE
werden durch XLD-Konturen 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.
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 approximiert.
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 der XLD-Kontur 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:
-
'read_attributes'"read_attributes""read_attributes""read_attributes""read_attributes""read_attributes" = 'true'"true""true""true""true""true"
-
'min_num_points'"min_num_points""min_num_points""min_num_points""min_num_points""min_num_points" = 20
-
'max_approx_error'"max_approx_error""max_approx_error""max_approx_error""max_approx_error""max_approx_error" = 0.25
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.
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Eingelesene XLD-Konturen.
Name der DXF-Datei.
Dateiendung: .dxf
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", 'read_attributes'"read_attributes""read_attributes""read_attributes""read_attributes""read_attributes"
Werte der generischen Parameter, die für den
DXF-Input eingestellt werden sollen.
Defaultwert: []
Wertevorschläge: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 0.1, 0.25, 0.5, 1, 2, 5, 10, 20
Wenn die Parameter korrekt sind und die angegebene Datei gelesen
werden konnte, liefert read_contour_xld_dxfread_contour_xld_dxfReadContourXldDxfread_contour_xld_dxfReadContourXldDxfReadContourXldDxf den Wert
2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
write_contour_xld_dxfwrite_contour_xld_dxfWriteContourXldDxfwrite_contour_xld_dxfWriteContourXldDxfWriteContourXldDxf
write_contour_xld_dxfwrite_contour_xld_dxfWriteContourXldDxfwrite_contour_xld_dxfWriteContourXldDxfWriteContourXldDxf,
read_polygon_xld_dxfread_polygon_xld_dxfReadPolygonXldDxfread_polygon_xld_dxfReadPolygonXldDxfReadPolygonXldDxf,
query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXld,
query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld,
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldget_contour_attrib_xldGetContourAttribXldGetContourAttribXld,
get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld
Foundation