read_cam_parReadCamParReadCamParread_cam_parT_read_cam_par

HALCON ScriptCpp++.NETPythonC

Short description

read_cam_parReadCamParReadCamParread_cam_parT_read_cam_par — Read internal camera parameters from a file.

Signature

read_cam_par( filename.read CamParFile, out campar CameraParam )void ReadCamPar( const HTuple& CamParFile, HTuple* CameraParam )static void HOperatorSet.ReadCamPar( HTuple camParFile, out HTuple cameraParam )def read_cam_par( cam_par_file: str ) -> Sequence[Union[int, float, str]]

Herror T_read_cam_par( 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)

void HCamPar.ReadCamPar( string camParFile )

Description

read_cam_parReadCamPar reads the internal camera parameters CameraParamcameraParamcamera_param from a file with name CamParFilecamParFilecam_par_file. The file must have been written by write_cam_parWriteCamPar.

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

The number of values in CameraParamcameraParamcamera_param depends on the specified camera type. See the description of set_calib_data_cam_paramSetCalibDataCamParam for a list of values and the chapter Calibration for details on camera types and camera parameters.

Execution information

Execution information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

• Processed without parallelization.

Parameters

CamParFilecamParFilecam_par_file (input_control) filename.read → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name of internal camera parameters.

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

CameraParamcameraParamcamera_param (output_control) campar → (real / integer / string)HTuple (double / Hlong / HString)HCamPar, HTuple (double / int / long / string)Sequence[Union[int, float, str]]Htuple (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)

(C++)

HTuple CameraParamTmp, CameraParam\;
// 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_parReadCamPar returns 2 (H_MSG_TRUE) if all parameter values are correct and the file has been read successfully. If necessary an exception is raised.

Combinations with other operators

Combinations

Possible successors

find_marks_and_poseFindMarksAndPose, sim_caltabSimCaltab, gen_caltabGenCaltab, disp_caltabDispCaltab, camera_calibrationCameraCalibration

See also

find_caltabFindCaltab, find_marks_and_poseFindMarksAndPose, camera_calibrationCameraCalibration, disp_caltabDispCaltab, sim_caltabSimCaltab, write_cam_parWriteCamPar, write_poseWritePose, read_poseReadPose, project_3d_pointProject3dPoint, get_line_of_sightGetLineOfSight

Module

Foundation