set_stereo_model_image_pairsT_set_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsset_stereo_model_image_pairs (算子)
名称
set_stereo_model_image_pairsT_set_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsset_stereo_model_image_pairs — 指定用于表面立体重建的图像对。
签名
Herror T_set_stereo_model_image_pairs(const Htuple StereoModelID, const Htuple From, const Htuple To)
描述
算子 set_stereo_model_image_pairsset_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairsset_stereo_model_image_pairs stores a list of image
pairs for a stereo model StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelIDstereo_model_id of type
'surface_pairwise'"surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise""surface_pairwise" or 'surface_fusion'"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""surface_pairwise" or
'surface_fusion'"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
FromFromFromFromfromfrom and ToToToTototo. 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_modelCreateStereoModelCreateStereoModelCreateStereoModelcreate_stereo_model), 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_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairsset_stereo_model_image_pairs prepares a pair of rectification
image maps for each image pair, which are used repeatedly in successive
calls to reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereoreconstruct_surface_stereo to rectify the
images to a normalized binocular stereo pair; refer to
gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMapgen_binocular_rectification_map for further details.
Three of the gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMapgen_binocular_rectification_map parameters
are exported as stereo model parameters and can be modified by
set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParamset_stereo_model_param or just inspected by
get_stereo_model_paramget_stereo_model_paramGetStereoModelParamGetStereoModelParamGetStereoModelParamget_stereo_model_param:
- 'rectif_interpolation'"rectif_interpolation""rectif_interpolation""rectif_interpolation""rectif_interpolation""rectif_interpolation"：
Interpolation mode corresponding to the parameter MapTypeMapTypeMapTypeMapTypemapTypemap_type
of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMapgen_binocular_rectification_map。
- 'rectif_sub_sampling'"rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling""rectif_sub_sampling"：
sub-sampling factor corresponding to the parameter SubSamplingSubSamplingSubSamplingSubSamplingsubSamplingsub_sampling
of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMapgen_binocular_rectification_map。
- 'rectif_method'"rectif_method""rectif_method""rectif_method""rectif_method""rectif_method"：
Rectification method corresponding to the parameter MethodMethodMethodMethodmethodmethod
of gen_binocular_rectification_mapgen_binocular_rectification_mapGenBinocularRectificationMapGenBinocularRectificationMapGenBinocularRectificationMapgen_binocular_rectification_map。
Note that after modifying these parameters,
set_stereo_model_image_pairsset_stereo_model_image_pairsSetStereoModelImagePairsSetStereoModelImagePairsSetStereoModelImagePairsset_stereo_model_image_pairs 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_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairsget_stereo_model_image_pairs。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子修改后续输入参数的状态：
在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。
参数
StereoModelIDStereoModelIDStereoModelIDStereoModelIDstereoModelIDstereo_model_id (输入控制，状态被修改) stereo_model → HStereoModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the stereo model.
FromFromFromFromfromfrom (输入控制) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Camera indices for the from cameras in the
image pairs.
元素数量：
From > 0
ToToToTototo (输入控制) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Camera indices for the to cameras in the
image pairs.
元素数量：
To == From
可能的前趋
create_stereo_modelcreate_stereo_modelCreateStereoModelCreateStereoModelCreateStereoModelcreate_stereo_model
可能的后继
reconstruct_surface_stereoreconstruct_surface_stereoReconstructSurfaceStereoReconstructSurfaceStereoReconstructSurfaceStereoreconstruct_surface_stereo
另见
set_stereo_model_paramset_stereo_model_paramSetStereoModelParamSetStereoModelParamSetStereoModelParamset_stereo_model_param,
get_stereo_model_image_pairsget_stereo_model_image_pairsGetStereoModelImagePairsGetStereoModelImagePairsGetStereoModelImagePairsget_stereo_model_image_pairs
模块
三维计量