ClassesClasses | | Operators

get_stereo_model_paramT_get_stereo_model_paramGetStereoModelParamGetStereoModelParam (Operator)

Name

get_stereo_model_paramT_get_stereo_model_paramGetStereoModelParamGetStereoModelParam — Get stereo model parameters.

Signature

get_stereo_model_param( : : StereoModelID, GenParamName : GenParamValue)

Herror T_get_stereo_model_param(const Htuple StereoModelID, const Htuple GenParamName, Htuple* GenParamValue)

void GetStereoModelParam(const HTuple& StereoModelID, const HTuple& GenParamName, HTuple* GenParamValue)

HTuple HStereoModel::GetStereoModelParam(const HTuple& GenParamName) const

HTuple HStereoModel::GetStereoModelParam(const HString& GenParamName) const

HTuple HStereoModel::GetStereoModelParam(const char* GenParamName) const

static void HOperatorSet.GetStereoModelParam(HTuple stereoModelID, HTuple genParamName, out HTuple genParamValue)

HTuple HStereoModel.GetStereoModelParam(HTuple genParamName)

HTuple HStereoModel.GetStereoModelParam(string genParamName)

Description

The operator get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam can be used to inspect diverse parameters of the stereo model StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelID by specifying their names in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName and getting their values in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue. 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_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam can also be queried with get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam - for a description see the former operator. In contrast, the following parameters are set by other operators and cannot be modified afterwards.

General parameters

'type'"type""type""type""type":

Type of the stereo model (currently either 'surface_pairwise'"surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise", 'surface_fusion'"surface_fusion""surface_fusion""surface_fusion""surface_fusion" or 'points_3d'"points_3d""points_3d""points_3d""points_3d").

'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model":

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_modelclear_camera_setup_modelClearCameraSetupModelClearCameraSetupModelClearCameraSetupModel.

These parameters are set when creating the stereo model with create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModel.

Surface reconstruction parameters

'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity",'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity":

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_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam) and are then used as the parameters MinDisparity and MaxDisparity, respectively, in the internal call to binocular_disparitybinocular_disparityBinocularDisparityBinocularDisparityBinocularDisparity or binocular_disparity_msbinocular_disparity_msBinocularDisparityMsBinocularDisparityMsBinocularDisparityMs for the corresponding image pair. The indices of the image pairs can be queried by get_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairs. Note that this information is only available if the 'persistence'"persistence""persistence""persistence""persistence" mode was switched on during surface reconstruction (see reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereo). 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).

A note on tuple-valued model parameters

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'"min_disparity""min_disparity""min_disparity""min_disparity" or and 'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity" should always be queried in a separate call to get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam.

Execution Information

Parameters

StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelID (input_control)  stereo_model HStereoModel, HTupleHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Handle of the stereo model.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Names of the parameters to be set.

List of values: 'binocular_filter'"binocular_filter""binocular_filter""binocular_filter""binocular_filter", 'binocular_mask_height'"binocular_mask_height""binocular_mask_height""binocular_mask_height""binocular_mask_height", 'binocular_mask_width'"binocular_mask_width""binocular_mask_width""binocular_mask_width""binocular_mask_width", 'binocular_method'"binocular_method""binocular_method""binocular_method""binocular_method", 'binocular_mg_cycle_type'"binocular_mg_cycle_type""binocular_mg_cycle_type""binocular_mg_cycle_type""binocular_mg_cycle_type", 'binocular_mg_gradient_constancy'"binocular_mg_gradient_constancy""binocular_mg_gradient_constancy""binocular_mg_gradient_constancy""binocular_mg_gradient_constancy", 'binocular_mg_gray_constancy'"binocular_mg_gray_constancy""binocular_mg_gray_constancy""binocular_mg_gray_constancy""binocular_mg_gray_constancy", 'binocular_mg_initial_guess'"binocular_mg_initial_guess""binocular_mg_initial_guess""binocular_mg_initial_guess""binocular_mg_initial_guess", 'binocular_mg_initial_level'"binocular_mg_initial_level""binocular_mg_initial_level""binocular_mg_initial_level""binocular_mg_initial_level", 'binocular_mg_iterations'"binocular_mg_iterations""binocular_mg_iterations""binocular_mg_iterations""binocular_mg_iterations", 'binocular_mg_post_relax'"binocular_mg_post_relax""binocular_mg_post_relax""binocular_mg_post_relax""binocular_mg_post_relax", 'binocular_mg_pre_relax'"binocular_mg_pre_relax""binocular_mg_pre_relax""binocular_mg_pre_relax""binocular_mg_pre_relax", 'binocular_mg_pyramid_factor'"binocular_mg_pyramid_factor""binocular_mg_pyramid_factor""binocular_mg_pyramid_factor""binocular_mg_pyramid_factor", 'binocular_mg_smoothness'"binocular_mg_smoothness""binocular_mg_smoothness""binocular_mg_smoothness""binocular_mg_smoothness", 'binocular_mg_solver'"binocular_mg_solver""binocular_mg_solver""binocular_mg_solver""binocular_mg_solver", 'binocular_ms_consistency_check'"binocular_ms_consistency_check""binocular_ms_consistency_check""binocular_ms_consistency_check""binocular_ms_consistency_check", 'binocular_ms_edge_smoothing'"binocular_ms_edge_smoothing""binocular_ms_edge_smoothing""binocular_ms_edge_smoothing""binocular_ms_edge_smoothing", 'binocular_ms_similarity_measure'"binocular_ms_similarity_measure""binocular_ms_similarity_measure""binocular_ms_similarity_measure""binocular_ms_similarity_measure", 'binocular_ms_sub_disparity'"binocular_ms_sub_disparity""binocular_ms_sub_disparity""binocular_ms_sub_disparity""binocular_ms_sub_disparity", 'binocular_ms_surface_smoothing'"binocular_ms_surface_smoothing""binocular_ms_surface_smoothing""binocular_ms_surface_smoothing""binocular_ms_surface_smoothing", 'binocular_num_levels'"binocular_num_levels""binocular_num_levels""binocular_num_levels""binocular_num_levels", 'binocular_score_thresh'"binocular_score_thresh""binocular_score_thresh""binocular_score_thresh""binocular_score_thresh", 'binocular_sub_disparity'"binocular_sub_disparity""binocular_sub_disparity""binocular_sub_disparity""binocular_sub_disparity", 'binocular_texture_thresh'"binocular_texture_thresh""binocular_texture_thresh""binocular_texture_thresh""binocular_texture_thresh", 'bounding_box'"bounding_box""bounding_box""bounding_box""bounding_box", 'camera_setup_model'"camera_setup_model""camera_setup_model""camera_setup_model""camera_setup_model", 'color'"color""color""color""color", 'color_invisible'"color_invisible""color_invisible""color_invisible""color_invisible", 'disparity_method'"disparity_method""disparity_method""disparity_method""disparity_method", 'max_disparity'"max_disparity""max_disparity""max_disparity""max_disparity", 'min_disparity'"min_disparity""min_disparity""min_disparity""min_disparity", 'min_thickness'"min_thickness""min_thickness""min_thickness""min_thickness", 'persistence'"persistence""persistence""persistence""persistence", 'point_meshing'"point_meshing""point_meshing""point_meshing""point_meshing", 'poisson_depth'"poisson_depth""poisson_depth""poisson_depth""poisson_depth", 'poisson_samples_per_node'"poisson_samples_per_node""poisson_samples_per_node""poisson_samples_per_node""poisson_samples_per_node", 'poisson_solver_divide'"poisson_solver_divide""poisson_solver_divide""poisson_solver_divide""poisson_solver_divide", 'rectif_interpolation'"rectif_interpolation""rectif_interpolation""rectif_interpolation""rectif_interpolation", 'rectif_sub_sampling'"rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling", 'resolution'"resolution""resolution""resolution""resolution", 'smoothing'"smoothing""smoothing""smoothing""smoothing", 'sub_sampling_step'"sub_sampling_step""sub_sampling_step""sub_sampling_step""sub_sampling_step", 'surface_tolerance'"surface_tolerance""surface_tolerance""surface_tolerance""surface_tolerance", 'type'"type""type""type""type"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (output_control)  attribute.value-array HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)

Values of the parameters to be set.

Possible Predecessors

create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModel, set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam

Possible Successors

reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereo, reconstruct_points_stereoreconstruct_points_stereoReconstructPointsStereoReconstructPointsStereoReconstructPointsStereo

See also

set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam

Module

3D Metrology


ClassesClasses | | Operators