get_stereo_model_param — Get stereo model parameters.
The operator get_stereo_model_param can be used to inspect diverse parameters of the stereo model StereoModelID by specifying their names in ParamName and getting their values in ParamValue. Two types of parameters can be inspected with this operator - general and specific for surface reconstruction. Note that no specific parameters are provided for 3D point stereo reconstruction.
All parameters that can be set with set_stereo_model_param can also be queried with get_stereo_model_param - for a description see the former operator. In constrast, the following parameters are set by other operators and cannot be modified afterwards.
Type of the stereo model (currently either 'surface_pairwise' or 'points_3d').
Handle to a copy of the camera setup model set in the stereo model. Changing properties of the copy does not affect the camera setup model stored in the stereo model. Once the copy is not needed anymore, you must release its memory with clear_camera_setup_model.
These parameters are set when creating the stereo model with create_stereo_model.
Tuple of minimum or maximum disparity settings, respectively, for each image pair. This settings are computed internally from the bounding box specified for the stereo model (see set_stereo_model_param) and are then used as the parameters MinDisparity and MaxDisparity, respectively, in the internal call to binocular_disparity for the corresonding image pair. The indices of the image pairs can be queried by get_stereo_model_image_pairs. Note that this information is only available if the 'persistence' mode was switched on during surface reconstruction (see reconstruct_surface_stereo). Note furthermore that the returned values are tuple-valued and cannot be queried together with other parameters (more on this in the the paragraph "A note on tuple-valued model parameters" below).
Most of the stereo model parameters are single-valued. Thus, you can provide a list (i.e., tuple) of parameter names and get a list (tuple) of values that has the same length as the output tuple. In contrast, when querying a tuple-valued parameter, a tuple of values is returned. When querying such a parameter together with other parameters, the value-to-parameter-name correspondence is not obvious anymore. Thus, tuple-valued parameters like 'min_disparity' or and 'max_disparity' should always be queried in a separate call to get_stereo_model_param.
Handle of the stereo model.
Names of the parameters to be set.
List of values: 'binocular_filter', 'binocular_mask_height', 'binocular_mask_width', 'binocular_method', 'binocular_num_levels', 'binocular_score_thresh', 'binocular_sub_disparity', 'binocular_texture_thresh', 'bounding_box', 'camera_setup_model', 'disparity_method', 'max_disparity', 'min_disparity', 'persistence', 'point_meshing', 'poisson_depth', 'poisson_samples_per_node', 'poisson_solver_divide', 'rectif_interpolation', 'rectif_sub_sampling', 'sub_sampling_step', 'type'
Values of the parameters to be set.