gen_radial_distortion_mapT_gen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map (Operator)

Name

gen_radial_distortion_mapT_gen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map — Berechnen der Abbildung von Bildern aufgrund wechselnder radialer Verzeichnung.

Signatur

gen_radial_distortion_map( : Map : CamParamIn, CamParamOut, MapType : )

Herror T_gen_radial_distortion_map(Hobject* Map, const Htuple CamParamIn, const Htuple CamParamOut, const Htuple MapType)

void GenRadialDistortionMap(HObject* Map, const HTuple& CamParamIn, const HTuple& CamParamOut, const HTuple& MapType)

void HImage::GenRadialDistortionMap(const HCamPar& CamParamIn, const HCamPar& CamParamOut, const HString& MapType)

void HImage::GenRadialDistortionMap(const HCamPar& CamParamIn, const HCamPar& CamParamOut, const char* MapType)

void HImage::GenRadialDistortionMap(const HCamPar& CamParamIn, const HCamPar& CamParamOut, const wchar_t* MapType)   (Nur Windows)

HImage HCamPar::GenRadialDistortionMap(const HCamPar& CamParamOut, const HString& MapType) const

HImage HCamPar::GenRadialDistortionMap(const HCamPar& CamParamOut, const char* MapType) const

HImage HCamPar::GenRadialDistortionMap(const HCamPar& CamParamOut, const wchar_t* MapType) const   (Nur Windows)

static void HOperatorSet.GenRadialDistortionMap(out HObject map, HTuple camParamIn, HTuple camParamOut, HTuple mapType)

void HImage.GenRadialDistortionMap(HCamPar camParamIn, HCamPar camParamOut, string mapType)

HImage HCamPar.GenRadialDistortionMap(HCamPar camParamOut, string mapType)

def gen_radial_distortion_map(cam_param_in: Sequence[Union[int, float, str]], cam_param_out: Sequence[Union[int, float, str]], map_type: str) -> HObject

Beschreibung

gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map berechnet die Abbildung von Bildern aufgrund wechselnder radialer Verzeichnung gemäß den übergebenen internen Kameraparametern CamParamInCamParamInCamParamInCamParamIncamParamIncam_param_in bzw. CamParamOutCamParamOutCamParamOutCamParamOutcamParamOutcam_param_out, die z.B. durch eine Kamerakalibrierung mit Hilfe von calibrate_camerascalibrate_camerasCalibrateCamerasCalibrateCamerasCalibrateCamerascalibrate_cameras bestimmt wurden. CamParamInCamParamInCamParamInCamParamIncamParamIncam_param_in bzw. CamParamOutCamParamOutCamParamOutCamParamOutcamParamOutcam_param_out stellen dabei die alten bzw. neuen internen Kameraparameter dar, die u.a. auch die alte bzw. neue radiale Verzeichnung enthalten (siehe auch Kalibrierung für die Reihenfolge der Parameter und das zu Grunde liegende Kameramodell). Zur Berechnung der Abbildung wird jedes Pixel im potentiellen Ausgabebild mittels CamParamOutCamParamOutCamParamOutCamParamOutcamParamOutcam_param_out in die Bildebene zurückgerechnet und dann mittels CamParamInCamParamInCamParamInCamParamIncamParamIncam_param_in in eine Subpixel-Position im Eingabebild überführt. Bitte beachten Sie, dass gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map nur Flächenkameras unterstützt.

Die Abbildungsvorschrift wird in dem Ausgabebild MapMapMapMapmapmap gespeichert, dessen Größe durch die Kameraparameter CamParamOutCamParamOutCamParamOutCamParamOutcamParamOutcam_param_out festgelegt ist und somit die Größe der später mit map_imagemap_imageMapImageMapImageMapImagemap_image transformierten Ergebnisbilder bestimmt. Die Größe der mit map_imagemap_imageMapImageMapImageMapImagemap_image zu transformierenden Bilder wird durch die Kameraparameter CamParamInCamParamInCamParamInCamParamIncamParamIncam_param_in bestimmt. Der Parameter MapTypeMapTypeMapTypeMapTypemapTypemap_type gibt an, in welchem Typ die Abbildungsvorschrift gespeichert werden soll. Wurde 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor" gewählt, so besteht MapMapMapMapmapmap aus einem Bild mit einem Kanal, in dem für jedes Pixel des Ergebnisbildes die linearen Koordinaten desjenigen Pixels des Eingabebildes stehen, welches den transformierten Koordinaten am nächsten liegt. Wurde die bilineare Interpolation ('bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear") gewählt, so besteht MapMapMapMapmapmap aus einem Bild mit fünf Kanälen. Der erste Kanal enthält für jedes Pixel des Ergebnisbildes die linearen Koordinaten desjenigen Pixels des Eingabebildes, welches links oberhalb von den transformierten Koordinaten liegt. Die übrigen vier Kanäle enthalten die Gewichte der einzelnen vier Nachbarpixel der transformierten Koordinaten für die bilineare Interpolation in folgender Reihenfolge:

2 3
4 5

Der zweite Kanal z.B. enthält die Gewichte der Pixel, die links oberhalb der transformierten Koordinaten liegen. Wurde 'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix" gewählt, besteht MapMapMapMapmapmap aus einem Vektorfeld, welches für jedes Pixel des Ergebnisbildes die subpixelgenauen Koordinaten im Eingabebild enthält.

Wird zur Bestimmung der modifizierten Kameraparameter CamParamOutCamParamOutCamParamOutCamParamOutcamParamOutcam_param_out die Routine change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par verwendet, beschreibt die Abbildung eine Aufnahmeoptik mit geänderter radialer Verzeichnung . Für entspricht die Abbildung somit einer radialen Entzerrung. Eine etwaige Lagebestimmung für die Kamera (externe Kameraparameter) wird dadurch nicht beeinflusst.

Sollen mehrere Bilder unter Verwendung derselben internen Kameraparameter transformiert werden, so ist die Kombination aus gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map und map_imagemap_imageMapImageMapImageMapImagemap_image wesentlich effizienter als der Operator change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image, da die Abbildungsvorschrift nur einmal berechnet werden muss.

Wenn die erzeugte Abbildung in einem anderen Programm wiederverwendet werden soll, kann man sie mit dem Operator write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image als Mehrkanalbild abspeichern (Format: 'tiff'"tiff""tiff""tiff""tiff""tiff").

Ausführungsinformationen

Parameter

MapMapMapMapmapmap (output_object)  (multichannel-)image objectHImageHObjectHImageHobject * (int4 / int8 / uint2 / vector_field)

Bild mit den Abbildungsdaten.

CamParamInCamParamInCamParamInCamParamIncamParamIncam_param_in (input_control)  campar HCamPar, HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Alte Kameraparameter.

CamParamOutCamParamOutCamParamOutCamParamOutcamParamOutcam_param_out (input_control)  campar HCamPar, HTupleSequence[Union[int, float, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Neue Kameraparameter.

MapTypeMapTypeMapTypeMapTypemapTypemap_type (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Typ der Abbildungsdaten.

Defaultwert: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear"

Werteliste: 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", 'coord_map_sub_pix'"coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix""coord_map_sub_pix", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor"

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_radial_distortion_mapgen_radial_distortion_mapGenRadialDistortionMapGenRadialDistortionMapGenRadialDistortionMapgen_radial_distortion_map den Wert 2 (H_MSG_TRUE).

Vorgänger

change_radial_distortion_cam_parchange_radial_distortion_cam_parChangeRadialDistortionCamParChangeRadialDistortionCamParChangeRadialDistortionCamParchange_radial_distortion_cam_par, camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibrationcamera_calibration, hand_eye_calibrationhand_eye_calibrationHandEyeCalibrationHandEyeCalibrationHandEyeCalibrationhand_eye_calibration

Nachfolger

map_imagemap_imageMapImageMapImageMapImagemap_image

Alternativen

change_radial_distortion_imagechange_radial_distortion_imageChangeRadialDistortionImageChangeRadialDistortionImageChangeRadialDistortionImagechange_radial_distortion_image

Siehe auch

change_radial_distortion_contours_xldchange_radial_distortion_contours_xldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldChangeRadialDistortionContoursXldchange_radial_distortion_contours_xld

Modul

Calibration