set_stereo_model_image_pairsT_set_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairs (Operator)
Name
set_stereo_model_image_pairsT_set_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairs — Specify image pairs to be used for surface stereo reconstruction.
Signature
Herror T_set_stereo_model_image_pairs(const Htuple StereoModelID, const Htuple From, const Htuple To)
Description
The operator set_stereo_model_image_pairsset_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairs stores a list of image
pairs for a stereo model StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelID of type
'surface_pairwise'"surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise" or 'surface_fusion'"surface_fusion""surface_fusion""surface_fusion""surface_fusion".
Calling the operator for a model of another type
will raise an error. In the mode 'surface_pairwise'"surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise" or
'surface_fusion'"surface_fusion""surface_fusion""surface_fusion""surface_fusion", surfaces are
reconstructed by computing disparity images for image pairs. You specify
these image pairs by passing tuples of camera indices in the parameters
FromFromFromFromfrom and ToToToToto. Then, e.g., the disparity image from
the camera with index From[0] to the camera with index
To[0] is computed and so on.
The camera indices must be valid for the camera setup model assigned to the
stereo model (see create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModel), otherwise an error is
returned. If an image pairs list already exists in the stereo model, it is
substituted by the current one.
Besides storing the list of image pairs, the operator
set_stereo_model_image_pairsset_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairs prepares a pair of rectification
image maps for each image pair, which are used repeatedly in successive
calls to reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereo to rectify the
images to a normalized binocular stereo pair; refer to
gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap for further details.
Three of the gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap parameters
are exported as stereo model parameters and can be modified by
set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam or just inspected by
get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParam:
- 'rectif_interpolation'"rectif_interpolation""rectif_interpolation""rectif_interpolation""rectif_interpolation":
Interpolation mode corresponding to the parameter MapTypeMapTypeMapTypeMapTypemapType
of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap.
- 'rectif_sub_sampling'"rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling":
sub-sampling factor corresponding to the parameter SubSamplingSubSamplingSubSamplingSubSamplingsubSampling
of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap.
- 'rectif_method'"rectif_method""rectif_method""rectif_method""rectif_method":
Rectification method corresponding to the parameter MethodMethodMethodMethodmethod
of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMap.
Note that after modifying these parameters,
set_stereo_model_image_pairsset_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairs must be executed again for the changes
to take effect.
The current list of image pairs in the model can be inspected by
get_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairs.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
The value of this parameter may not be shared across multiple threads without external synchronization.
Parameters
StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelID (input_control, state is modified) stereo_model → HStereoModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the stereo model.
FromFromFromFromfrom (input_control) integer-array → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Camera indices for the from cameras in the
image pairs.
Number of elements: From > 0
ToToToToto (input_control) integer-array → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Camera indices for the to cameras in the
image pairs.
Number of elements: To == From
Possible Predecessors
create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModel
Possible Successors
reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereo
See also
set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParam,
get_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairs
Module
3D Metrology