get_shape_model_3d_paramsT_get_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params (Operator)

Name

get_shape_model_3d_paramsT_get_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params — Auslesen der Parameter eines 3D-Formmodells.

Signatur

get_shape_model_3d_params( : : ShapeModel3DID, GenParamName : GenParamValue)

Herror T_get_shape_model_3d_params(const Htuple ShapeModel3DID, const Htuple GenParamName, Htuple* GenParamValue)

void GetShapeModel3dParams(const HTuple& ShapeModel3DID, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HShapeModel3D::GetShapeModel3dParams(const HTuple& GenParamName) const

HTuple HShapeModel3D::GetShapeModel3dParams(const HString& GenParamName) const

HTuple HShapeModel3D::GetShapeModel3dParams(const char* GenParamName) const

HTuple HShapeModel3D::GetShapeModel3dParams(const wchar_t* GenParamName) const   (Nur Windows)

static void HOperatorSet.GetShapeModel3dParams(HTuple shapeModel3DID, HTuple genParamName, out HTuple genParamValue)

HTuple HShapeModel3D.GetShapeModel3dParams(HTuple genParamName)

HTuple HShapeModel3D.GetShapeModel3dParams(string genParamName)

def get_shape_model_3d_params(shape_model_3did: HHandle, gen_param_name: MaybeSequence[str]) -> Sequence[Union[int, str, float]]

def get_shape_model_3d_params_s(shape_model_3did: HHandle, gen_param_name: MaybeSequence[str]) -> Union[int, str, float]

Beschreibung

Mit Hilfe des Operators get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params lassen sich Parameter des 3D-Objektmodells abfragen.

Die Namen der Parameter, die abgefragt werden sollen, werden in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name übergeben, die korrespondierenden Werte werden in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value zurückgeliefert.

Im Einzelnen kann auf die folgenden Parameter zugegriffen werden:

'cam_param'"cam_param""cam_param""cam_param""cam_param""cam_param":

Interne Parameter der für das Matching zu verwendenden Kamera.

'ref_rot_x'"ref_rot_x""ref_rot_x""ref_rot_x""ref_rot_x""ref_rot_x":

Referenzorientierung: Rotation um x-Achse bzw. x-Komponente des Rodriguez-Vektors (in Bogenmaß bzw. ohne Einheit).

'ref_rot_y'"ref_rot_y""ref_rot_y""ref_rot_y""ref_rot_y""ref_rot_y":

Referenzorientierung: Rotation um y-Achse bzw. y-Komponente des Rodriguez-Vektors (in Bogenmaß bzw. ohne Einheit).

'ref_rot_z'"ref_rot_z""ref_rot_z""ref_rot_z""ref_rot_z""ref_rot_z":

Referenzorientierung: Rotation um z-Achse bzw. z-Komponente des Rodriguez-Vektors (in Bogenmaß bzw. ohne Einheit).

'order_of_rotation'"order_of_rotation""order_of_rotation""order_of_rotation""order_of_rotation""order_of_rotation":

Bedeutung der Rotationswerte der Referenzorientierung.

'longitude_min'"longitude_min""longitude_min""longitude_min""longitude_min""longitude_min":

Kleinste geographische Länge der Modellansichten.

'longitude_max'"longitude_max""longitude_max""longitude_max""longitude_max""longitude_max":

Größte geographische Länge der Modellansichten.

'latitude_min'"latitude_min""latitude_min""latitude_min""latitude_min""latitude_min":

Kleinste geographische Breite der Modellansichten.

'latitude_max'"latitude_max""latitude_max""latitude_max""latitude_max""latitude_max":

Größte geographische Breite der Modellansichten.

'cam_roll_min'"cam_roll_min""cam_roll_min""cam_roll_min""cam_roll_min""cam_roll_min":

Kleinster Kamerarollwinkel der Modellansichten.

'cam_roll_max'"cam_roll_max""cam_roll_max""cam_roll_max""cam_roll_max""cam_roll_max":

Größter Kamerarollwinkel der Modellansichten.

'dist_min'"dist_min""dist_min""dist_min""dist_min""dist_min":

Kleinster Kamera-Objekt-Abstand der Modellansichten.

'dist_max'"dist_max""dist_max""dist_max""dist_max""dist_max":

Größter Kamera-Objekt-Abstand der Modellansichten.

'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast":

Minimaler Kontrast des Objektes in den Suchbildern.

'num_levels'"num_levels""num_levels""num_levels""num_levels""num_levels":

Vom Benutzer vorgegebene Anzahl von Pyramidenebenen.

'num_levels_max'"num_levels_max""num_levels_max""num_levels_max""num_levels_max""num_levels_max":

Maximale verwendete Anzahl von Pyramidenebenen über alle Modellansichten.

'optimization'"optimization""optimization""optimization""optimization""optimization":

Art der Optimierung durch Reduzierung der Modellpunkte.

'metric'"metric""metric""metric""metric""metric":

Art der zum Matchen verwendeten Metrik.

'part_size'"part_size""part_size""part_size""part_size""part_size":

Größe der verwendeten Modellteile, wenn 'metric'"metric""metric""metric""metric""metric" auf 'ignore_part_polarity'"ignore_part_polarity""ignore_part_polarity""ignore_part_polarity""ignore_part_polarity""ignore_part_polarity" gesetzt wurde.

'min_face_angle'"min_face_angle""min_face_angle""min_face_angle""min_face_angle""min_face_angle":

Kleinster 3D-Flächenwinkel für den die 3D-Objektmodellkante ins 3D-Formmodell einfließt.

'min_size'"min_size""min_size""min_size""min_size""min_size":

Mindestgröße der projizierten 3D-Objektmodellkante (in Anzahl Pixel) damit sie ins 3D-Formmodell einfließt.

'model_tolerance'"model_tolerance""model_tolerance""model_tolerance""model_tolerance""model_tolerance":

Größte zulässige Abweichung der projizierten Modellkanten (in Pixel).

'num_views_per_level'"num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level":

Anzahl der Modellansichten pro Pyramidenebene. Für jede Pyramidenebene wird die Anzahl der im Modell gespeicherten Ansichten zurückgegeben. Die Länge des zurückgelieferten Tupels entspricht somit der Anzahl der verwendeten Pyramidenebenen, die mit 'num_levels_max'"num_levels_max""num_levels_max""num_levels_max""num_levels_max""num_levels_max" abgefragt werden kann. Für Pyramidenebenen unterhalb von 'lowest_model_level'"lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level" (siehe Dokumentation zu create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d) wird der Wert 0 zurückgegeben.

'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose""reference_pose":

Referenzlage und -orientierung des 3D-Formmodells. Die zurückgelieferte 3D-Lage ist in der Form . Dabei steht rcs für das Referenzkoordinatensystem und mcs für das Modellkoordinatensystem (ein 3D Weltkoordinatensystem), siehe auch Transformationen / Posen und „Solution Guide III-C - 3D Vision“. D.h., sie beschreibt die Lage des intern verwendeten Referenzkoordinatensystems des 3D-Formmodells bezüglich des im 3D-Objektmodell gespeicherten Koordinatensystems. Mit dieser 3D-Lage können Punkte aus dem Objektkoordinatensystem ins Referenzkoordinatensystem transformiert werden.

'reference_point'"reference_point""reference_point""reference_point""reference_point""reference_point":

3D-Koordinaten des Referenzpunktes des zu Grunde liegenden 3D-Objektmodells.

'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1""bounding_box1":

Kleinster umschließender achsenparalleler Quader des zu Grunde liegenden 3D-Objektmodells in der Form: [min_x, min_y, min_z, max_x, max_y, max_z].

'fast_pose_refinement'"fast_pose_refinement""fast_pose_refinement""fast_pose_refinement""fast_pose_refinement""fast_pose_refinement":

Beschreibt, ob die 3D-Lagen-Verfeinerung während der Suche im beschleunigten Modus ('true'"true""true""true""true""true") oder im herkömmlichen Modus ('false'"false""false""false""false""false") durchgeführt wird.

'lowest_model_level'"lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level":

Unterste Pyramidenebene, bis zu der Ansichten im Modell gespeichert sind.

'union_adjacent_contours'"union_adjacent_contours""union_adjacent_contours""union_adjacent_contours""union_adjacent_contours""union_adjacent_contours":

Beschreibt, ob in project_shape_model_3dproject_shape_model_3dProjectShapeModel3dProjectShapeModel3dProjectShapeModel3dproject_shape_model_3d benachbarte Konturen verbunden werden sollen.

Ausführlichere Informationen zu den einzelnen Parametern können beim Operator create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d nachgelesen werden.

Es ist möglich, in einem Operatoraufruf mehrere Parameter zu kombinieren und gemeinsam in einem Tupel an GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name zu übergeben. Als Ergebnis wird in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value ein Tupel gleicher Länge zurückgeliefert, dessen Werte mit den entsprechenden Parameternamen korrespondieren. Dies ist allerdings ausschließlich für solche Parameter möglich, die nur einen einzelnen Wert zurückliefern.

Ausführungsinformationen

Parameter

ShapeModel3DIDShapeModel3DIDShapeModel3DIDShapeModel3DIDshapeModel3DIDshape_model_3did (input_control)  shape_model_3d HShapeModel3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des 3D-Formmodells.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Namen der generischen Parameter, die für das 3D-Formmodell abgefragt werden sollen.

Defaultwert: 'num_levels_max' "num_levels_max" "num_levels_max" "num_levels_max" "num_levels_max" "num_levels_max"

Werteliste: 'bounding_box1'"bounding_box1""bounding_box1""bounding_box1""bounding_box1""bounding_box1", 'cam_param'"cam_param""cam_param""cam_param""cam_param""cam_param", 'cam_roll_max'"cam_roll_max""cam_roll_max""cam_roll_max""cam_roll_max""cam_roll_max", 'cam_roll_min'"cam_roll_min""cam_roll_min""cam_roll_min""cam_roll_min""cam_roll_min", 'dist_max'"dist_max""dist_max""dist_max""dist_max""dist_max", 'dist_min'"dist_min""dist_min""dist_min""dist_min""dist_min", 'fast_pose_refinement'"fast_pose_refinement""fast_pose_refinement""fast_pose_refinement""fast_pose_refinement""fast_pose_refinement", 'latitude_max'"latitude_max""latitude_max""latitude_max""latitude_max""latitude_max", 'latitude_min'"latitude_min""latitude_min""latitude_min""latitude_min""latitude_min", 'longitude_max'"longitude_max""longitude_max""longitude_max""longitude_max""longitude_max", 'longitude_min'"longitude_min""longitude_min""longitude_min""longitude_min""longitude_min", 'lowest_model_level'"lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level""lowest_model_level", 'metric'"metric""metric""metric""metric""metric", 'min_contrast'"min_contrast""min_contrast""min_contrast""min_contrast""min_contrast", 'min_face_angle'"min_face_angle""min_face_angle""min_face_angle""min_face_angle""min_face_angle", 'min_size'"min_size""min_size""min_size""min_size""min_size", 'model_tolerance'"model_tolerance""model_tolerance""model_tolerance""model_tolerance""model_tolerance", 'num_levels'"num_levels""num_levels""num_levels""num_levels""num_levels", 'num_levels_max'"num_levels_max""num_levels_max""num_levels_max""num_levels_max""num_levels_max", 'num_views_per_level'"num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level""num_views_per_level", 'optimization'"optimization""optimization""optimization""optimization""optimization", 'order_of_rotation'"order_of_rotation""order_of_rotation""order_of_rotation""order_of_rotation""order_of_rotation", 'part_size'"part_size""part_size""part_size""part_size""part_size", 'ref_rot_x'"ref_rot_x""ref_rot_x""ref_rot_x""ref_rot_x""ref_rot_x", 'ref_rot_y'"ref_rot_y""ref_rot_y""ref_rot_y""ref_rot_y""ref_rot_y", 'ref_rot_z'"ref_rot_z""ref_rot_z""ref_rot_z""ref_rot_z""ref_rot_z", 'reference_point'"reference_point""reference_point""reference_point""reference_point""reference_point", 'reference_pose'"reference_pose""reference_pose""reference_pose""reference_pose""reference_pose", 'union_adjacent_contours'"union_adjacent_contours""union_adjacent_contours""union_adjacent_contours""union_adjacent_contours""union_adjacent_contours"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (output_control)  attribute.name(-array) HTupleSequence[Union[int, str, float]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Werte der generischen Parameter.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert get_shape_model_3d_paramsget_shape_model_3d_paramsGetShapeModel3dParamsGetShapeModel3dParamsGetShapeModel3dParamsget_shape_model_3d_params den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_shape_model_3dcreate_shape_model_3dCreateShapeModel3dCreateShapeModel3dCreateShapeModel3dcreate_shape_model_3d, read_shape_model_3dread_shape_model_3dReadShapeModel3dReadShapeModel3dReadShapeModel3dread_shape_model_3d

Nachfolger

find_shape_model_3dfind_shape_model_3dFindShapeModel3dFindShapeModel3dFindShapeModel3dfind_shape_model_3d

Siehe auch

convert_point_3d_cart_to_spherconvert_point_3d_cart_to_spherConvertPoint3dCartToSpherConvertPoint3dCartToSpherConvertPoint3dCartToSpherconvert_point_3d_cart_to_spher, convert_point_3d_spher_to_cartconvert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cart, create_cam_pose_look_at_pointcreate_cam_pose_look_at_pointCreateCamPoseLookAtPointCreateCamPoseLookAtPointCreateCamPoseLookAtPointcreate_cam_pose_look_at_point, trans_pose_shape_model_3dtrans_pose_shape_model_3dTransPoseShapeModel3dTransPoseShapeModel3dTransPoseShapeModel3dtrans_pose_shape_model_3d

Modul

3D Metrology