133 lines
4.2 KiB
C++
133 lines
4.2 KiB
C++
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_sys_types.h" /* for intptr_t support */
|
|
|
|
/** \file
|
|
* \ingroup geo
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct ParamHandle ParamHandle; /* Handle to an array of charts. */
|
|
typedef uintptr_t ParamKey; /* Key (hash) for identifying verts and faces. */
|
|
#define PARAM_KEY_MAX UINTPTR_MAX
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Chart Construction:
|
|
*
|
|
* Faces and seams may only be added between #GEO_uv_parametrizer_construct_begin and
|
|
* #GEO_uv_parametrizer_construct_end.
|
|
*
|
|
* The pointers to `co` and `uv` are stored, rather than being copied. Vertices are implicitly
|
|
* created.
|
|
*
|
|
* In #GEO_uv_parametrizer_construct_end the mesh will be split up according to the seams. The
|
|
* resulting charts must be manifold, connected and open (at least one boundary loop). The output
|
|
* will be written to the `uv` pointers.
|
|
*
|
|
* \{ */
|
|
|
|
ParamHandle *GEO_uv_parametrizer_construct_begin(void);
|
|
|
|
void GEO_uv_parametrizer_aspect_ratio(ParamHandle *handle, float aspx, float aspy);
|
|
|
|
void GEO_uv_prepare_pin_index(ParamHandle *handle, const int bmvertindex, const float uv[2]);
|
|
|
|
ParamKey GEO_uv_find_pin_index(ParamHandle *handle, const int bmvertindex, const float uv[2]);
|
|
|
|
void GEO_uv_parametrizer_face_add(ParamHandle *handle,
|
|
const ParamKey key,
|
|
const int nverts,
|
|
const ParamKey *vkeys,
|
|
const float **co,
|
|
float **uv, /* Output will eventually be written to `uv`. */
|
|
const bool *pin,
|
|
const bool *select);
|
|
|
|
void GEO_uv_parametrizer_edge_set_seam(ParamHandle *handle, ParamKey *vkeys);
|
|
|
|
void GEO_uv_parametrizer_construct_end(ParamHandle *handle,
|
|
bool fill,
|
|
bool topology_from_uvs,
|
|
int *count_fail);
|
|
void GEO_uv_parametrizer_delete(ParamHandle *handle);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Least Squares Conformal Maps:
|
|
*
|
|
* Charts with less than two pinned vertices are assigned two pins. LSCM is divided to three steps:
|
|
*
|
|
* 1. Begin: compute matrix and its factorization (expensive).
|
|
* 2. Solve using pinned coordinates (cheap).
|
|
* 3. End: clean up.
|
|
*
|
|
* UV coordinates are allowed to change within begin/end, for quick re-solving.
|
|
*
|
|
* \{ */
|
|
|
|
void GEO_uv_parametrizer_lscm_begin(ParamHandle *handle, bool live, bool abf);
|
|
void GEO_uv_parametrizer_lscm_solve(ParamHandle *handle, int *count_changed, int *count_failed);
|
|
void GEO_uv_parametrizer_lscm_end(ParamHandle *handle);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Stretch
|
|
* \{ */
|
|
|
|
void GEO_uv_parametrizer_stretch_begin(ParamHandle *handle);
|
|
void GEO_uv_parametrizer_stretch_blend(ParamHandle *handle, float blend);
|
|
void GEO_uv_parametrizer_stretch_iter(ParamHandle *handle);
|
|
void GEO_uv_parametrizer_stretch_end(ParamHandle *handle);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Packing
|
|
* \{ */
|
|
|
|
void GEO_uv_parametrizer_pack(ParamHandle *handle,
|
|
float margin,
|
|
bool do_rotate,
|
|
bool ignore_pinned);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Average area for all charts
|
|
* \{ */
|
|
|
|
void GEO_uv_parametrizer_average(ParamHandle *handle,
|
|
bool ignore_pinned,
|
|
bool scale_uv,
|
|
bool shear);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Simple x,y scale
|
|
* \{ */
|
|
|
|
void GEO_uv_parametrizer_scale(ParamHandle *handle, float x, float y);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Flushing
|
|
* \{ */
|
|
|
|
void GEO_uv_parametrizer_flush(ParamHandle *handle);
|
|
void GEO_uv_parametrizer_flush_restore(ParamHandle *handle);
|
|
|
|
/** \} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|