set_object_model_3d_attrib_modT_set_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod (Operator)
Name
set_object_model_3d_attrib_modT_set_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod — Setzen von Attributen eines 3D-Objektmodells.
Signatur
void SetObjectModel3dAttribMod(const HTuple& ObjectModel3D, const HTuple& AttribName, const HTuple& AttachExtAttribTo, const HTuple& AttribValues)
void HObjectModel3D::SetObjectModel3dAttribMod(const HTuple& AttribName, const HString& AttachExtAttribTo, const HTuple& AttribValues) const
void HObjectModel3D::SetObjectModel3dAttribMod(const HString& AttribName, const HString& AttachExtAttribTo, double AttribValues) const
void HObjectModel3D::SetObjectModel3dAttribMod(const char* AttribName, const char* AttachExtAttribTo, double AttribValues) const
void HObjectModel3D::SetObjectModel3dAttribMod(const wchar_t* AttribName, const wchar_t* AttachExtAttribTo, double AttribValues) const
(Nur Windows)
Beschreibung
set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod setzt Standard-Attribute und
erweiterte Attribute in AttribNameAttribNameAttribNameAttribNameattribName, eines 3D-Objektmodells
ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D auf die Werte in AttribValuesAttribValuesAttribValuesAttribValuesattribValues.
set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod
ist identisch mit set_object_model_3d_attribset_object_model_3d_attribSetObjectModel3dAttribSetObjectModel3dAttribSetObjectModel3dAttrib mit der Ausnahme,
dass set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod kein neues 3D-Objektmodell
erzeugt, sondern das bestehende verändert. Es ist über den Parameter AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo
möglich, die Werte von erweiterten Attributen an bereits existierende
Standard-Attribute des 3D-Objektmodells zu binden.
Für Standard-Attribute wird AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo ignoriert.
Falls die Attribute in AttribNameAttribNameAttribNameAttribNameattribName nicht existieren, werden
sie wenn möglich neu erstellt. Sollen bereits im
3D-Objektmodell vorhandene Attribute gesetzt werden, muss die Länge der
neuen Daten der Länge der alten Daten entsprechen. Ist dies der Fall,
werden die alten Daten überschrieben.
Falls erweiterte Attribute mit AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo an bereits
existierende Standard-Attribute gehängt werden sollen, muss die
Länge der neuen Daten den bereits vorhandenen Standard-Attribut-Werten
entsprechen.
Für eine detaillierte Beschreibung siehe set_object_model_3d_attribset_object_model_3d_attribSetObjectModel3dAttribSetObjectModel3dAttribSetObjectModel3dAttrib.
Achtung
Falls mehrere Attribute in AttribNameAttribNameAttribNameAttribNameattribName übergeben werden, wird
AttribValuesAttribValuesAttribValuesAttribValuesattribValues in gleich lange Teiltupel unterteilt. Jedes
Teiltupel wird dann einem Attribut zugeordnet.
Z.B.: Wenn AttribNameAttribNameAttribNameAttribNameattribName und AttribValuesAttribValuesAttribValuesAttribValuesattribValues folgende
Werte haben:
AttribNameAttribNameAttribNameAttribNameattribName := ['&attrib1','&attrib2','&attrib3']["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"],
AttribValuesAttribValuesAttribValuesAttribValuesattribValues := [0.0,1.0,2.0,3.0,4.0,5.0],
werden die Attribute mit folgenden Werten gesetzt:
'&attrib1'"&attrib1""&attrib1""&attrib1""&attrib1" = [0.0,1.0],
'&attrib2'"&attrib2""&attrib2""&attrib2""&attrib2" = [2.0,3.0],
'&attrib3'"&attrib3""&attrib3""&attrib3""&attrib3" = [4.0,5.0].
Folglich ist es nicht möglich,
mehrere Attribute unterschiedlicher Länge in einem Aufruf zu setzen.
set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod verändert den Inhalt eines
bereits bestehenden 3D-Objektmodells. Die Eingabedaten AttribValuesAttribValuesAttribValuesAttribValuesattribValues
werden unverändert im 3D-Objektmodell gespeichert. Daher ist auf
Konsistenz der Eingabedaten zu achten, da die meisten Operatoren
konsistente 3D-Objektmodelle erwarten.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (input_control) object_model_3d → HObjectModel3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des 3D-Objektmodells.
AttribNameAttribNameAttribNameAttribNameattribName (input_control) string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Namen der Attribute.
Werteliste: 'blue'"blue""blue""blue""blue", 'green'"green""green""green""green", 'lines'"lines""lines""lines""lines", 'original_point_indices'"original_point_indices""original_point_indices""original_point_indices""original_point_indices", 'point_coord_x'"point_coord_x""point_coord_x""point_coord_x""point_coord_x", 'point_coord_y'"point_coord_y""point_coord_y""point_coord_y""point_coord_y", 'point_coord_z'"point_coord_z""point_coord_z""point_coord_z""point_coord_z", 'point_normal_x'"point_normal_x""point_normal_x""point_normal_x""point_normal_x", 'point_normal_y'"point_normal_y""point_normal_y""point_normal_y""point_normal_y", 'point_normal_z'"point_normal_z""point_normal_z""point_normal_z""point_normal_z", 'polygons'"polygons""polygons""polygons""polygons", 'red'"red""red""red""red", 'score'"score""score""score""score", 'triangles'"triangles""triangles""triangles""triangles", 'xyz_mapping'"xyz_mapping""xyz_mapping""xyz_mapping""xyz_mapping"
AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Beschreibt, woran ein erweitertes Attribut gehängt werden soll.
Defaultwert: []
Werteliste: [], 'lines'"lines""lines""lines""lines", 'object'"object""object""object""object", 'points'"points""points""points""points", 'polygons'"polygons""polygons""polygons""polygons", 'triangles'"triangles""triangles""triangles""triangles"
AttribValuesAttribValuesAttribValuesAttribValuesattribValues (input_control) real(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Attribut-Werte.
Ergebnis
set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribModSetObjectModel3dAttribMod liefert den Wert 2 (H_MSG_TRUE) wenn alle
Parameter korrekt sind. Andernfalls wird eine Fehlerbehandlung
durchgeführt.
Vorgänger
gen_empty_object_model_3dgen_empty_object_model_3dGenEmptyObjectModel3dGenEmptyObjectModel3dGenEmptyObjectModel3d
Nachfolger
get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParamsGetObjectModel3dParams
Alternativen
set_object_model_3d_attribset_object_model_3d_attribSetObjectModel3dAttribSetObjectModel3dAttribSetObjectModel3dAttrib
Siehe auch
copy_object_model_3dcopy_object_model_3dCopyObjectModel3dCopyObjectModel3dCopyObjectModel3d,
remove_object_model_3d_attrib_modremove_object_model_3d_attrib_modRemoveObjectModel3dAttribModRemoveObjectModel3dAttribModRemoveObjectModel3dAttribMod
Modul
3D Metrology