HALCON Website / HALCON Operator-Referenz / 3D-Matching / Oberflächenbasiert
KlassenKlassenKlassenKlassen | | | | Operatoren

get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResult (Operator)

Name

get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResult — Auslesen von Ergebnissen des oberflächenbasierten Matchings.

Signatur

get_surface_matching_result( : : SurfaceMatchingResultID, ResultName, ResultIndex : ResultValue)

Herror get_surface_matching_result(const Hlong SurfaceMatchingResultID, const char* ResultName, const Hlong ResultIndex, Hlong* ResultValue)

Herror T_get_surface_matching_result(const Htuple SurfaceMatchingResultID, const Htuple ResultName, const Htuple ResultIndex, Htuple* ResultValue)

Herror get_surface_matching_result(const HTuple& SurfaceMatchingResultID, const HTuple& ResultName, const HTuple& ResultIndex, Hlong* ResultValue)

Herror get_surface_matching_result(const HTuple& SurfaceMatchingResultID, const HTuple& ResultName, const HTuple& ResultIndex, HTuple* ResultValue)

HTuple HSurfaceMatchingResult::GetSurfaceMatchingResult(const HTuple& ResultName, const HTuple& ResultIndex) const

void GetSurfaceMatchingResult(const HTuple& SurfaceMatchingResultID, const HTuple& ResultName, const HTuple& ResultIndex, HTuple* ResultValue)

HTuple HSurfaceMatchingResult::GetSurfaceMatchingResult(const HTuple& ResultName, Hlong ResultIndex) const

HTuple HSurfaceMatchingResult::GetSurfaceMatchingResult(const HString& ResultName, Hlong ResultIndex) const

HTuple HSurfaceMatchingResult::GetSurfaceMatchingResult(const char* ResultName, Hlong ResultIndex) const

void HOperatorSetX.GetSurfaceMatchingResult(
[in] VARIANT SurfaceMatchingResultID, [in] VARIANT ResultName, [in] VARIANT ResultIndex, [out] VARIANT* ResultValue)

VARIANT HSurfaceMatchingResultX.GetSurfaceMatchingResult(
[in] VARIANT ResultName, [in] Hlong ResultIndex)

static void HOperatorSet.GetSurfaceMatchingResult(HTuple surfaceMatchingResultID, HTuple resultName, HTuple resultIndex, out HTuple resultValue)

HTuple HSurfaceMatchingResult.GetSurfaceMatchingResult(HTuple resultName, int resultIndex)

HTuple HSurfaceMatchingResult.GetSurfaceMatchingResult(string resultName, int resultIndex)

Beschreibung

Der Operator get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResult liefert detailierte Ergebnisse des oberflächenbasierten Matchings oder der oberflächenbasierten Pose-Verfeinerung. Die Ergebnisse sind in SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID gespeichert, das mit find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel oder refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose angelegt wurde.

Der Parameter ResultNameResultNameResultNameResultNameResultNameresultName wählt das abzurufende Detailergebnis aus. Bezieht sich das Detailergebniss auf eine der zurückgelieferten Posen, so wählt ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex diese aus, wobei mittels 0 das erste Ergebnis selektiert wird. Für einige Werte von ResultNameResultNameResultNameResultNameResultNameresultName wird ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex ignoriert.

Die folgenden Werte sind für ResultNameResultNameResultNameResultNameResultNameresultName möglich:

'sampled_scene'"sampled_scene""sampled_scene""sampled_scene""sampled_scene""sampled_scene":

Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel erstellt wurde, wird ein 3D-Objektmodell zurückgegeben, welches die für das näherungsweise Matching abgetasteten Szenepunkte enthält. Dies ist hilfreich um die Abtastdistanz einzustellen (siehe Parameter RelSamplingDistance von find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel). Der Parameter ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex wird ignoriert. Das zurückgegebene 3D-Objektmodell muss mittels clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d freigegeben werden. Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose erstellt wurde, wird ein leeres 3D-Objektmodell zurückgegeben.

'key_points'"key_points""key_points""key_points""key_points""key_points":

Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel erstellt wurde, wird ein 3D-Objektmodell zurückgegeben, welches die Schlüsselpunkte enthält, die für das Matching verwendet wurden. Dies ist hilfreich um die Abtastdistanz und die Anzahl an Schlüsselpunkten einzustellen (siehe Parameter KeyPointFraction von find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel). Der Parameter ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex wird ignoriert. Das zurückgegebene 3D-Objektmodell muss mittels clear_object_model_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d freigegeben werden. Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose erstellt wurde, wird ein leeres 3D-Objektmodell zurückgegeben.

'pose'"pose""pose""pose""pose""pose":

Gibt die Pose eines der Ergebnisse zurück. Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex übergeben.

'score_unrefined'"score_unrefined""score_unrefined""score_unrefined""score_unrefined""score_unrefined":

Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel erstellt wurde, wird die Bewertung des Ergebnisses vor der exakten Pose-Verfeinerung zurückgegeben. Je nachdem, ob die grobe Pose-Verfeinerung aktiviert war ist dies die Bewertung des näherungsweisen Matchings oder der groben Pose-Verfeinerung. Eine detailierte Beschreibung der Bewertung findet sich in find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel. Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex übergeben. Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose erstellt wurde, wird 0 zurückgegeben.

'score_refined'"score_refined""score_refined""score_refined""score_refined""score_refined":

Gibt die Bewertung des Ergebnisses nach der exakten Pose-Verfeinerung zurück. Eine detailierte Beschreibung der Bewertung findet sich in find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel. Der Index des Ergebnisses wird in ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex übergeben. Wenn SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID mittels find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel erstellt wurde und die exakte Pose-Verfeinerung deaktiviert war, wird 0 zurückgegeben.

Parallelisierung

Parameter

SurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDSurfaceMatchingResultIDsurfaceMatchingResultID (input_control)  surface_matching_result → HSurfaceMatchingResult, HTupleHTupleHSurfaceMatchingResult, HTupleHSurfaceMatchingResultX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Ergebnishandle des oberflächenbasierten Matchings.

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

Name des Ergebnisdetails.

Defaultwert: 'pose' "pose" "pose" "pose" "pose" "pose"

Werteliste: 'key_points'"key_points""key_points""key_points""key_points""key_points", 'pose'"pose""pose""pose""pose""pose", 'sampled_scene'"sampled_scene""sampled_scene""sampled_scene""sampled_scene""sampled_scene", 'score_refined'"score_refined""score_refined""score_refined""score_refined""score_refined", 'score_unrefined'"score_unrefined""score_unrefined""score_unrefined""score_unrefined""score_unrefined"

ResultIndexResultIndexResultIndexResultIndexResultIndexresultIndex (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Index des Ergebnisses, beginnend mit 0.

Defaultwert: 0

Wertevorschläge: 0, 1, 2, 3

Restriktion: ResultIndex >= 0

ResultValueResultValueResultValueResultValueResultValueresultValue (output_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer / string / real) (int / long / string / double) (Hlong / HString / double) (Hlong / char* / double) (Hlong / BSTR / double) (Hlong / char* / double)

Wert des Ergebnisses.

Ergebnis

Ist der Handle des Modells gültig, dann liefert get_surface_matching_resultget_surface_matching_resultGetSurfaceMatchingResultget_surface_matching_resultGetSurfaceMatchingResultGetSurfaceMatchingResult den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose

Nachfolger

clear_surface_modelclear_surface_modelClearSurfaceModelclear_surface_modelClearSurfaceModelClearSurfaceModel

Siehe auch

find_surface_modelfind_surface_modelFindSurfaceModelfind_surface_modelFindSurfaceModelFindSurfaceModel, refine_surface_model_poserefine_surface_model_poseRefineSurfaceModelPoserefine_surface_model_poseRefineSurfaceModelPoseRefineSurfaceModelPose, read_surface_modelread_surface_modelReadSurfaceModelread_surface_modelReadSurfaceModelReadSurfaceModel, write_surface_modelwrite_surface_modelWriteSurfaceModelwrite_surface_modelWriteSurfaceModelWriteSurfaceModel, clear_surface_modelclear_surface_modelClearSurfaceModelclear_surface_modelClearSurfaceModelClearSurfaceModel

Modul

3D Metrology

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