kuboshizuma / UVTextureConverter

To convert atlas texuture (defined in Densepose) to normal texture (defined in SMPL), and vice versa.

UVTextureConverter

This library is converter to convert atlas texuture (defined in Densepose) to normal texture (defined in SMPL), and vice versa.

1. Install

$ pip install UVTextureConverter
(or $ pip install uvtextureconverter)

2. How To Use

2.1. Quick Use

nomal texture -> atlas texture

from UVTextureConverter import Normal2Atlas
from PIL import Image
import numpy as np

normal_tex = np.array(Image.open('input/normal.jpg'))
converter = Normal2Atlas(normal_size=512, atlas_size=200)
atlas_tex = converter.convert(normal_tex)

atlas texture -> normal texture

from UVTextureConverter import Atlas2Normal
from PIL import Image
import numpy as np

im = np.array(Image.open('input/atlas.png').convert('RGB')).transpose(1, 0, 2)
atlas_tex_stack = Atlas2Normal.split_atlas_tex(im)
converter = Atlas2Normal(atlas_size=200, normal_size=512)
normal_tex = converter.convert(atlas_tex_stack)

2.2. Notebooks (for details and examples)

See the following notebooks for details and examples.

• convert_texture_between_normal_and_altas.ipynb: how to convert from atlas texture to normal texture, and vice versa.
• create_uv_texture_from_image_by_using_densepose.ipynb: how to convert a single rgb image to atlas texute by densepose and convert to normal texture.
• create_uv_texture_from_video_by_using_densepose.ipynb: how to convert video to atlas texture.

3. developers install

3.1. docker build & run

$ docker-compose build
$ docker-compose run --rm uvtex

3.2. notebook usage

$ export UVTEX_PORT=8888
$ docker-compose run --rm -p $UVTEX_PORT:$UVTEX_PORT uvtex jupyter notebook --port $UVTEX_PORT --ip=0.0.0.0 --allow-root

3.3. flake8 & test

$ docker-compose run --rm uvtex
(in docker)
$ flake8
$ python -m unittest