interlacer.h

Go to the documentation of this file.

#ifndef CNSDK_LEIA_CORE_INTERLACER_H
#define CNSDK_LEIA_CORE_INTERLACER_H
 
#include "leia/core/api.h"
#include "leia/core/types.h"
#include "leia/common/types.h"
#include "leia/common/slice.h"
#include "leia/common/jniTypes.h"
 
BEGIN_CAPI_DECL
 
#pragma pack(push, 8)
 
#ifdef LEIA_DOXYGEN
 
struct leia_interlacer {};
 
struct leia_interlacer_init_configuration {};
 
struct leia_interlacer_gui_configuration {};
 
#endif
 
LEIA_NODISCARD
LEIASDK_API
struct leia_interlacer_init_configuration* leia_interlacer_init_configuration_alloc();
 
LEIASDK_API
void leia_interlacer_init_configuration_set_is_protected(struct leia_interlacer_init_configuration*, leia_bool);
 
LEIASDK_API
void leia_interlacer_init_configuration_set_use_atlas_for_views(struct leia_interlacer_init_configuration*, leia_bool);
 
LEIASDK_API
void leia_interlacer_init_configuration_free(struct leia_interlacer_init_configuration*);
 
LEIASDK_API
void leia_interlacer_retain(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_release(struct leia_interlacer*);
 
typedef void (*leia_interlacer_enable_act)(struct leia_interlacer*, leia_bool enable);
#define leia_interlacer_enable_act_VERSION (1)
 
typedef leia_bool (*leia_interlacer_is_act_enabled)(struct leia_interlacer*);
#define leia_interlacer_is_act_enabled_VERSION (1)
 
enum {
    LEIA_INTERLACER_MAX_LAYERS = 16, 
    LEIA_INTERLACER_MAX_VIEWS  = 12, 
};
 
LEIASDK_API
int32_t leia_interlacer_get_max_layer_count(struct leia_interlacer*);
 
LEIASDK_API
int32_t leia_interlacer_get_max_view_count(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_set_layer_count(struct leia_interlacer*, int layerCount);
 
LEIA_NODISCARD
LEIASDK_API
int leia_interlacer_get_layer_count(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_set_num_tiles(struct leia_interlacer*, int32_t tx, int32_t ty);
 
LEIASDK_API
void leia_interlacer_get_num_tiles(struct leia_interlacer*, int32_t* tx, int32_t* ty);
 
LEIASDK_API
void leia_interlacer_set_tile_layout(struct leia_interlacer*, enum leia_tile_layout tileLayout);
 
LEIASDK_API
void leia_interlacer_output_as_tiles(struct leia_interlacer*, leia_bool enable);
 
LEIASDK_API
void leia_interlacer_set_baseline_scaling(struct leia_interlacer*, float baseline);
 
LEIA_NODISCARD
LEIASDK_API
float leia_interlacer_get_baseline_scaling(struct leia_interlacer*);
 
LEIA_NODISCARD
LEIASDK_API
float leia_interlacer_get_convergence_distance(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_set_convergence_distance(struct leia_interlacer*, float distance);
 
LEIASDK_API
float leia_interlacer_get_phc(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_set_phc(struct leia_interlacer*, float phase);
 
LEIASDK_API
void leia_interlacer_get_converged_orthographic_view_info(struct leia_interlacer*,
                                                          int32_t viewIndex,
                                                          LEIA_CONST_FLOAT_SLICE(3) cameraPos,
                                                          LEIA_CONST_FLOAT_SLICE(3) cameraDir,
                                                          LEIA_CONST_FLOAT_SLICE(3) cameraUp,
                                                          float width,
                                                          float height,
                                                          float nearPlane,
                                                          float farPlane,
                                                          LEIA_FLOAT_SLICE(3) viewPos,
                                                          LEIA_FLOAT_SLICE(16) viewProjectionMatrix,
                                                          float* viewShearX,
                                                          float* viewShearY);
 
LEIASDK_API
void leia_interlacer_get_converged_perspective_view_info(struct leia_interlacer*,
                                                         int32_t viewIndex,
                                                         LEIA_CONST_FLOAT_SLICE(3) cameraPos,
                                                         LEIA_CONST_FLOAT_SLICE(3) cameraDir,
                                                         LEIA_CONST_FLOAT_SLICE(3) cameraUp,
                                                         float fieldOfView,
                                                         float aspectRatio,
                                                         float nearPlane,
                                                         float farPlane,
                                                         LEIA_FLOAT_SLICE(3) viewPos,
                                                         LEIA_FLOAT_SLICE(16) viewProjectionMatrix,
                                                         float* viewFieldOfView,
                                                         float* viewShearX,
                                                         float* viewShearY);
 
LEIASDK_API
void leia_interlacer_set_fit_mode(struct leia_interlacer*, enum leia_fit_mode mode);
 
LEIA_NODISCARD
LEIASDK_API
enum leia_fit_mode leia_interlacer_get_fit_mode(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_get_rect_matrix(struct leia_interlacer*, LEIA_FLOAT_SLICE(16) transformMatrix);
 
LEIASDK_API
void leia_interlacer_set_local_matrix(struct leia_interlacer*, LEIA_CONST_FLOAT_SLICE(16) transformMatrix);
 
typedef leia_bool (*leia_interlacer_init_zone_plate)(struct leia_interlacer*,
                                                     int32_t viewportWidth,
                                                     int32_t viewportHeight,
                                                     float*  posX,
                                                     float*  posY,
                                                     float*  scaleX,
                                                     float*  scaleY,
                                                     float*  overrideSupportCirclePhase);
#define leia_interlacer_init_zone_plate_VERSION (1)
 
typedef void (*leia_interlacer_set_zone_plate)(struct leia_interlacer*, float posX, float posY, float scaleX, float scaleY, float overrideSupportCirclePhase);
#define leia_interlacer_set_zone_plate_VERSION (1)
 
typedef leia_bool (*leia_interlacer_get_zone_plate_results)(struct leia_interlacer*, float* slant, float* pitch, float* phc, float* dOverN, float* n);
#define leia_interlacer_get_zone_plate_results_VERSION (3)
 
typedef void (*leia_interlacer_set_support_circle_phase)(struct leia_interlacer*, float phase);
#define leia_interlacer_set_support_circle_phase_VERSION (1)
 
typedef leia_bool (*leia_interlacer_write_zone_plate_results)(struct leia_interlacer*, float slant, float pitch, float phc, float dOverN, float n);
#define leia_interlacer_write_zone_plate_results_VERSION (3)
 
typedef void (*leia_interlacer_set_camera_rectification_parameters)(
    struct leia_interlacer*, leia_bool isFront, float deltaThetaX, float deltaThetaY, float deltaThetaZ, float calibrationTargetDistanceMm);
#define leia_interlacer_set_camera_rectification_parameters_VERSION (2)
 
typedef void (*leia_interlacer_set_camera_angles)(struct leia_interlacer*, leia_bool isLeft, float thetaXFpc, float thetaYFpc, float thetaZFpc);
#define leia_interlacer_set_camera_angles_VERSION (2)
 
typedef void (*leia_interlacer_set_dovern)(struct leia_interlacer*, float dOverN);
#define leia_interlacer_set_dovern_VERSION (1)
 
typedef void (*leia_interlacer_enable_phase_correction)(struct leia_interlacer*, leia_bool enable);
#define leia_interlacer_enable_phase_correction_VERSION (1)
 
typedef void (*leia_interlacer_invert_phase_correction)(struct leia_interlacer*, leia_bool invert);
#define leia_interlacer_invert_phase_correction_VERSION (1)
 
typedef void (*leia_interlacer_enable_don_correction)(struct leia_interlacer*, leia_bool enable);
#define leia_interlacer_enable_don_correction_VERSION (1)
 
typedef void (*leia_interlacer_set_n)(struct leia_interlacer*, float n);
#define leia_interlacer_set_n_VERSION (1)
 
typedef void (*leia_interlacer_set_act_coef)(struct leia_interlacer*, float n);
#define leia_interlacer_set_act_coef_VERSION (1)
 
typedef float (*leia_interlacer_get_act_coef)(struct leia_interlacer*);
#define leia_interlacer_get_act_coef_VERSION (1)
LEIASDK_API
void leia_interlacer_set_custom_texture_matrix(struct leia_interlacer*, LEIA_CONST_FLOAT_SLICE(16) textureTransform);
 
LEIASDK_API
void leia_interlacer_set_enable_user_matrix(struct leia_interlacer* interlacer, leia_bool enabled);
LEIASDK_API
void leia_interlacer_get_user_matrix(struct leia_interlacer* interlacer, LEIA_FLOAT_SLICE(16) transformMatrix);
LEIASDK_API
void leia_interlacer_set_user_matrix(struct leia_interlacer* interlacer, LEIA_CONST_FLOAT_SLICE(16) transformMatrix);
 
LEIASDK_API
void leia_interlacer_set_alpha(struct leia_interlacer*, float alpha);
 
LEIASDK_API
void leia_interlacer_set_flip_input_uv_vertical(struct leia_interlacer*, leia_bool flip);
 
LEIASDK_API
void leia_interlacer_set_single_view_mode(struct leia_interlacer*, leia_bool setSingleView, int32_t singleViewIndex);
 
struct leia_interlacer_single_view_mode_listener {
    void* userData;
    void (*onSingleViewModeChange)(void* userData, leia_bool singleViewMode);
};
 
LEIASDK_API
void leia_interlacer_set_single_view_mode_listener(struct leia_interlacer*, struct leia_interlacer_single_view_mode_listener const* listener);
 
LEIASDK_API
void leia_interlacer_set_source_views_size(struct leia_interlacer*, int32_t sourceWidth, int32_t sourceHeight, leia_bool isHorizontalViews);
 
LEIASDK_API
void leia_interlacer_get_source_views_size(struct leia_interlacer*, int32_t* sourceWidth, int32_t* sourceHeight, leia_bool* isHorizontalViews);
 
LEIASDK_API
void leia_interlacer_set_source_media_is_video(struct leia_interlacer*, leia_bool isVideo);
 
LEIASDK_API
void leia_interlacer_set_source_media_scale(struct leia_interlacer*, float scaleX, float scaleY);
 
LEIASDK_API
void leia_interlacer_set_source_views_srgb(struct leia_interlacer*, leia_bool isSRGB);
 
LEIASDK_API
void leia_interlacer_set_in_shader_srgb_conversion(struct leia_interlacer*, leia_bool sRGBRead, leia_bool sRGBWrite);
 
LEIASDK_API
void leia_interlacer_set_viewport_screen_position(struct leia_interlacer*, int32_t posX, int32_t posY);
 
LEIASDK_API
void leia_interlacer_set_viewport(struct leia_interlacer*, int32_t posX, int32_t posY, int32_t width, int32_t height);
 
LEIASDK_API
void leia_interlacer_enable_reconvergence(struct leia_interlacer*, leia_bool enable);
 
LEIA_NODISCARD
LEIASDK_API
leia_bool leia_interlacer_is_reconvergence_enabled(struct leia_interlacer*);
 
LEIA_NODISCARD
LEIASDK_API
float leia_interlacer_get_reconvergence(struct leia_interlacer*, int layer);
 
LEIASDK_API
void leia_interlacer_set_reconvergence(struct leia_interlacer*, float value, int layer);
 
LEIASDK_API
void leia_interlacer_set_reconvergence_zoom(struct leia_interlacer*, leia_bool zoomX, leia_bool zoomXY, int layer);
 
LEIASDK_API
void leia_interlacer_set_use_atlas_for_views(struct leia_interlacer*, leia_bool);
 
LEIA_NODISCARD
LEIASDK_API
leia_bool leia_interlacer_get_use_atlas_for_views(struct leia_interlacer*);
 
LEIASDK_API
void leia_interlacer_get_view_offset(struct leia_interlacer*, int32_t view, LEIA_FLOAT_SLICE(3) offset);
 
typedef void (*leia_interlacer_initialize_gui)(struct leia_interlacer*, struct leia_interlacer_debug_menu_configuration const* config, leia_bool sRGB);
#define leia_interlacer_initialize_gui_VERSION (1)
 
typedef void (*leia_interlacer_set_gui_visibility)(struct leia_interlacer*, leia_bool isVisible);
#define leia_interlacer_set_gui_visibility_VERSION (1)
 
typedef leia_bool (*leia_interlacer_is_gui_visible)(struct leia_interlacer*);
#define leia_interlacer_is_gui_visible_VERSION (1)
 
typedef struct leia_interlacer_gui_input_state (*leia_interlacer_process_gui_input_wndproc)(
    struct leia_interlacer*, void* surface, uint32_t msg, uint64_t wparam, int64_t lparam);
#define leia_interlacer_process_gui_input_wndproc_VERSION (1)
 
struct AInputEvent;
 
typedef struct leia_interlacer_gui_input_state (*leia_interlacer_process_gui_input_ndk)(struct leia_interlacer*, struct AInputEvent const* inputEvent);
#define leia_interlacer_process_gui_input_ndk_VERSION (1)
 
typedef struct leia_interlacer_gui_input_state (*leia_interlacer_process_gui_motion_input)(struct leia_interlacer*, JNIEnv* jni, jobject motionInput);
#define leia_interlacer_process_gui_motion_input_VERSION (1)
 
typedef void (*leia_interlacer_shutdown_gui)(struct leia_interlacer*);
#define leia_interlacer_shutdown_gui_VERSION (1)
 
typedef void (*leia_interlacer_set_calibration_pattern)(struct leia_interlacer*, enum leia_calibration_pattern pattern);
#define leia_interlacer_set_calibration_pattern_VERSION (1)
 
typedef void (*leia_interlacer_set_gamma)(struct leia_interlacer*, float rGamma, float gGamma, float bGamma);
#define leia_interlacer_set_gamma_VERSION (1)
 
LEIASDK_API
void leia_interlacer_set_invert_screen_texture_coordinates(struct leia_interlacer*, leia_bool invert);
 
LEIA_NODISCARD
LEIASDK_API
enum leia_graphics_api leia_interlacer_get_graphics_api(struct leia_interlacer*);
 
LEIASDK_API
void leia_get_view_comfort_zone(enum leia_view_info_mode mode,
                                float                    baselineScaling,
                                float                    convergencePlaneDistance,
                                float                    nearPlane,
                                float                    farPlane,
                                float*                   viewComfortZoneNear,
                                float*                   viewComfortZoneFar);
 
LEIASDK_API
void leia_get_view_info(enum leia_view_info_mode mode,
                        LEIA_CONST_FLOAT_SLICE(3) viewOffset,
                        LEIA_CONST_FLOAT_SLICE(3) cameraPos,
                        LEIA_CONST_FLOAT_SLICE(3) cameraDir,
                        LEIA_CONST_FLOAT_SLICE(3) cameraUp,
                        float perspectiveFieldOfView,
                        float perspectiveAspectRatio,
                        float orthoWidth,
                        float orthoHeight,
                        float nearPlane,
                        float farPlane,
                        float convergencePlaneDistance,
                        float convergencePlaneHeight,
                        LEIA_FLOAT_SLICE(3) viewPos,
                        LEIA_FLOAT_SLICE(16) viewProjectionMatrix,
                        float* viewFieldOfView,
                        float* viewShearX,
                        float* viewShearY);
 
#pragma pack(pop)
 
END_CAPI_DECL
 
#endif // CNSDK_LEIA_CORE_INTERLACER_H