get_shape_model_paramsT_get_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params (Operator)
Name
get_shape_model_paramsT_get_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params — Auslesen der Parameter eines Formmodells.
Signatur
void GetShapeModelParams(const HTuple& ModelID, HTuple* NumLevels, HTuple* AngleStart, HTuple* AngleExtent, HTuple* AngleStep, HTuple* ScaleMin, HTuple* ScaleMax, HTuple* ScaleStep, HTuple* Metric, HTuple* MinContrast)
HTuple HShapeModel::GetShapeModelParams(double* AngleStart, double* AngleExtent, double* AngleStep, HTuple* ScaleMin, HTuple* ScaleMax, HTuple* ScaleStep, HString* Metric, Hlong* MinContrast) const
Hlong HShapeModel::GetShapeModelParams(double* AngleStart, double* AngleExtent, double* AngleStep, double* ScaleMin, double* ScaleMax, double* ScaleStep, HString* Metric, Hlong* MinContrast) const
static void HOperatorSet.GetShapeModelParams(HTuple modelID, out HTuple numLevels, out HTuple angleStart, out HTuple angleExtent, out HTuple angleStep, out HTuple scaleMin, out HTuple scaleMax, out HTuple scaleStep, out HTuple metric, out HTuple minContrast)
HTuple HShapeModel.GetShapeModelParams(out double angleStart, out double angleExtent, out double angleStep, out HTuple scaleMin, out HTuple scaleMax, out HTuple scaleStep, out string metric, out int minContrast)
int HShapeModel.GetShapeModelParams(out double angleStart, out double angleExtent, out double angleStep, out double scaleMin, out double scaleMax, out double scaleStep, out string metric, out int minContrast)
def get_shape_model_params(model_id: HHandle) -> Tuple[Sequence[int], float, float, float, Sequence[float], Sequence[float], Sequence[float], str, int]
def get_shape_model_params_s(model_id: HHandle) -> Tuple[int, float, float, float, float, float, float, str, int]
Beschreibung
Der Operator get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params gibt die zur Erzeugung
des Formmodells ModelIDModelIDModelIDmodelIDmodel_id mit create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelcreate_shape_model,
create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model oder
create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model verwendeten Parameter zurück. Dies
ist insbesondere hilfreich, um die Parameter NumLevelsNumLevelsNumLevelsnumLevelsnum_levels,
AngleStepAngleStepAngleStepangleStepangle_step, ScaleStepScaleStepScaleStepscaleStepscale_step oder MinContrastMinContrastMinContrastminContrastmin_contrast zu
überprüfen, falls diese durch create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelcreate_shape_model,
create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model oder
create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model automatisch bestimmt wurden.
Wenn ModelIDModelIDModelIDmodelIDmodel_id mit adapt_shape_model_high_noiseadapt_shape_model_high_noiseAdaptShapeModelHighNoiseAdaptShapeModelHighNoiseadapt_shape_model_high_noise
angepasst wurde, wird NumLevels zwei Werte enthalten: die oberste
Pyramidenstufe und die geschätzte unterste Pyramidenstufe.
Falls das Formmodell mit create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelcreate_shape_model oder
create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model erzeugt worden ist, wird in
ScaleMinScaleMinScaleMinscaleMinscale_min, ScaleMaxScaleMaxScaleMaxscaleMaxscale_max und ScaleStepScaleStepScaleStepscaleStepscale_step jeweils
ein Wert für den jeweiligen isotropen Skalierungsparameter
zurückgegeben. Falls das Formmodell mit
create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model erzeugt worden ist, werden in den
obigen drei Parametern jeweils zwei Werte zurückgegeben. Dabei
bezieht sich der jeweils erste Parameter auf die Skalierung in
Zeilenrichtung, der jeweils zweite Parameter auf die Skalierung in
Spaltenrichtung.
Zu beachten ist, dass die Parameter OptimizationOptimizationOptimizationoptimizationoptimization und
ContrastContrastContrastcontrastcontrast, die während der Modellgenerierung ebenfalls
automatisch bestimmt werden können, nicht mit
get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params abgefragt werden können. In diesem
Fall sollte determine_shape_model_paramsdetermine_shape_model_paramsDetermineShapeModelParamsDetermineShapeModelParamsdetermine_shape_model_params statt
get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params verwendet werden.
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
ModelIDModelIDModelIDmodelIDmodel_id (input_control) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Modells.
NumLevelsNumLevelsNumLevelsnumLevelsnum_levels (output_control) integer(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Anzahl von Pyramidenebenen.
AngleStartAngleStartAngleStartangleStartangle_start (output_control) angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Kleinste auftretende Rotation des Musters.
AngleExtentAngleExtentAngleExtentangleExtentangle_extent (output_control) angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Ausdehnung des Winkelbereichs.
Zusicherung:
AngleExtent >= 0
AngleStepAngleStepAngleStepangleStepangle_step (output_control) angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Schrittweite der Winkel (Auflösung).
Zusicherung:
AngleStep >= 0 && AngleStep <= pi / 2
ScaleMinScaleMinScaleMinscaleMinscale_min (output_control) number(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Kleinste auftretende Skalierung des Musters.
Zusicherung:
ScaleMin > 0
ScaleMaxScaleMaxScaleMaxscaleMaxscale_max (output_control) number(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Größte auftretende Skalierung des Musters.
Zusicherung:
ScaleMax >= ScaleMin
ScaleStepScaleStepScaleStepscaleStepscale_step (output_control) number(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Schrittweite der Skalierungen (Auflösung).
Zusicherung:
ScaleStep >= 0
MetricMetricMetricmetricmetric (output_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Art der zum Matchen verwendeten Metrik.
MinContrastMinContrastMinContrastminContrastmin_contrast (output_control) number → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Minimaler Kontrast des Objektes in den Suchbildern.
Ergebnis
Ist der Handle des Modells gültig, dann liefert
get_shape_model_paramsget_shape_model_paramsGetShapeModelParamsGetShapeModelParamsget_shape_model_params den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls wird
eine Fehlerbehandlung durchgeführt.
Vorgänger
create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelcreate_shape_model,
create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModelcreate_scaled_shape_model,
create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModelcreate_aniso_shape_model,
read_shape_modelread_shape_modelReadShapeModelReadShapeModelread_shape_model
Alternativen
get_generic_shape_model_paramget_generic_shape_model_paramGetGenericShapeModelParamGetGenericShapeModelParamget_generic_shape_model_param
Siehe auch
find_shape_modelfind_shape_modelFindShapeModelFindShapeModelfind_shape_model,
find_scaled_shape_modelfind_scaled_shape_modelFindScaledShapeModelFindScaledShapeModelfind_scaled_shape_model,
find_aniso_shape_modelfind_aniso_shape_modelFindAnisoShapeModelFindAnisoShapeModelfind_aniso_shape_model,
find_shape_modelsfind_shape_modelsFindShapeModelsFindShapeModelsfind_shape_models,
find_scaled_shape_modelsfind_scaled_shape_modelsFindScaledShapeModelsFindScaledShapeModelsfind_scaled_shape_models,
find_aniso_shape_modelsfind_aniso_shape_modelsFindAnisoShapeModelsFindAnisoShapeModelsfind_aniso_shape_models
Modul
Matching