open3d::t::geometry::kernel::uvunwrapping Namespace Reference

Functions
std::tuple< float, int, int >	ComputeUVAtlas (TriangleMesh &mesh, const size_t width, const size_t height, const float gutter, const float max_stretch, int parallel_partitions, int nthreads)

Function Documentation

ComputeUVAtlas()

std::tuple< float, int, int > open3d::t::geometry::kernel::uvunwrapping::ComputeUVAtlas	(	TriangleMesh &	mesh,
		const size_t	width = 512,
		const size_t	height = 512,
		const float	gutter = 1.0f,
		const float	max_stretch = 1.f/6,
		int	parallel_partitions = 1,
		int	nthreads = 0
	)

Creates an UV atlas and adds it as triangle attr 'texture_uvs' to the mesh.

Input meshes must be manifold for this method to work.

The algorithm is based on:

• Zhou et al, "Iso-charts: Stretch-driven Mesh Parameterization using Spectral Analysis", Eurographics Symposium on Geometry Processing (2004)
• Sander et al. "Signal-Specialized Parametrization" Europgraphics 2002

Parameters

mesh	Input and output mesh.
width	The target width of the texture. The uv coordinates will still be in the range [0..1] but parameters like gutter use pixels as units.
height	The target height of the texture.
gutter	This is the space around the uv islands in pixels.
max_stretch	The maximum amount of stretching allowed. The parameter range is [0..1] with 0 meaning no stretch allowed.
max_stretch_out	Output parameter returning the actual maximum amount of stretch.
num_charts_out	Output parameter with the number of charts created.
parallel_partitions	The approximate number of partitions created before computing the UV atlas for parallelizing the computation. Parallelization can be enabled with values > 1. Note that parallelization increases the number of UV islands and can lead to results with lower quality.
nthreads	The number of threads used when parallel_partitions is > 1. Set to 0 for automatic number of thread detection.

Returns

Tuple with (max stretch, num_charts, num_partitions) storing the actual amount of stretch, the number of created charts, and the number of parallel partitions created.