monado/src/xrt/auxiliary/util/u_distortion_mesh.h

81 lines
1.7 KiB
C
Raw Normal View History

// Copyright 2019, Collabora, Ltd.
// SPDX-License-Identifier: BSL-1.0
/*!
* @file
* @brief Code to generate disortion meshes.
* @author Jakob Bornecrantz <jakob@collabora.com>
* @ingroup aux_util
*/
#pragma once
#include "xrt/xrt_device.h"
#include "xrt/xrt_defines.h"
#ifdef __cplusplus
extern "C" {
#endif
/*!
* Values to create a distortion mesh from panotools values.
*
* @ingroup aux_util
*/
struct u_panotools_values
{
//! Panotools universal distortion k (reverse order from OpenHMD).
float distortion_k[5];
//! Panotools post distortion scale, <r, g, b>.
float aberration_k[3];
//! Panotools warp scale.
float scale;
//! Center of the lens.
struct xrt_vec2 lens_center;
//! Viewport size.
struct xrt_vec2 viewport_size;
};
/*!
* Callback used when generating a distortion mesh.
*
* @ingroup aux_util
*/
typedef void (*u_distortion_mesh_func)(
int view, float x, float y, float result[8], void *user_ptr);
/*!
* Given a callback and a user_ptr generates num_views meshes.
*
* @ingroup aux_util
*/
void
u_distortion_mesh_from_func(u_distortion_mesh_func func,
void *user_ptr,
int num_views,
struct xrt_hmd_parts *target);
/*!
* Given two sets of panotools values creates the left and th right uv meshes.
*
* @ingroup aux_util
*/
void
u_distortion_mesh_from_panotools(const struct u_panotools_values *left,
const struct u_panotools_values *right,
struct xrt_hmd_parts *target);
/*!
* Create two distortion meshes with no distortion.
*
* @ingroup aux_util
*/
void
u_distortion_mesh_none(struct xrt_hmd_parts *target);
#ifdef __cplusplus
}
#endif