HALCON Website / HALCON Operator-Referenz / 3D-Objektmodell / Generierung
KlassenKlassenKlassenKlassen | | | | Operatoren

set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod (Operator)

Name

set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod — Setzen von Attributen eines 3D-Objektmodells.

Signatur

set_object_model_3d_attrib_mod( : : ObjectModel3D, AttribName, AttachExtAttribTo, AttribValues : )

Herror set_object_model_3d_attrib_mod(const Hlong ObjectModel3D, const char* AttribName, const char* AttachExtAttribTo, double AttribValues)

Herror T_set_object_model_3d_attrib_mod(const Htuple ObjectModel3D, const Htuple AttribName, const Htuple AttachExtAttribTo, const Htuple AttribValues)

Herror set_object_model_3d_attrib_mod(const HTuple& ObjectModel3D, const HTuple& AttribName, const HTuple& AttachExtAttribTo, const HTuple& AttribValues)

void HObjectModel3D::SetObjectModel3dAttribMod(const HTuple& AttribName, const HTuple& AttachExtAttribTo, const HTuple& AttribValues) const

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 HOperatorSetX.SetObjectModel3dAttribMod(
[in] VARIANT ObjectModel3D, [in] VARIANT AttribName, [in] VARIANT AttachExtAttribTo, [in] VARIANT AttribValues)

void HObjectModel3DX.SetObjectModel3dAttribMod(
[in] VARIANT AttribName, [in] BSTR AttachExtAttribTo, [in] VARIANT AttribValues)

static void HOperatorSet.SetObjectModel3dAttribMod(HTuple objectModel3D, HTuple attribName, HTuple attachExtAttribTo, HTuple attribValues)

void HObjectModel3D.SetObjectModel3dAttribMod(HTuple attribName, string attachExtAttribTo, HTuple attribValues)

void HObjectModel3D.SetObjectModel3dAttribMod(string attribName, string attachExtAttribTo, double attribValues)

Beschreibung

set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod setzt Standard-Attribute und erweiterte Attribute in AttribNameAttribNameAttribNameAttribNameAttribNameattribName, eines 3D-Objektmodells ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D auf die Werte in AttribValuesAttribValuesAttribValuesAttribValuesAttribValuesattribValues. set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod ist identisch mit set_object_model_3d_attribset_object_model_3d_attribSetObjectModel3dAttribset_object_model_3d_attribSetObjectModel3dAttribSetObjectModel3dAttrib mit der Ausnahme, dass set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod kein neues 3D-Objektmodell erzeugt, sondern das bestehende verändert. Es ist über den Parameter AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo möglich, die Werte von erweiterten Attributen an bereits existierende Standard-Attribute des 3D-Objektmodells zu binden. Für Standard-Attribute wird AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo ignoriert.

Falls die Attribute in AttribNameAttribNameAttribNameAttribNameAttribNameattribName 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 AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo 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_attribSetObjectModel3dAttribset_object_model_3d_attribSetObjectModel3dAttribSetObjectModel3dAttrib.

Es ist zu beachten, dass falls ein 3D-Objektmodell nicht länger benötigt wird oder überschrieben werden soll, zunächst der Speicher wieder freigegeben werden muss durch Aufrufen des Operators clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d.

Achtung

Falls mehrere Attribute in AttribNameAttribNameAttribNameAttribNameAttribNameattribName übergeben werden, wird AttribValuesAttribValuesAttribValuesAttribValuesAttribValuesattribValues in gleich lange Teiltupel unterteilt. Jedes Teiltupel wird dann einem Attribut zugeordnet. Z.B.: Wenn AttribNameAttribNameAttribNameAttribNameAttribNameattribName und AttribValuesAttribValuesAttribValuesAttribValuesAttribValuesattribValues folgende Werte haben:

AttribNameAttribNameAttribNameAttribNameAttribNameattribName := ['&attrib1','&attrib2','&attrib3']["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"]["&attrib1","&attrib2","&attrib3"],

AttribValuesAttribValuesAttribValuesAttribValuesAttribValuesattribValues := [0.0,1.0,2.0,3.0,4.0,5.0],

werden die Attribute mit folgenden Werten gesetzt:

'&attrib1'"&attrib1""&attrib1""&attrib1""&attrib1""&attrib1" = [0.0,1.0], '&attrib2'"&attrib2""&attrib2""&attrib2""&attrib2""&attrib2" = [2.0,3.0], '&attrib3'"&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_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod verändert den Inhalt eines bereits bestehenden 3D-Objektmodells. Die Eingabedaten AttribValuesAttribValuesAttribValuesAttribValuesAttribValuesattribValues werden unverändert im 3D-Objektmodell gespeichert. Daher ist auf Konsistenz der Eingabedaten zu achten, da die meisten Operatoren konsistente 3D-Objektmodelle erwarten.

Parallelisierung

Parameter

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (input_control)  object_model_3d → HObjectModel3D, HTupleHTupleHObjectModel3D, HTupleHObjectModel3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des 3D-Objektmodells.

AttribNameAttribNameAttribNameAttribNameAttribNameattribName (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Namen der Attribute.

Werteliste: 'lines'"lines""lines""lines""lines""lines", 'point_coord_x'"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_y", 'point_coord_z'"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_x", 'point_normal_y'"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""point_normal_z", 'polygons'"polygons""polygons""polygons""polygons""polygons", 'triangles'"triangles""triangles""triangles""triangles""triangles", 'xyz_mapping'"xyz_mapping""xyz_mapping""xyz_mapping""xyz_mapping""xyz_mapping"

AttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToAttachExtAttribToattachExtAttribTo (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Beschreibt, woran ein erweitertes Attribut gehängt werden soll.

Defaultwert: []

Werteliste: [], 'lines'"lines""lines""lines""lines""lines", 'object'"object""object""object""object""object", 'points'"points""points""points""points""points", 'polygons'"polygons""polygons""polygons""polygons""polygons", 'triangles'"triangles""triangles""triangles""triangles""triangles"

AttribValuesAttribValuesAttribValuesAttribValuesAttribValuesattribValues (input_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Attribut-Werte.

Ergebnis

set_object_model_3d_attrib_modset_object_model_3d_attrib_modSetObjectModel3dAttribModset_object_model_3d_attrib_modSetObjectModel3dAttribModSetObjectModel3dAttribMod 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_3dGenEmptyObjectModel3dgen_empty_object_model_3dGenEmptyObjectModel3dGenEmptyObjectModel3d

Nachfolger

get_object_model_3d_paramsget_object_model_3d_paramsGetObjectModel3dParamsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParams

Alternativen

set_object_model_3d_attribset_object_model_3d_attribSetObjectModel3dAttribset_object_model_3d_attribSetObjectModel3dAttribSetObjectModel3dAttrib

Modul

3D Metrology

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