Erases texture seams to prevent visible seams and tearing in geometry images. Release copy including a web service.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
SeamErasure Updated ignore Dec 12, 2017
static Updated ignore Dec 12, 2017
templates Renamed minimize.* to erase.* Nov 17, 2017
.gitignore Updated ignore Dec 12, 2017
LICENSE Initial commit Jun 5, 2017
README.md Updated README to describe server.py Nov 30, 2017
server.py Renamed minimize.* to erase.* Nov 17, 2017

README.md

Seam Erasure

http://cragl.cs.gmu.edu/seamless

Erases texture seams to prevent visible seams or tearing in various texture maps (color, normal, displacement, ambient occlusion, etc.).

Overview

Seams of textures often produce errors when bi-linearly interpolated. This results in a visible seam line or other undesired artifacts. The goal of this project is to devise a numerical solution to this problem by minimizing the energy/error between edge pairs.

This repository contains a release candidate for the development version found here. See the Seam-Erasure-Dev repository for the latest and experimental developments.

Dependencies

This repository is designed for Python 2, but it should be compatible with Python 3 as well.

Python libraries: (sudo pip[3] install <package-name>)

  • recordclass: simple data objects
  • scipy: sparse matrix operations
  • numpy: linear algebra
  • pillow: saving/loading texture image files

Installation

Install for Python 2.x/3.x:

sudo apt-get install python[3]-dev python[3]-pip
sudo -H pip[3] install numpy scipy pillow recordclass

Usage

Command-Line

To use the seam eraser tool, first install the required packages, then enter the following into a command-line:

python ./src/main.py path/to/input_model path/to/input_texture [-h] [-o path/to/output_texture] [-g] [--sv {none,texture,lerp}] [-d]

Positional arguments:

  • path/to/input_model: Path to input mesh file.
  • path/to/input_texture: Path to input texture image or directory to load all textures from.

Optional arguments:

  • -h, --help: Show this help message and exit
  • -o path/to/output_texture, --output path/to/output_texture: Name of output texture or directory to save batch textures.
  • -g, --global: Should the minimization have global effects? (default: False)
    • This should be used if the texture has global discontinies. This will propogate changes from the seam inward. See the teaser image for a example of global discontinties (the texture is a gradient image).
  • --sv {none,texture,lerp}What method should be used to compute the seam value energy? None implies do not use seam value. Texture implies use difference in originial texture. Lerp implies use linearly interpolated values along the edge. (default: none)
  • -d, --data: Should the input texture(s) be loaded as data files? (default: False)

Files

  • server.py: Flask based Python code for handling web inputs.
  • SeamErasure/: Python package for Seam-Erasure
    • SeamErasure/main.py: Command-line interface for seam erasure.
  • static/: Static web page content including style sheets
  • templates/: HTML template pages

Web Browser UI

This repository also includes a Flask based server implementation that can be run locally. This provides a simple webpage interface to provide model/texture input and select options. To get this user interface run:

python server.py

This will start a server on the localhost. Navigate to the outputted address in your choice of web browser to view the interface.

Results

Diffuse Textures

Before After

Normal Maps

Before After

Ambient Occlusion

Before After

Geometry Images

Before After