How to build UVAtlas on Linux?

You can build UVAtlas on Windows Subsystem for Linux using GCC 11 or later with CMake 3.21+, but it's primarily designed for Windows and may have limited functionality outside that environment. Refer to the README for specific WSL setup instructions and compatibility notes.

What mesh formats does UVAtlas support?

UVAtlas supports formats like SDKMesh, SDKMesh2, CMO, VBO, and OBJ through its command-line tool, as shown in the release notes table. However, support for newer or custom formats may require additional work due to the library's archived status.

UVAtlas vs MeshLab for texture atlas generation?

UVAtlas excels in minimal-distortion isocharting with spectral analysis, ideal for DirectX pipelines, while MeshLab offers a broader set of mesh processing tools with cross-platform GUI support. For new projects, MeshLab might be better due to active maintenance, but UVAtlas is stronger for Windows-centric, research-backed parameterization.

How to minimize texture distortion with UVAtlas?

Use UVAtlas' signal-specialized parametrization to compute IMT from vertex or texture signals, which optimizes for low stretch. The library's isochart partitioning focuses on spectral analysis to reduce distortion, as detailed in the key features and research papers linked in the README.

Is UVAtlas suitable for real-time game engines?

UVAtlas is best for offline mesh processing in graphics pipelines, such as pre-processing assets, due to its computational intensity and archived nature. For real-time parameterization during gameplay, consider lighter, actively maintained libraries integrated into game engines like Unity or Unreal.

How to handle breaking changes in UVAtlas updates?

Recent releases introduced breaking changes like typed enum flags, requiring code updates such as using UVATLAS_DEFAULT instead of 0. Always check the CHANGELOG.md for migration guides and test thoroughly, as the project's archived status means fewer fixes or support.

Open-Awesome

UVAtlas

MITC++oct2025

A shared-source library for creating and packing isochart texture atlases for 3D mesh parameterization.

Visit Website GitHub

924 stars157 forks0 contributors

What is UVAtlas?

UVAtlas is a shared-source library for creating isochart texture atlases, which are used to parameterize 3D meshes for texture mapping. It partitions meshes into charts with minimal stretch distortion and packs them into a texture atlas, optimizing for graphics rendering. The library implements research from Microsoft on stretch-driven mesh parameterization using spectral analysis.

Target Audience

Graphics programmers, game developers, and researchers working on 3D mesh processing, texture mapping, or real-time rendering pipelines, particularly those using DirectX or Windows-based development environments.

Value Proposition

Developers choose UVAtlas for its implementation of proven academic research (isocharting) that minimizes texture distortion, its integration with Windows graphics toolchains, and its availability as a shared-source alternative to proprietary mesh parameterization tools.

Overview

UVAtlas isochart texture atlas

Use Cases

Best For

Generating low-distortion texture atlases for game assets
Parameterizing complex 3D meshes for real-time rendering
Integrating mesh processing into DirectX-based graphics pipelines
Researching or implementing spectral analysis for mesh parameterization
Processing legacy mesh files with command-line tools
Optimizing texture space utilization for 3D models

Not Ideal For

New projects requiring actively maintained and updated mesh processing libraries
Cross-platform development on macOS or Linux without Windows Subsystem for Linux
Real-time applications needing on-the-fly mesh parameterization during gameplay
Teams seeking modern, community-supported alternatives with extensive documentation

Pros & Cons

Pros

Research-Backed Algorithm

Implements spectral analysis-based isocharting from Microsoft Research, proven to minimize texture stretch distortion for high-quality mapping, as cited in the README.

Windows Toolchain Integration

Designed for Visual Studio, Windows SDK, and DirectX, making it a seamless fit for Windows-based graphics pipelines without legacy DirectX SDK dependencies.

Flexible Signal Processing

Computes IMT from vertex, texture, and per-texel signals, allowing optimization for diverse texture mapping scenarios, as detailed in the key features.

Command-Line Batch Processing

Includes UVAtlasTool for direct mesh file processing, supporting formats like SDKMesh and OBJ, which aids in automation and integration into build pipelines.

Cons

Archived Project Status

Explicitly marked as archived and not recommended for new projects, meaning no new features, updates, or active support, limiting its future viability.

Complex Build Requirements

Requires specific versions of Visual Studio, CMake 3.21+, and Windows SDK, with noted breaking changes like typed enum flags, complicating setup and migration.

Limited Cross-Platform Support

Primarily Windows-focused; while it can build on WSL with GCC, native Linux or macOS support is lacking, hindering broader adoption.

Sparse Documentation

Documentation is hosted on a GitHub wiki and may be incomplete or outdated for a legacy project, making it harder for new users to troubleshoot.

Frequently Asked Questions

Related Projects

C/C++

A curated list of awesome C++ (or C) frameworks, libraries, resources, and shiny things. Inspired by awesome-... stuff.

Stars71,971

Forks8,301

Last commit27 days ago

ProtoBuf

Protocol Buffers - Google's data interchange format

Last commit4 days ago

Blazor

ASP.NET Core is a cross-platform .NET framework for building modern cloud-based web applications on Windows, Mac, or Linux.

Stars38,146

Forks10,716

Last commit2 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub