get_surface_model_paramT_get_surface_model_paramGetSurfaceModelParamGetSurfaceModelParam (Operator)
Name
get_surface_model_paramT_get_surface_model_paramGetSurfaceModelParamGetSurfaceModelParam — Auslesen von Einstellungen und Eigenschaften eines Oberflächenmodells.
Signatur
Beschreibung
get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParam liefert Einstellungen und Eigenschaften des
Oberflächenmodells SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID.
Das Oberflächenmodell muss mittels create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel oder
read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModel erstellt worden sein.
Die Namen der abzurufenden Werte werden im generischen Parameter
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName übergeben, die entsprechenden Werte werden in
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue zurückgegeben.
Die folgenden Werte sind für GenParamNameGenParamNameGenParamNameGenParamNamegenParamName möglich:
- 'diameter'"diameter""diameter""diameter""diameter":
-
Durchmesser der Modellpunktwolke. Der Durchmesser ist die Länge der
Diagonalen des umschließenden achsenparallelen Quaders (siehe
'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1").
- 'center'"center""center""center""center":
-
Mittelpunkt des Modells. Der Mittelpunkt ist das Zentrum des
umschließenden achsenparallelen Quaders (siehe
'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1").
- 'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1":
-
Kleinster umschließender achsenparalleler Quader, zurückgegeben als
(min_x, min_y, min_z, max_x, max_y, max_z).
- 'sampled_model'"sampled_model""sampled_model""sampled_model""sampled_model":
-
Die für das Matching abgetasteten 3D-Punkte des Modells.
Zurückgegeben wird das Handle eines 3D-Objektmodells, welches alle
Punkte enthält, die für das näherungsweise Matching abgetastet wurden
(siehe create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel).
- 'sampled_pose_refinement'"sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement":
-
Die für die Pose-Verfeinerung abgetasteten 3D-Punkte des Modells.
Zurückgegeben wird das Handle eines 3D-Objektmodells, welches alle
Punkte enthält die für die Pose-Verfeinerung abgetastet wurden
(siehe create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel).
- '3d_edges_trained'"3d_edges_trained""3d_edges_trained""3d_edges_trained""3d_edges_trained":
-
Gibt zurück ob das Oberflächenmodell für kantenunterstützte Matching
vorbereitet wurde, d.h., ob der Parameter 'train_3d_edges'"train_3d_edges""train_3d_edges""train_3d_edges""train_3d_edges"
in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel für dieses Modell aktiviert wurde.
Zurückgegeben wird der String 'true'"true""true""true""true" oder 'false'"false""false""false""false".
- 'view_based_trained'"view_based_trained""view_based_trained""view_based_trained""view_based_trained":
-
Gibt zurück ob das Oberflächenmodell zur Berechnung einer ansichtsbasierten
Bewertung während des Matchings vorbereitet wurde, d.h., ob der Parameter
'train_view_based'"train_view_based""train_view_based""train_view_based""train_view_based" in create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel für dieses
Modell aktiviert wurde.
Zurückgegeben wird der String 'true'"true""true""true""true" oder 'false'"false""false""false""false".
- 'camera_parameter'"camera_parameter""camera_parameter""camera_parameter""camera_parameter":
-
- 'camera_parameter X'"camera_parameter X""camera_parameter X""camera_parameter X""camera_parameter X":
-
Gibt die Kameraparameter der Kamera mit der Nummer X zurück, wobei X
ein 0-basierter Index ist.
Falls nicht angegeben, ist X standardmäßig 0 (erste Kamera).
Die Kameraparameter müssen vorher mittels
set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam gesetzt worden sein.
- 'camera_pose'"camera_pose""camera_pose""camera_pose""camera_pose":
-
- 'camera_pose X'"camera_pose X""camera_pose X""camera_pose X""camera_pose X":
-
Gibt die Kamerapose der Kamera mit der Nummer X zurück, wobei X
ein 0-basierter Index ist.
Falls nicht angegeben, ist X standardmäßig 0 (erste Kamera).
- 'symmetry_axis_direction'"symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction":
-
- 'symmetry_axis_origin'"symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin":
Gibt die Richtung der vorher mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam
gesetzten Symmetrieachse bzw. einen auf ihr liegenden Punkt zurück.
Wenn keine Achse gesetzt wurde, wird ein leeres Tupel zurückgegeben.
- 'symmetry_poses'"symmetry_poses""symmetry_poses""symmetry_poses""symmetry_poses":
Gibt die mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam gesetzten Symmetrieposen
zurück.
- 'symmetry_poses_all'"symmetry_poses_all""symmetry_poses_all""symmetry_poses_all""symmetry_poses_all":
-
Gibt alle Symmetrieposen zurück, die set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam
auf Grundlage der gesetzten Symmetrieposen gefunden hat.
- 'pose_restriction_reference_pose'"pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose":
Gibt die mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam gesetzte Referenzpose des
Modells zurück.
Wenn keine Referenzpose gesetzt ist, wird ein leeres Tupel
zurückgegeben.
- 'pose_restriction_max_angle_diff'"pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff":
Gibt die mittels set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam gesetzte maximale
Winkeldifferenz zwischen der Referenzpose und einer gefundenen Pose
zurück. Der Winkel wird im Bogenmaß zurückgegeben.
Wenn keine Winkeldifferenz gesetzt ist, wird ein leeres Tupel
zurückgegeben.
- 'pose_restriction_allowed_axis_direction'"pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction":
-
- 'pose_restriction_allowed_axis_origin'"pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin":
Gibt die Richtung der vorher mit set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam
gesetzten zu ignorierenden Rotationsachse zurück.
Wenn keine Achse gesetzt wurde, wird ein leeres Tupel zurückgegeben.
- 'pose_restriction_filter_final_poses_only'"pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only":
Gibt 'true'"true""true""true""true" zurück, wenn nur die finalen Posen gefiltert werden
sollen, oder
'false'"false""false""false""false", wenn die Filterung bereits während des
Matchingprozesses geschehen soll (Standardwert).
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
SurfaceModelIDSurfaceModelIDSurfaceModelIDSurfaceModelIDsurfaceModelID (input_control) surface_model → HSurfaceModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Oberflächenmodells.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name der abzurufenden Eigenschaft.
Defaultwert:
'diameter'
"diameter"
"diameter"
"diameter"
"diameter"
Werteliste: '3d_edges_trained'"3d_edges_trained""3d_edges_trained""3d_edges_trained""3d_edges_trained", 'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1", 'camera_parameter'"camera_parameter""camera_parameter""camera_parameter""camera_parameter", 'camera_pose'"camera_pose""camera_pose""camera_pose""camera_pose", 'center'"center""center""center""center", 'diameter'"diameter""diameter""diameter""diameter", 'pose_restriction_allowed_axis_direction'"pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction""pose_restriction_allowed_axis_direction", 'pose_restriction_allowed_axis_origin'"pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin""pose_restriction_allowed_axis_origin", 'pose_restriction_filter_final_poses_only'"pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only""pose_restriction_filter_final_poses_only", 'pose_restriction_max_angle_diff'"pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff""pose_restriction_max_angle_diff", 'pose_restriction_reference_pose'"pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose""pose_restriction_reference_pose", 'sampled_model'"sampled_model""sampled_model""sampled_model""sampled_model", 'sampled_pose_refinement'"sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement""sampled_pose_refinement", 'symmetry_axis_direction'"symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction""symmetry_axis_direction", 'symmetry_axis_origin'"symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin""symmetry_axis_origin", 'symmetry_poses'"symmetry_poses""symmetry_poses""symmetry_poses""symmetry_poses", 'symmetry_poses_all'"symmetry_poses_all""symmetry_poses_all""symmetry_poses_all""symmetry_poses_all", 'view_based_trained'"view_based_trained""view_based_trained""view_based_trained""view_based_trained"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (output_control) attribute.value(-array) → HTupleHTupleHtuple (real / string / integer / handle) (double / string / int / long / HHandle) (double / HString / Hlong / HHandle) (double / char* / Hlong / handle)
Wert der abzurufenden Eigenschaft.
Ergebnis
Wenn alle Parameter korrekt sind liefert get_surface_model_paramget_surface_model_paramGetSurfaceModelParamGetSurfaceModelParamGetSurfaceModelParam den
Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel,
read_surface_modelread_surface_modelReadSurfaceModelReadSurfaceModelReadSurfaceModel
Nachfolger
find_surface_modelfind_surface_modelFindSurfaceModelFindSurfaceModelFindSurfaceModel,
refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPoseRefineSurfaceModelPose,
write_surface_modelwrite_surface_modelWriteSurfaceModelWriteSurfaceModelWriteSurfaceModel
Siehe auch
create_surface_modelcreate_surface_modelCreateSurfaceModelCreateSurfaceModelCreateSurfaceModel,
set_surface_model_paramset_surface_model_paramSetSurfaceModelParamSetSurfaceModelParamSetSurfaceModelParam
Modul
3D Metrology