Skip to content

write_cam_parWriteCamParWriteCamParwrite_cam_parT_write_cam_par🔗

Short description🔗

write_cam_parWriteCamParWriteCamParwrite_cam_parT_write_cam_par — Write internal camera parameters into a file.

Signature🔗

write_cam_par( campar CameraParam, filename.write CamParFile )void WriteCamPar( const HTuple& CameraParam, const HTuple& CamParFile )static void HOperatorSet.WriteCamPar( HTuple cameraParam, HTuple camParFile )def write_cam_par( camera_param: Sequence[Union[int, float, str]], cam_par_file: str ) -> None

Herror T_write_cam_par( const Htuple CameraParam, const Htuple CamParFile )

void HCamPar::WriteCamPar( const HString& CamParFile ) const

void HCamPar::WriteCamPar( const char* CamParFile ) const

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

void HCamPar.WriteCamPar( string camParFile )

Description🔗

write_cam_parWriteCamPar stores the internal camera parameters CameraParamcameraParamcamera_param into a file specified by its file name CamParFilecamParFilecam_par_file.

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.

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

The internal camera parameters can be later read with read_cam_parReadCamPar.

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🔗

CameraParamcameraParamcamera_param (input_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.

CamParFilecamParFilecam_par_file (input_control) filename.write → (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

Example🔗

(HDevelop)

*
* Calibrate the camera.
*
StartCamPar := ['area_scan_division', 0.016, 0, 0.0000074, 0.0000074, \
                326, 247, 652, 494]
create_calib_data ('calibration_object', 1, 1, CalibDataID)
set_calib_data_cam_param (CalibDataID, 0, [], StartCamPar)
set_calib_data_calib_object (CalibDataID, 0, 'caltab_30mm.descr')
NumImages := 10
for I := 1 to NumImages by 1
  read_image (Image, '3d_machine_vision/calib/calib_' + I$'02d')
  find_calib_object (Image, CalibDataID, 0, 0, I, [], [])
  get_calib_data_observ_contours (Caltab, CalibDataID, 'caltab', 0, 0, I)
endfor
calibrate_cameras (CalibDataID, Error)
get_calib_data (CalibDataID, 'camera', 0, 'params', CamParam)
* Write the internal camera parameters to a file.
write_cam_par (CamParam, 'camera_parameters.dat')

Result🔗

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

Combinations with other operators🔗

Combinations

Possible predecessors

camera_calibrationCameraCalibration

See also

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

Module🔗

Foundation