read_cam_parT_read_cam_parReadCamParReadCamPar (Operator)

Name

read_cam_parT_read_cam_parReadCamParReadCamPar — Read internal camera parameters from a file.

Signature

read_cam_par( : : CamParFile : CameraParam)

Herror T_read_cam_par(const Htuple CamParFile, Htuple* CameraParam)

void ReadCamPar(const HTuple& CamParFile, HTuple* CameraParam)

void HCamPar::ReadCamPar(const HString& CamParFile)

void HCamPar::ReadCamPar(const char* CamParFile)

void HCamPar::ReadCamPar(const wchar_t* CamParFile)   (Windows only)

static void HOperatorSet.ReadCamPar(HTuple camParFile, out HTuple cameraParam)

void HCamPar.ReadCamPar(string camParFile)

Description

read_cam_parread_cam_parReadCamParReadCamParReadCamPar reads the internal camera parameters CameraParamCameraParamCameraParamCameraParamcameraParam from a file with name CamParFileCamParFileCamParFileCamParFilecamParFile. The file must have been written by write_cam_parwrite_cam_parWriteCamParWriteCamParWriteCamPar.

The default HALCON file extension for the camera parameters is 'dat'.

The number of values in CameraParamCameraParamCameraParamCameraParamcameraParam depends on the specified camera type. See the description of set_calib_data_cam_paramset_calib_data_cam_paramSetCalibDataCamParamSetCalibDataCamParamSetCalibDataCamParam for a list of values and the chapter Calibration / Multi-View for details on camera types and camera parameters.

Execution Information

Parameters

CamParFileCamParFileCamParFileCamParFilecamParFile (input_control)  filename.read HTupleHTupleHtuple (string) (string) (HString) (char*)

File name of internal camera parameters.

Default value: 'campar.dat' "campar.dat" "campar.dat" "campar.dat" "campar.dat"

List of values: 'campar.dat'"campar.dat""campar.dat""campar.dat""campar.dat", 'campar.final'"campar.final""campar.final""campar.final""campar.final", 'campar.initial'"campar.initial""campar.initial""campar.initial""campar.initial"

File extension: .dat

CameraParamCameraParamCameraParamCameraParamcameraParam (output_control)  campar HCamPar, HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Internal camera parameters.

Example (HDevelop)

* Create sample camera parameters and write them to file.
gen_cam_par_area_scan_division (0.01, -731, 5.2e-006, 5.2e-006, \
                                654, 519, 1280, 1024, CameraParamTmp)
write_cam_par (CameraParamTmp, 'campar_tmp.dat')
* Read internal camera parameters.
read_cam_par('campar_tmp.dat', CameraParam)

Example (HDevelop)

* Create sample camera parameters and write them to file.
gen_cam_par_area_scan_division (0.01, -731, 5.2e-006, 5.2e-006, \
                                654, 519, 1280, 1024, CameraParamTmp)
write_cam_par (CameraParamTmp, 'campar_tmp.dat')
* Read internal camera parameters.
read_cam_par('campar_tmp.dat', CameraParam)

Example (HDevelop)

* Create sample camera parameters and write them to file.
gen_cam_par_area_scan_division (0.01, -731, 5.2e-006, 5.2e-006, \
                                654, 519, 1280, 1024, CameraParamTmp)
write_cam_par (CameraParamTmp, 'campar_tmp.dat')
* Read internal camera parameters.
read_cam_par('campar_tmp.dat', CameraParam)

Example (HDevelop)

* Create sample camera parameters and write them to file.
gen_cam_par_area_scan_division (0.01, -731, 5.2e-006, 5.2e-006, \
                                654, 519, 1280, 1024, CameraParamTmp)
write_cam_par (CameraParamTmp, 'campar_tmp.dat')
* Read internal camera parameters.
read_cam_par('campar_tmp.dat', CameraParam)

Example (HDevelop)

* Create sample camera parameters and write them to file.
gen_cam_par_area_scan_division (0.01, -731, 5.2e-006, 5.2e-006, \
                                654, 519, 1280, 1024, CameraParamTmp)
write_cam_par (CameraParamTmp, 'campar_tmp.dat')
* Read internal camera parameters.
read_cam_par('campar_tmp.dat', CameraParam)

Result

read_cam_parread_cam_parReadCamParReadCamParReadCamPar returns 2 (H_MSG_TRUE) if all parameter values are correct and the file has been read successfully. If necessary an exception is raised.

Possible Successors

find_marks_and_posefind_marks_and_poseFindMarksAndPoseFindMarksAndPoseFindMarksAndPose, sim_caltabsim_caltabSimCaltabSimCaltabSimCaltab, gen_caltabgen_caltabGenCaltabGenCaltabGenCaltab, disp_caltabdisp_caltabDispCaltabDispCaltabDispCaltab, camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration

See also

find_caltabfind_caltabFindCaltabFindCaltabFindCaltab, find_marks_and_posefind_marks_and_poseFindMarksAndPoseFindMarksAndPoseFindMarksAndPose, camera_calibrationcamera_calibrationCameraCalibrationCameraCalibrationCameraCalibration, disp_caltabdisp_caltabDispCaltabDispCaltabDispCaltab, sim_caltabsim_caltabSimCaltabSimCaltabSimCaltab, write_cam_parwrite_cam_parWriteCamParWriteCamParWriteCamPar, write_posewrite_poseWritePoseWritePoseWritePose, read_poseread_poseReadPoseReadPoseReadPose, project_3d_pointproject_3d_pointProject3dPointProject3dPointProject3dPoint, get_line_of_sightget_line_of_sightGetLineOfSightGetLineOfSightGetLineOfSight

Module

Foundation