write_contour_xld_dxf — Schreiben von XLD-Konturen im DXF-Format.
write_contour_xld_dxf schreibt die XLD-Konturen
Contours im DXF-Format in die Datei
FileName. Wenn kein absoluter Pfad in FileName
angegeben wird, wird die Ausgabedatei im aktuellen Verzeichnis des
HALCON-Prozesses geschrieben.
Neben der Geometrie der Contours werden auch sämtliche
Attribute und globalen Attribute, die für Contours
definiert sind, in die Datei geschrieben.
write_contour_xld_dxf schreibt eine Datei im Format der
DXF-Version AC1009 (AutoCAD Release 12). Jede Kontur wird als
POLYLINE gespeichert. Die Attributwerte werden als erweiterte
Elementdaten zu jedem VERTEX der POLYLINE geschrieben.
Die globalen Attributwerte werden als erweiterte Elementdaten
der POLYLINE geschrieben. Sämtliche Attributnamen
werden ebenfalls als erweiterte Elementdaten der POLYLINE
geschrieben.
Der Operator read_contour_xld_dxf kann verwendet werden,
um die XLD Konturen zusammen mit ihren Attributen wieder einzulesen.
Andere Anwendungsprogramme, die DXF-Dateien einlesen können, importieren typischerweise nur die Geometrieinformation der Konturen. Die Attribute werden ignoriert.
Beschreibung des Formats der erweiterten Elementdaten
Die erweiterten Elementdaten werden jeweils durch folgende DXF-Gruppe eingeleitet:
1001 HALCON
Attribute werden in folgendem Format als erweiterte Elementdaten zu jedem VERTEX geschrieben:
| DXF | Erläuterung |
|---|---|
| 1000 | Bedeutung |
| contour attributes | |
| 1002 | Beginn der Werteliste |
| { | |
| 1070 | Anzahl von Attributen (hier: 3) |
| 3 | |
| 1040 | Wert des ersten Attributs |
| 5.00434303 | |
| 1040 | Wert des zweiten Attributs |
| 126.8638916 | |
| 1040 | Wert des dritten Attributs |
| 4.99164152 | |
| 1002 | Ende der Werteliste |
| } |
Globale Attribute werden in folgendem Format als erweiterte Elementdaten zu jeder POLYLINE geschrieben:
| DXF | Erläuterung |
|---|---|
| 1000 | Bedeutung |
| global contour attributes | |
| 1002 | Beginn der Werteliste |
| { | |
| 1070 | Anzahl globaler Attribute (hier: 5) |
| 5 | |
| 1040 | Wert des ersten globalen Attributs |
| 0.77951831 | |
| 1040 | Wert des zweiten globalen Attributs |
| 0.62637949 | |
| 1040 | Wert des dritten globalen Attributs |
| 103.94314575 | |
| 1040 | Wert des vierten globalen Attributs |
| 0.21434096 | |
| 1040 | Wert des fünften globalen Attributs |
| 0.21921949 | |
| 1002 | Ende der Werteliste |
| } |
Die Namen der Attribute werden in folgendem Format als erweiterte Elementdaten zu jeder POLYLINE geschrieben:
| DXF | Erläuterung |
|---|---|
| 1000 | Bedeutung |
| names of contour attributes | |
| 1002 | Beginn der Werteliste |
| { | |
| 1070 | Anzahl von Attributnamen (hier: 3) |
| 3 | |
| 1000 | Name des ersten Attributs |
| angle | |
| 1000 | Name des zweiten Attributs |
| response | |
| 1000 | Name des dritten Attributs |
| edge_direction | |
| 1002 | Ende der Werteliste |
| } |
Die Namen der globalen Attribute werden in folgendem Format als erweiterte Elementdaten zu jeder POLYLINE geschrieben:
| DXF | Erläuterung |
|---|---|
| 1000 | Bedeutung |
| names of global contour attributes | |
| 1002 | Beginn der Werteliste |
| { | |
| 1070 | Anzahl von globalen Attributnamen (hier: 5) |
| 5 | |
| 1000 | Name des ersten globalen Attributs |
| regr_norm_row | |
| 1000 | Name des zweiten globalen Attributs |
| regr_norm_col | |
| 1000 | Name des dritten globalen Attributs |
| regr_dist | |
| 1000 | Name des vierten globalen Attributs |
| regr_mean_dist | |
| 1000 | Name des fünften globalen Attributs |
| regr_dev_dist | |
| 1002 | Ende der Werteliste |
| } |
Contours (input_object) xld_cont(-array) → object
Zu schreibende XLD-Konturen.
FileName (input_control) filename.write → (string)
Name der DXF-Datei.
Dateiendung: .dxf
Wenn die Parameter korrekt sind und die angegebene Datei geschrieben
werden konnte, liefert write_contour_xld_dxf den Wert
2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.
read_contour_xld_dxf,
write_polygon_xld_dxf,
query_contour_attribs_xld,
query_contour_global_attribs_xld,
get_contour_attrib_xld,
get_contour_global_attrib_xld
Foundation