rs.h

Go to the documentation of this file.

/* License: Apache 2.0. See LICENSE file in root directory.
   Copyright(c) 2015 Intel Corporation. All Rights Reserved. */

#ifndef LIBREALSENSE_RS_H
#define LIBREALSENSE_RS_H

#ifdef __cplusplus
extern "C" {
#endif

#define RS_API_MAJOR_VERSION    1
#define RS_API_MINOR_VERSION    12
#define RS_API_PATCH_VERSION    4

#define STRINGIFY(arg) #arg
#define VAR_ARG_STRING(arg) STRINGIFY(arg)

/* Versioning rules            : For each release at least one of [MJR/MNR/PTCH] triple is promoted                                             */
/*                             : Versions that differ by RS_API_PATCH_VERSION only are interface-compatible, i.e. no user-code changes required */
/*                             : Versions that differ by MAJOR/MINOR VERSION component can introduce API changes                                */
/* Version in encoded integer format (1,9,x) -> 01090x. note that each component is limited into [0-99] range by design                         */
#define RS_API_VERSION  (((RS_API_MAJOR_VERSION) * 10000) + ((RS_API_MINOR_VERSION) * 100) + (RS_API_PATCH_VERSION))
/* Return version in "X.Y.Z" format */
#define RS_API_VERSION_STR (VAR_ARG_STRING(RS_API_MAJOR_VERSION.RS_API_MINOR_VERSION.RS_API_PATCH_VERSION))

typedef enum rs_stream
{
    RS_STREAM_DEPTH                            , 
    RS_STREAM_COLOR                            , 
    RS_STREAM_INFRARED                         , 
    RS_STREAM_INFRARED2                        , 
    RS_STREAM_FISHEYE                          , 
    RS_STREAM_POINTS                           , 
    RS_STREAM_RECTIFIED_COLOR                  , 
    RS_STREAM_COLOR_ALIGNED_TO_DEPTH           , 
    RS_STREAM_INFRARED2_ALIGNED_TO_DEPTH       , 
    RS_STREAM_DEPTH_ALIGNED_TO_COLOR           , 
    RS_STREAM_DEPTH_ALIGNED_TO_RECTIFIED_COLOR , 
    RS_STREAM_DEPTH_ALIGNED_TO_INFRARED2       , 
    RS_STREAM_COUNT                              
} rs_stream;

typedef enum rs_format
{
    RS_FORMAT_ANY         , 
    RS_FORMAT_Z16         , 
    RS_FORMAT_DISPARITY16 , 
    RS_FORMAT_XYZ32F      , 
    RS_FORMAT_YUYV        , 
    RS_FORMAT_RGB8        , 
    RS_FORMAT_BGR8        , 
    RS_FORMAT_RGBA8       , 
    RS_FORMAT_BGRA8       , 
    RS_FORMAT_Y8          , 
    RS_FORMAT_Y16         , 
    RS_FORMAT_RAW10       , 
    RS_FORMAT_RAW16       , 
    RS_FORMAT_RAW8        , 
    RS_FORMAT_COUNT         
} rs_format;

typedef enum rs_output_buffer_format
{
    RS_OUTPUT_BUFFER_FORMAT_CONTINUOUS     , 
    RS_OUTPUT_BUFFER_FORMAT_NATIVE         , 
    RS_OUTPUT_BUFFER_FORMAT_COUNT            
} rs_output_buffer_format;

typedef enum rs_preset
{
    RS_PRESET_BEST_QUALITY     , 
    RS_PRESET_LARGEST_IMAGE    , 
    RS_PRESET_HIGHEST_FRAMERATE, 
    RS_PRESET_COUNT              
} rs_preset;

typedef enum rs_source
{
    RS_SOURCE_VIDEO          , 
    RS_SOURCE_MOTION_TRACKING, 
    RS_SOURCE_ALL            , 
    RS_SOURCE_COUNT            
} rs_source;

typedef enum rs_distortion
{
    RS_DISTORTION_NONE                  , 
    RS_DISTORTION_MODIFIED_BROWN_CONRADY, 
    RS_DISTORTION_INVERSE_BROWN_CONRADY , 
    RS_DISTORTION_FTHETA                , 
    RS_DISTORTION_COUNT                   
} rs_distortion;

typedef enum rs_ivcam_preset
{
    RS_IVCAM_PRESET_SHORT_RANGE             , 
    RS_IVCAM_PRESET_LONG_RANGE              , 
    RS_IVCAM_PRESET_BACKGROUND_SEGMENTATION , 
    RS_IVCAM_PRESET_GESTURE_RECOGNITION     , 
    RS_IVCAM_PRESET_OBJECT_SCANNING         , 
    RS_IVCAM_PRESET_FACE_ANALYTICS          , 
    RS_IVCAM_PRESET_FACE_LOGIN              , 
    RS_IVCAM_PRESET_GR_CURSOR               , 
    RS_IVCAM_PRESET_DEFAULT                 , 
    RS_IVCAM_PRESET_MID_RANGE               , 
    RS_IVCAM_PRESET_IR_ONLY                 , 
    RS_IVCAM_PRESET_COUNT                     
} rs_ivcam_preset;

typedef enum rs_option
{
    RS_OPTION_COLOR_BACKLIGHT_COMPENSATION                    , 
    RS_OPTION_COLOR_BRIGHTNESS                                , 
    RS_OPTION_COLOR_CONTRAST                                  , 
    RS_OPTION_COLOR_EXPOSURE                                  , 
    RS_OPTION_COLOR_GAIN                                      , 
    RS_OPTION_COLOR_GAMMA                                     , 
    RS_OPTION_COLOR_HUE                                       , 
    RS_OPTION_COLOR_SATURATION                                , 
    RS_OPTION_COLOR_SHARPNESS                                 , 
    RS_OPTION_COLOR_WHITE_BALANCE                             , 
    RS_OPTION_COLOR_ENABLE_AUTO_EXPOSURE                      , 
    RS_OPTION_COLOR_ENABLE_AUTO_WHITE_BALANCE                 , 
    RS_OPTION_F200_LASER_POWER                                , 
    RS_OPTION_F200_ACCURACY                                   , 
    RS_OPTION_F200_MOTION_RANGE                               , 
    RS_OPTION_F200_FILTER_OPTION                              , 
    RS_OPTION_F200_CONFIDENCE_THRESHOLD                       , 
    RS_OPTION_F200_DYNAMIC_FPS                                , 
    RS_OPTION_SR300_AUTO_RANGE_ENABLE_MOTION_VERSUS_RANGE     , 
    RS_OPTION_SR300_AUTO_RANGE_ENABLE_LASER                   , 
    RS_OPTION_SR300_AUTO_RANGE_MIN_MOTION_VERSUS_RANGE        , 
    RS_OPTION_SR300_AUTO_RANGE_MAX_MOTION_VERSUS_RANGE        , 
    RS_OPTION_SR300_AUTO_RANGE_START_MOTION_VERSUS_RANGE      , 
    RS_OPTION_SR300_AUTO_RANGE_MIN_LASER                      , 
    RS_OPTION_SR300_AUTO_RANGE_MAX_LASER                      , 
    RS_OPTION_SR300_AUTO_RANGE_START_LASER                    , 
    RS_OPTION_SR300_AUTO_RANGE_UPPER_THRESHOLD                , 
    RS_OPTION_SR300_AUTO_RANGE_LOWER_THRESHOLD                , 
    RS_OPTION_R200_LR_AUTO_EXPOSURE_ENABLED                   , 
    RS_OPTION_R200_LR_GAIN                                    , 
    RS_OPTION_R200_LR_EXPOSURE                                , 
    RS_OPTION_R200_EMITTER_ENABLED                            , 
    RS_OPTION_R200_DEPTH_UNITS                                , 
    RS_OPTION_R200_DEPTH_CLAMP_MIN                            , 
    RS_OPTION_R200_DEPTH_CLAMP_MAX                            , 
    RS_OPTION_R200_DISPARITY_MULTIPLIER                       , 
    RS_OPTION_R200_DISPARITY_SHIFT                            , 
    RS_OPTION_R200_AUTO_EXPOSURE_MEAN_INTENSITY_SET_POINT     , 
    RS_OPTION_R200_AUTO_EXPOSURE_BRIGHT_RATIO_SET_POINT       , 
    RS_OPTION_R200_AUTO_EXPOSURE_KP_GAIN                      , 
    RS_OPTION_R200_AUTO_EXPOSURE_KP_EXPOSURE                  , 
    RS_OPTION_R200_AUTO_EXPOSURE_KP_DARK_THRESHOLD            , 
    RS_OPTION_R200_AUTO_EXPOSURE_TOP_EDGE                     , 
    RS_OPTION_R200_AUTO_EXPOSURE_BOTTOM_EDGE                  , 
    RS_OPTION_R200_AUTO_EXPOSURE_LEFT_EDGE                    , 
    RS_OPTION_R200_AUTO_EXPOSURE_RIGHT_EDGE                   , 
    RS_OPTION_R200_DEPTH_CONTROL_ESTIMATE_MEDIAN_DECREMENT    , 
    RS_OPTION_R200_DEPTH_CONTROL_ESTIMATE_MEDIAN_INCREMENT    , 
    RS_OPTION_R200_DEPTH_CONTROL_MEDIAN_THRESHOLD             , 
    RS_OPTION_R200_DEPTH_CONTROL_SCORE_MINIMUM_THRESHOLD      , 
    RS_OPTION_R200_DEPTH_CONTROL_SCORE_MAXIMUM_THRESHOLD      , 
    RS_OPTION_R200_DEPTH_CONTROL_TEXTURE_COUNT_THRESHOLD      , 
    RS_OPTION_R200_DEPTH_CONTROL_TEXTURE_DIFFERENCE_THRESHOLD , 
    RS_OPTION_R200_DEPTH_CONTROL_SECOND_PEAK_THRESHOLD        , 
    RS_OPTION_R200_DEPTH_CONTROL_NEIGHBOR_THRESHOLD           , 
    RS_OPTION_R200_DEPTH_CONTROL_LR_THRESHOLD                 , 
    RS_OPTION_FISHEYE_EXPOSURE                                , 
    RS_OPTION_FISHEYE_GAIN                                    , 
    RS_OPTION_FISHEYE_STROBE                                  , 
    RS_OPTION_FISHEYE_EXTERNAL_TRIGGER                        , 
    RS_OPTION_FISHEYE_ENABLE_AUTO_EXPOSURE                    , 
    RS_OPTION_FISHEYE_AUTO_EXPOSURE_MODE                      , 
    RS_OPTION_FISHEYE_AUTO_EXPOSURE_ANTIFLICKER_RATE          , 
    RS_OPTION_FISHEYE_AUTO_EXPOSURE_PIXEL_SAMPLE_RATE         , 
    RS_OPTION_FISHEYE_AUTO_EXPOSURE_SKIP_FRAMES               , 
    RS_OPTION_FRAMES_QUEUE_SIZE                               , 
    RS_OPTION_HARDWARE_LOGGER_ENABLED                         , 
    RS_OPTION_TOTAL_FRAME_DROPS                               , 
    RS_OPTION_COUNT                                           , 
} rs_option;

typedef enum rs_frame_metadata
{
    RS_FRAME_METADATA_ACTUAL_EXPOSURE, 
    RS_FRAME_METADATA_ACTUAL_FPS,      
    RS_FRAME_METADATA_COUNT            
} rs_frame_metadata;

typedef enum rs_capabilities
{
    RS_CAPABILITIES_DEPTH,                      
    RS_CAPABILITIES_COLOR,                      
    RS_CAPABILITIES_INFRARED,                   
    RS_CAPABILITIES_INFRARED2,                  
    RS_CAPABILITIES_FISH_EYE,                   
    RS_CAPABILITIES_MOTION_EVENTS,              
    RS_CAPABILITIES_MOTION_MODULE_FW_UPDATE,    
    RS_CAPABILITIES_ADAPTER_BOARD,              
    RS_CAPABILITIES_ENUMERATION,                
    RS_CAPABILITIES_COUNT,                      
} rs_capabilities;

typedef enum rs_blob_type {
    RS_BLOB_TYPE_MOTION_MODULE_FIRMWARE_UPDATE, 
    RS_BLOB_TYPE_COUNT                          
}  rs_blob_type;

typedef enum rs_camera_info {
    RS_CAMERA_INFO_DEVICE_NAME                   , 
    RS_CAMERA_INFO_DEVICE_SERIAL_NUMBER          , 
    RS_CAMERA_INFO_CAMERA_FIRMWARE_VERSION       , 
    RS_CAMERA_INFO_ADAPTER_BOARD_FIRMWARE_VERSION, 
    RS_CAMERA_INFO_MOTION_MODULE_FIRMWARE_VERSION, 
    RS_CAMERA_INFO_CAMERA_TYPE                   , 
    RS_CAMERA_INFO_OEM_ID                        , 
    RS_CAMERA_INFO_ISP_FW_VERSION                , 
    RS_CAMERA_INFO_CONTENT_VERSION               , 
    RS_CAMERA_INFO_MODULE_VERSION                , 
    RS_CAMERA_INFO_IMAGER_MODEL_NUMBER           , 
    RS_CAMERA_INFO_BUILD_DATE                    , 
    RS_CAMERA_INFO_CALIBRATION_DATE              , 
    RS_CAMERA_INFO_PROGRAM_DATE                  , 
    RS_CAMERA_INFO_FOCUS_ALIGNMENT_DATE          , 
    RS_CAMERA_INFO_EMITTER_TYPE                  , 
    RS_CAMERA_INFO_FOCUS_VALUE                   , 
    RS_CAMERA_INFO_LENS_TYPE                     , 
    RS_CAMERA_INFO_3RD_LENS_TYPE                 , 
    RS_CAMERA_INFO_LENS_COATING__TYPE            , 
    RS_CAMERA_INFO_3RD_LENS_COATING_TYPE         , 
    RS_CAMERA_INFO_NOMINAL_BASELINE              , 
    RS_CAMERA_INFO_3RD_NOMINAL_BASELINE          , 
    RS_CAMERA_INFO_COUNT                           
} rs_camera_info;

typedef enum rs_log_severity {
    RS_LOG_SEVERITY_DEBUG, 
    RS_LOG_SEVERITY_INFO , 
    RS_LOG_SEVERITY_WARN , 
    RS_LOG_SEVERITY_ERROR, 
    RS_LOG_SEVERITY_FATAL, 
    RS_LOG_SEVERITY_NONE , 
    RS_LOG_SEVERITY_COUNT  
} rs_log_severity;

typedef enum rs_event_source
{
    RS_EVENT_IMU_ACCEL     , 
    RS_EVENT_IMU_GYRO      , 
    RS_EVENT_IMU_DEPTH_CAM , 
    RS_EVENT_IMU_MOTION_CAM, 
    RS_EVENT_G0_SYNC       , 
    RS_EVENT_G1_SYNC       , 
    RS_EVENT_G2_SYNC       , 
    RS_EVENT_SOURCE_COUNT    
}rs_event_source;

typedef enum rs_timestamp_domain
{
    RS_TIMESTAMP_DOMAIN_CAMERA         , 
    RS_TIMESTAMP_DOMAIN_MICROCONTROLLER, 
    RS_TIMESTAMP_DOMAIN_COUNT            
}rs_timestamp_domain;

typedef struct rs_intrinsics
{
    int           width;     
    int           height;    
    float         ppx;       
    float         ppy;       
    float         fx;        
    float         fy;        
    rs_distortion model;     
    float         coeffs[5]; 
} rs_intrinsics;

typedef struct rs_motion_device_intrinsic
{
    /* Scale X        cross axis        cross axis      Bias X */
    /* cross axis     Scale Y           cross axis      Bias Y */
    /* cross axis     cross axis        Scale Z         Bias Z */
    float data[3][4];          
    float noise_variances[3];  
    float bias_variances[3];   
} rs_motion_device_intrinsic;

typedef struct rs_motion_intrinsics
{
    rs_motion_device_intrinsic acc;
    rs_motion_device_intrinsic gyro;
} rs_motion_intrinsics;

typedef struct rs_extrinsics
{
    float rotation[9];    
    float translation[3]; 
} rs_extrinsics;

typedef struct rs_timestamp_data
{
    double              timestamp;     
    rs_event_source     source_id;     
    unsigned long long  frame_number;  
} rs_timestamp_data;

typedef struct rs_motion_data
{
    rs_timestamp_data   timestamp_data; 
    unsigned int        is_valid;   
    float               axes[3];    
} rs_motion_data;


typedef struct rs_context rs_context;
typedef struct rs_device rs_device;
typedef struct rs_error rs_error;
typedef struct rs_frameset rs_frameset;
typedef struct rs_frame_ref rs_frame_ref;
typedef struct rs_motion_callback rs_motion_callback;
typedef struct rs_frame_callback rs_frame_callback;
typedef struct rs_timestamp_callback rs_timestamp_callback;
typedef struct rs_log_callback rs_log_callback;

typedef void (*rs_frame_callback_ptr)(rs_device * dev, rs_frame_ref * frame, void * user);
typedef void (*rs_motion_callback_ptr)(rs_device * , rs_motion_data, void * );
typedef void (*rs_timestamp_callback_ptr)(rs_device * , rs_timestamp_data, void * );
typedef void (*rs_log_callback_ptr)(rs_log_severity min_severity, const char * message, void * user);

rs_context * rs_create_context(int api_version, rs_error ** error);

void rs_delete_context(rs_context * context, rs_error ** error);

int rs_get_device_count(const rs_context * context, rs_error ** error);

rs_device * rs_get_device(rs_context * context, int index, rs_error ** error);

const char * rs_get_device_name(const rs_device * device, rs_error ** error);

const char * rs_get_device_serial(const rs_device * device, rs_error ** error);

const char * rs_get_device_info(const rs_device * device, rs_camera_info info, rs_error ** error);

const char * rs_get_device_usb_port_id(const rs_device * device, rs_error ** error);

const char * rs_get_device_firmware_version(const rs_device * device, rs_error ** error);

void rs_get_device_extrinsics(const rs_device * device, rs_stream from_stream, rs_stream to_stream, rs_extrinsics * extrin, rs_error ** error);

void rs_get_motion_extrinsics_from(const rs_device * device, rs_stream from, rs_extrinsics * extrin, rs_error ** error);

float rs_get_device_depth_scale(const rs_device * device, rs_error ** error);

int rs_device_supports_option(const rs_device * device, rs_option option, rs_error ** error);

int rs_get_stream_mode_count(const rs_device * device, rs_stream stream, rs_error ** error);

void rs_get_stream_mode(const rs_device * device, rs_stream stream, int index, int * width, int * height, rs_format * format, int * framerate, rs_error ** error);

void rs_enable_stream_ex(rs_device * device, rs_stream stream, int width, int height, rs_format format, int framerate, rs_output_buffer_format output_format, rs_error ** error);

void rs_enable_stream(rs_device * device, rs_stream stream, int width, int height, rs_format format, int framerate, rs_error ** error);

void rs_enable_stream_preset(rs_device * device, rs_stream stream, rs_preset preset, rs_error ** error);

void rs_disable_stream(rs_device * device, rs_stream stream, rs_error ** error);

int rs_is_stream_enabled(const rs_device * device, rs_stream stream, rs_error ** error);

int rs_get_stream_width(const rs_device * device, rs_stream stream, rs_error ** error);

int rs_get_stream_height(const rs_device * device, rs_stream stream, rs_error ** error);

rs_format rs_get_stream_format(const rs_device * device, rs_stream stream, rs_error ** error);

int rs_get_stream_framerate(const rs_device * device, rs_stream stream, rs_error ** error);

void rs_get_stream_intrinsics(const rs_device * device, rs_stream stream, rs_intrinsics * intrin, rs_error ** error);

void rs_get_motion_intrinsics(const rs_device * device, rs_motion_intrinsics * intrinsic, rs_error ** error);

void rs_set_frame_callback(rs_device * device, rs_stream stream, rs_frame_callback_ptr on_frame, void * user, rs_error ** error);

void rs_enable_motion_tracking(rs_device * device,
    rs_motion_callback_ptr on_motion_event, void * motion_handler,
    rs_timestamp_callback_ptr on_timestamp_event, void * timestamp_handler,
    rs_error ** error);

void rs_enable_motion_tracking_cpp(rs_device * device,
    rs_motion_callback * motion_callback,
    rs_timestamp_callback * timestamp_callback,
    rs_error ** error);

void rs_set_frame_callback_cpp(rs_device * device, rs_stream stream, rs_frame_callback * callback, rs_error ** error);

void rs_disable_motion_tracking(rs_device * device, rs_error ** error);

int rs_is_motion_tracking_active(rs_device * device, rs_error ** error);


void rs_start_device(rs_device * device, rs_error ** error);

void rs_stop_device(rs_device * device, rs_error ** error);

void rs_start_source(rs_device * device, rs_source source, rs_error ** error);

void rs_stop_source(rs_device * device, rs_source source, rs_error ** error);

int rs_is_device_streaming(const rs_device * device, rs_error ** error);

void rs_get_device_option_range(rs_device * device, rs_option option, double * min, double * max, double * step, rs_error ** error);

void rs_get_device_option_range_ex(rs_device * device, rs_option option, double * min, double * max, double * step, double * def, rs_error ** error);

void rs_get_device_options(rs_device * device, const rs_option * options, unsigned int count, double * values, rs_error ** error);

void rs_set_device_options(rs_device * device, const rs_option * options, unsigned int count, const double * values, rs_error ** error);

void rs_reset_device_options_to_default(rs_device * device, const rs_option* options, int count, rs_error ** error);

double rs_get_device_option(rs_device * device, rs_option option, rs_error ** error);


const char * rs_get_device_option_description(rs_device * device, rs_option option, rs_error ** error);


void rs_set_device_option(rs_device * device, rs_option option, double value, rs_error ** error);

void rs_wait_for_frames(rs_device * device, rs_error ** error);

int rs_poll_for_frames(rs_device * device, rs_error ** error);

int rs_supports(rs_device * device, rs_capabilities capability, rs_error ** error);

int rs_supports_camera_info(rs_device * device, rs_camera_info info_param, rs_error ** error);

double rs_get_detached_frame_metadata(const rs_frame_ref * frame, rs_frame_metadata frame_metadata, rs_error ** error);

int rs_supports_frame_metadata(const rs_frame_ref * frame, rs_frame_metadata frame_metadata, rs_error ** error);

double rs_get_frame_timestamp(const rs_device * device, rs_stream stream, rs_error ** error);

unsigned long long rs_get_frame_number(const rs_device * device, rs_stream stream, rs_error ** error);

const void * rs_get_frame_data(const rs_device * device, rs_stream stream, rs_error ** error);

void rs_release_frame(rs_device * device, rs_frame_ref * frame, rs_error ** error);

double rs_get_detached_frame_timestamp(const rs_frame_ref * frame, rs_error ** error);

rs_timestamp_domain rs_get_detached_frame_timestamp_domain(const rs_frame_ref * frame, rs_error ** error);

unsigned long long rs_get_detached_frame_number(const rs_frame_ref * frame, rs_error ** error);

const void * rs_get_detached_frame_data(const rs_frame_ref * frame, rs_error ** error);

int rs_get_detached_frame_width(const rs_frame_ref * frame, rs_error ** error);

int rs_get_detached_frame_height(const rs_frame_ref * frame, rs_error ** error);

int rs_get_detached_framerate(const rs_frame_ref * frame, rs_error ** error);

int rs_get_detached_frame_stride(const rs_frame_ref * frame, rs_error ** error);

int rs_get_detached_frame_bpp(const rs_frame_ref * frame, rs_error ** error);

rs_format rs_get_detached_frame_format(const rs_frame_ref * frame, rs_error ** error);

rs_stream rs_get_detached_frame_stream_type(const rs_frame_ref * frame, rs_error ** error);

void rs_send_blob_to_device(rs_device * device, rs_blob_type type, void * data, int size, rs_error ** error);

int          rs_get_api_version      (rs_error ** error);

const char * rs_get_failed_function  (const rs_error * error);

const char * rs_get_failed_args      (const rs_error * error);

const char * rs_get_error_message    (const rs_error * error);

void         rs_free_error           (rs_error * error);

const char * rs_stream_to_string     (rs_stream stream); 
const char * rs_format_to_string     (rs_format format);
const char * rs_preset_to_string     (rs_preset preset);
const char * rs_distortion_to_string (rs_distortion distortion);
const char * rs_option_to_string     (rs_option option);
const char * rs_capabilities_to_string(rs_capabilities capability);
const char * rs_source_to_string     (rs_source source);
const char * rs_event_to_string      (rs_event_source event);
const char * rs_blob_type_to_string  (rs_blob_type type);
const char * rs_camera_info_to_string(rs_camera_info info);
const char * rs_camera_info_to_string(rs_camera_info info);
const char * rs_timestamp_domain_to_string(rs_timestamp_domain info);
const char * rs_frame_metadata_to_string(rs_frame_metadata md);

void rs_log_to_console(rs_log_severity min_severity, rs_error ** error);

void rs_log_to_file(rs_log_severity min_severity, const char * file_path, rs_error ** error);

void rs_log_to_callback_cpp(rs_log_severity min_severity, rs_log_callback * callback, rs_error ** error);

void rs_log_to_callback(rs_log_severity min_severity, rs_log_callback_ptr on_log, void * user, rs_error ** error);

#ifdef __cplusplus
}
#endif
#endif