set_camera_setup_paramT_set_camera_setup_paramSetCameraSetupParamSetCameraSetupParam (Operator)
Name
set_camera_setup_paramT_set_camera_setup_paramSetCameraSetupParamSetCameraSetupParam — Setzen von generischen Parametern im Kameraaufbaumodell.
Signatur
void SetCameraSetupParam(const HTuple& CameraSetupModelID, const HTuple& CameraIdx, const HTuple& GenParamName, const HTuple& GenParamValue)
void HCameraSetupModel::SetCameraSetupParam(const HTuple& CameraIdx, const HString& GenParamName, const HTuple& GenParamValue) const
void HCameraSetupModel::SetCameraSetupParam(Hlong CameraIdx, const HString& GenParamName, double GenParamValue) const
void HCameraSetupModel::SetCameraSetupParam(Hlong CameraIdx, const char* GenParamName, double GenParamValue) const
void HCameraSetupModel::SetCameraSetupParam(Hlong CameraIdx, const wchar_t* GenParamName, double GenParamValue) const
(Nur Windows)
Beschreibung
Mit dem Operator set_camera_setup_paramset_camera_setup_paramSetCameraSetupParamSetCameraSetupParamSetCameraSetupParam können diverse
Parameter und Transformationen des Setups
CameraSetupModelIDCameraSetupModelIDCameraSetupModelIDCameraSetupModelIDcameraSetupModelID gesetzt werden. Dabei werden zwei Typen
von Parameter unterschieden:
Koordinatensystem des Aufbaus und Transformation der
Kameraposen:
Mit CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx='general'"general""general""general""general" wird, je nach Auswahl im
Parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamName, das Koordinatensystem des Aufbaus neu
festgelegt und die Kameraposen entsprechend transformiert:
- 'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera":
Wird in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue ein gültiger Kameraindex übergeben,
so werden alle Kameraposen relativ zum Koordinatensystem der
gewählten Kamera neu berechnet.
- 'coord_transf_pose'"coord_transf_pose""coord_transf_pose""coord_transf_pose""coord_transf_pose":
Wird in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue ein Tupel im HALCON-Pose-Format
übergeben, so wird das Koordinatensystem des Aufbaus in diese
Pose verschoben. Die Pose in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue stellt dabei
die Position und Orientierung des gewünschten Koordinatensystems
relativ zum aktuellen dar. Alle Kameraposen werden dann relativ
zum neuen Koordinatensystem neu berechnet.
Die neu berechneten Kameraposen können mit dem Operator
get_camera_setup_paramget_camera_setup_paramGetCameraSetupParamGetCameraSetupParamGetCameraSetupParam abgefragt werden.
Kameraparameter:
Wenn im Parameter CameraIdx eine gültiger Kameraindex (d.h.
eine Zahl zwischen 0 und NumCameras-1) eingegeben
wird, werden die folgenden Parameter, je nach Auswahl im Parameter
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName, für die ausgewählte Kamera auf den Wert im
Parameter GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue gesetzt:
- 'params'"params""params""params""params":
Ein Tupel mit den internen Kameraparametern.
- 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations":
Ein Tupel mit den Standardabweichungen der internen
Kameraparameter. Das Tupel soll einen Wert für jeden internen
Kameraparameter (siehe 'params'"params""params""params""params") bis auf die Parameter
CameraType, Width und Height
enthalten, d.h. |params_deviations|=|params|-3.
- 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances":
Ein Tupel mit der Kovarianzmatrix der internen Kameraparameter.
Das Tupel muss eine quadratische symmetrische Matrix darstellen,
deren beide Dimensionen gleich groß sind wie die Anzahl der
Standardabweichungswerte, d.h.,
|params_covariances|=|params_deviations|²=(|params|-3)²
- 'pose'"pose""pose""pose""pose":
Ein Tupel mit der Kamerapose in Form einer HALCON-Pose, relativ
zum Koordinatensystem des Aufbaus. Siehe oben für mehr
Information.
Es ist zu beachten, dass eine Kamera im Modell bereits definiert
sein muss, um ihre Parameter mit set_camera_setup_paramset_camera_setup_paramSetCameraSetupParamSetCameraSetupParamSetCameraSetupParam
ändern zu können. Wenn CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx der Index einer
undefinierten Kamera ist, gibt der Operator einen Fehler zurück.
Alle Parameter können mit dem Operator
get_camera_setup_paramget_camera_setup_paramGetCameraSetupParamGetCameraSetupParamGetCameraSetupParam wieder abgefragt 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
CameraSetupModelIDCameraSetupModelIDCameraSetupModelIDCameraSetupModelIDcameraSetupModelID (input_control) camera_setup_model → HCameraSetupModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Kameraaufbaumodells.
CameraIdxCameraIdxCameraIdxCameraIdxcameraIdx (input_control) integer(-array) → HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Index der Kamera im Modell.
Defaultwert: 0
Wertevorschläge: 0, 1, 2, 'general'"general""general""general""general"
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name → HTupleHTupleHtuple (string) (string) (HString) (char*)
Namen der generischen Parameter.
Werteliste: 'coord_transf_pose'"coord_transf_pose""coord_transf_pose""coord_transf_pose""coord_transf_pose", 'params'"params""params""params""params", 'params_covariances'"params_covariances""params_covariances""params_covariances""params_covariances", 'params_deviations'"params_deviations""params_deviations""params_deviations""params_deviations", 'pose'"pose""pose""pose""pose", 'reference_camera'"reference_camera""reference_camera""reference_camera""reference_camera"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value(-array) → HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Werte der generischen Parameter.
Vorgänger
create_camera_setup_modelcreate_camera_setup_modelCreateCameraSetupModelCreateCameraSetupModelCreateCameraSetupModel,
read_camera_setup_modelread_camera_setup_modelReadCameraSetupModelReadCameraSetupModelReadCameraSetupModel
Modul
Calibration