Function rs2_config_resolve

Function Documentation

rs2_pipeline_profile *rs2_config_resolve(rs2_config *config, rs2_pipeline *pipe, rs2_error **error)

Resolve the configuration filters, to find a matching device and streams profiles. The method resolves the user configuration filters for the device and streams, and combines them with the requirements of the computer vision modules and processing blocks attached to the pipeline. If there are no conflicts of requests, it looks for an available device, which can satisfy all requests, and selects the first matching streams configuration. In the absence of any request, the rs2::config selects the first available device and the first color and depth streams configuration. The pipeline profile selection during start() follows the same method. Thus, the selected profile is the same, if no change occurs to the available devices occurs. Resolving the pipeline configuration provides the application access to the pipeline selected device for advanced control. The returned configuration is not applied to the device, so the application doesn’t own the device sensors. However, the application can call enable_device(), to enforce the device returned by this method is selected by pipeline start(), and configure the device and sensors options or extensions before streaming starts.

Parameters:

  • config – [in] A pointer to an instance of a config

  • pipe – [in] The pipeline for which the selected filters are applied

  • error – [out] if non-null, receives any error that occurs during this call, otherwise, errors are ignored

Returns:

A matching device and streams profile, which satisfies the filters and pipeline requests.