Name
prepare_object_model_3dT_prepare_object_model_3dPrepareObjectModel3dprepare_object_model_3dPrepareObjectModel3dPrepareObjectModel3d — Vorbereiten eines 3D-Objektmodells für nachfolgende Operationen.
void PrepareObjectModel3d(const HTuple& ObjectModel3D, const HTuple& Purpose, const HTuple& OverwriteData, const HTuple& GenParamName, const HTuple& GenParamValue)
static void HObjectModel3D::PrepareObjectModel3d(const HObjectModel3DArray& ObjectModel3D, const HString& Purpose, const HString& OverwriteData, const HTuple& GenParamName, const HTuple& GenParamValue)
void HObjectModel3D::PrepareObjectModel3d(const HString& Purpose, const HString& OverwriteData, const HTuple& GenParamName, const HTuple& GenParamValue) const
void HObjectModel3D::PrepareObjectModel3d(const char* Purpose, const char* OverwriteData, const HTuple& GenParamName, const HTuple& GenParamValue) const
static void HOperatorSet.PrepareObjectModel3d(HTuple objectModel3D, HTuple purpose, HTuple overwriteData, HTuple genParamName, HTuple genParamValue)
static void HObjectModel3D.PrepareObjectModel3d(HObjectModel3D[] objectModel3D, string purpose, string overwriteData, HTuple genParamName, HTuple genParamValue)
void HObjectModel3D.PrepareObjectModel3d(string purpose, string overwriteData, HTuple genParamName, HTuple genParamValue)
Der Operator prepare_object_model_3dprepare_object_model_3dPrepareObjectModel3dprepare_object_model_3dPrepareObjectModel3dPrepareObjectModel3d bereitet ein
3D-Objektmodell ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D für eine nachfolgende
Operation, die in PurposePurposePurposePurposePurposepurpose festgelegt ist, vor. Der
Operator berechnet Werte, die für die Operation erforderlich sind,
und speichert diese in ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D, um die Geschwindigkeit
der nachfolgenden Operationen zu erhöhen. Es ist nicht notwendig
den Operator prepare_object_model_3dprepare_object_model_3dPrepareObjectModel3dprepare_object_model_3dPrepareObjectModel3dPrepareObjectModel3d aufzurufen. Wenn das
3D-Objektmodell mehrere Male von derselben Operation benutzt wird,
kann es allerdings die Geschwindigkeit der Operation erhöhen.
Die folgenden Werte für den Parameter PurposePurposePurposePurposePurposepurpose sind möglich:
- 'shape_based_matching_3d'"shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d":
-
Das 3D-Objektmodell wird für die Nutzung im Operator
create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3d vorbereitet. In diesem Fall können
keine generischen Parameter gesetzt werden.
- 'segmentation'"segmentation""segmentation""segmentation""segmentation""segmentation":
-
Das 3D-Objektmodell wird für die Nutzung im Operator
segment_object_model_3dsegment_object_model_3dSegmentObjectModel3dsegment_object_model_3dSegmentObjectModel3dSegmentObjectModel3d vorbereitet. Um die Vorbereitung
durchführen zu können muss das 3D-Objektmodell das Attribut mit
den Oberflächendreiecken und das Attribut mit den Punktkoordinaten
beinhalten.
Wenn das 3D-Objektmodell kein Attribut mit den
Oberflächendreiecken hat, wird eine einfache Dreiecksvermaschung
durchgeführt. Hierfür muss das 3D-Objektmodell das Attribut mit
den Punktkoordinaten und das Attribut mit der Zuordnung der 3D
Punkte zu den Bildkoordinaten beinhalten. Es wird nur zwischen
Punkten trianguliert, die von benachbarten Pixeln stammen. Zusätzlich
können Löcher in der Bildregion mit einer Delaunay Dreiecksvermaschung
gefüllt werden (siehe 'max_area_holes'"max_area_holes""max_area_holes""max_area_holes""max_area_holes""max_area_holes" unten). Nur Löcher, die
vollständig von der Bildregion eingeschlossen sind, werden geschlossen.
- 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation":
Das 3D-Objektmodell wird für die Verwendung als Zielmodell in
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d vorbereitet.
Der Parameter OverwriteDataOverwriteDataOverwriteDataOverwriteDataOverwriteDataoverwriteData legt fest, ob vorhandene
Daten eines bereits vorbereiteten 3D-Objektmodells gelöscht werden
sollen. Falls OverwriteDataOverwriteDataOverwriteDataOverwriteDataOverwriteDataoverwriteData auf 'true'"true""true""true""true""true" gesetzt
ist, werden die vorbereiteten Daten, die durch den Parameter
PurposePurposePurposePurposePurposepurpose festgelegt sind, überschrieben. Falls
OverwriteDataOverwriteDataOverwriteDataOverwriteDataOverwriteDataoverwriteData auf 'false'"false""false""false""false""false" gesetzt ist, werden die
bereits vorbereiteten Daten nicht überschrieben.
Der Parameter OverwriteDataOverwriteDataOverwriteDataOverwriteDataOverwriteDataoverwriteData kann benutzt werden, wenn andere
generische Parameter GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
gesetzt werden. Der Parameter OverwriteDataOverwriteDataOverwriteDataOverwriteDataOverwriteDataoverwriteData hat keinen
Einfluss, wenn der Parameter PurposePurposePurposePurposePurposepurpose auf
'shape_based_matching_3d'"shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d" gesetzt ist, da in diesem
Fall keine generischen Parameter gesetzt werden können.
Die generischen Parameter können optional genutzt werden um die
Vorbereitung zu beeinflussen. Falls gewünscht, können die
generischen Parameter und deren Werte in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und
GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue übergeben werden. Die folgenden Werte für
GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und die dazugehörigen Werte für
GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue sind möglich:
- 'max_area_holes'"max_area_holes""max_area_holes""max_area_holes""max_area_holes""max_area_holes":
-
Dieser Parameter ist nur gültig,
falls PurposePurposePurposePurposePurposepurpose auf 'segmentation'"segmentation""segmentation""segmentation""segmentation""segmentation" gesetzt ist.
Der Parameter legt fest, welche Fläche die Löcher in den
Punktkoodinaten haben dürfen, damit diese mittels einer Delaunay
Dreiecksvermaschung geschlossen werden. Nur Löcher, die vollständig
von der Bildregion eingeschlossen sind, werden geschlossen. Falls
'max_area_holes'"max_area_holes""max_area_holes""max_area_holes""max_area_holes""max_area_holes" auf 0 gesetzt ist, werden
keine Löcher vermascht. Falls 'max_area_holes'"max_area_holes""max_area_holes""max_area_holes""max_area_holes""max_area_holes" größer oder
gleich 1 Pixel gesetzt ist, werden die Löcher mit einer
Fläche kleiner oder gleich 'max_area_holes'"max_area_holes""max_area_holes""max_area_holes""max_area_holes""max_area_holes" mittels einer
Vermaschung geschlossen.
Wertevorschläge: 1, 10, 100
Defaultwert: 10
- 'distance_to'"distance_to""distance_to""distance_to""distance_to""distance_to":
-
Dieser Parameter ist nur gültig,
falls PurposePurposePurposePurposePurposepurpose auf 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation" gesetzt ist.
Dieser Parameter bestimmt die Zieldaten zu denen der Abstand
berechnet werden soll.
Der Parameter wird in der Dokumentation zu
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d genauer beschrieben.
Mögliche Werte: 'auto'"auto""auto""auto""auto""auto", 'triangles'"triangles""triangles""triangles""triangles""triangles",
'points'"points""points""points""points""points", 'primitive'"primitive""primitive""primitive""primitive""primitive"
Defaultwert: 'auto'"auto""auto""auto""auto""auto"
- 'method'"method""method""method""method""method":
-
Dieser Parameter ist nur gültig,
falls PurposePurposePurposePurposePurposepurpose auf 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation" gesetzt ist.
Dieser Parameter bestimmt die Methode mit welcher der Abstand
berechnet werden soll.
Der Parameter wird in der Dokumentation zu
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d genauer beschrieben.
Mögliche Werte: 'auto'"auto""auto""auto""auto""auto", 'kd-tree'"kd-tree""kd-tree""kd-tree""kd-tree""kd-tree",
'voxel'"voxel""voxel""voxel""voxel""voxel", 'linear'"linear""linear""linear""linear""linear"
Defaultwert: 'auto'"auto""auto""auto""auto""auto"
- 'max_distance'"max_distance""max_distance""max_distance""max_distance""max_distance":
-
Dieser Parameter ist nur gültig,
falls PurposePurposePurposePurposePurposepurpose auf 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation" gesetzt ist.
Dieser Parameter bestimmt den maximal interessanten Abstand.
Wird der Parameter auf 0 gesetzt, so wird kein maximaler
Abstand verwendet.
Der Parameter wird in der Dokumentation zu
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d genauer beschrieben.
Wertevorschläge: 0, 0.1,
1, 10
Defaultwert: 0
- 'sampling_dist_rel'"sampling_dist_rel""sampling_dist_rel""sampling_dist_rel""sampling_dist_rel""sampling_dist_rel":
-
Dieser Parameter ist nur gültig,
falls PurposePurposePurposePurposePurposepurpose auf 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation" gesetzt ist.
Dieser Parameter setzt die relative Abtastdistanz falls der
Abstand zu Dreiecken mit der Methode 'voxel'"voxel""voxel""voxel""voxel""voxel" berechnet wird.
Der Parameter wird in der Dokumentation zu
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d genauer beschrieben.
Wertevorschläge: 0.03, 0.01
Defaultwert: 0.03
- 'sampling_dist_abs'"sampling_dist_abs""sampling_dist_abs""sampling_dist_abs""sampling_dist_abs""sampling_dist_abs":
-
Dieser Parameter ist nur gültig,
falls PurposePurposePurposePurposePurposepurpose auf 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation" gesetzt ist.
Dieser Parameter setzt die absolute Abtastdistanz falls der
Abstand zu Dreiecken mit der Methode 'voxel'"voxel""voxel""voxel""voxel""voxel" berechnet wird.
Der Parameter wird in der Dokumentation zu
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d genauer beschrieben.
Wertevorschläge: 1, 5, 10
Defaultwert: None
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Handle des 3D-Objektmodells.
Zweck des 3D-Objektmodells.
Defaultwert:
'shape_based_matching_3d'
"shape_based_matching_3d"
"shape_based_matching_3d"
"shape_based_matching_3d"
"shape_based_matching_3d"
"shape_based_matching_3d"
Wertevorschläge: 'shape_based_matching_3d'"shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d""shape_based_matching_3d", 'segmentation'"segmentation""segmentation""segmentation""segmentation""segmentation", 'distance_computation'"distance_computation""distance_computation""distance_computation""distance_computation""distance_computation"
Legt fest, ob schon vorhandene Daten überschrieben werden.
Defaultwert:
'true'
"true"
"true"
"true"
"true"
"true"
Werteliste: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"
Name des generischen Parameters.
Defaultwert: []
Werteliste: 'distance_to'"distance_to""distance_to""distance_to""distance_to""distance_to", 'max_area_holes'"max_area_holes""max_area_holes""max_area_holes""max_area_holes""max_area_holes", 'max_distance'"max_distance""max_distance""max_distance""max_distance""max_distance", 'method'"method""method""method""method""method", 'sampling_dist_abs'"sampling_dist_abs""sampling_dist_abs""sampling_dist_abs""sampling_dist_abs""sampling_dist_abs", 'sampling_dist_rel'"sampling_dist_rel""sampling_dist_rel""sampling_dist_rel""sampling_dist_rel""sampling_dist_rel"
Wert des generischen Parameters.
Defaultwert: []
Wertevorschläge: 0, 1, 100, 'auto'"auto""auto""auto""auto""auto", 'triangles'"triangles""triangles""triangles""triangles""triangles", 'points'"points""points""points""points""points", 'primitive'"primitive""primitive""primitive""primitive""primitive", 'kd-tree'"kd-tree""kd-tree""kd-tree""kd-tree""kd-tree", 'voxel'"voxel""voxel""voxel""voxel""voxel", 'linear'"linear""linear""linear""linear""linear", 0.01, 0.03
prepare_object_model_3dprepare_object_model_3dPrepareObjectModel3dprepare_object_model_3dPrepareObjectModel3dPrepareObjectModel3d liefert den Wert 2 (H_MSG_TRUE), falls die
Parameter korrekt sind. Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
read_object_model_3dread_object_model_3dReadObjectModel3dread_object_model_3dReadObjectModel3dReadObjectModel3d,
xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d
create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3d,
create_surface_modelcreate_surface_modelCreateSurfaceModelcreate_surface_modelCreateSurfaceModelCreateSurfaceModel,
distance_object_model_3ddistance_object_model_3dDistanceObjectModel3ddistance_object_model_3dDistanceObjectModel3dDistanceObjectModel3d,
find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel,
fit_primitives_object_model_3dfit_primitives_object_model_3dFitPrimitivesObjectModel3dfit_primitives_object_model_3dFitPrimitivesObjectModel3dFitPrimitivesObjectModel3d,
refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose,
segment_object_model_3dsegment_object_model_3dSegmentObjectModel3dsegment_object_model_3dSegmentObjectModel3dSegmentObjectModel3d,
simplify_object_model_3dsimplify_object_model_3dSimplifyObjectModel3dsimplify_object_model_3dSimplifyObjectModel3dSimplifyObjectModel3d
3D Metrology