retexture 0.1.0

ReTexture dataset toolkit for generation and analysis

retexture

using blender to augment 3d model textures

Installation

1. clone the repo (more instructions later)
2. pip install -r requirements.txt

Installing blender

• MacOS: brew install blender
• Unix: apt-get install blender

Install via script

see ./install.sh

Dataset Setup

place all models in datasets/models and place textures in datasets/textures like so:

datasets
├── models
│   ├── bird1.dae
│   ├── bird_duck.dae
│   ├── bird_duck2.dae
│   ├── bird_eagle.dae
│   ├── bird_raven.dae
│   ├── butterfly.dae
│   ├── butterfly1.dae
│   ...
├── datasets/textures
│   ├── _fish_bass
│   │   ├── Sketchy_Lines_Wavy_45_A.jpg
│   │   ├── __Chalk_1.jpg
│   │   ├── __Sketchy_Scales_1.jpg
│   │   ├── __Wavy_Lines_45deg_A_1.jpg
│   │   ├── material_1.jpg
│   │   ├── material_2.jpg
│   │   ├── material_3.jpg
│   │   └── material_5.jpg
│   ├── bird_duck
│   │   └── mallard_male1.jpg
│   ├── bird_duck2
│   │   └── Color_000.JPG
│   ...

Run

./run.sh

TODO:

• ./run.sh <config>

NOTES

gpu rendering does not work (easily)

• in the current state, a black image is created
• blender provides lower level gpu support... see docs

external libraries arediscouraged

• blender uses its own python distro & environment
• used sys.path.insert as a workaround
• custom packages do not work with blender (TBD)

argparse conflicts with blender commandline arguments

• hydra also conflicts
• might be better to nix the configurations or read statically from a config.yaml

memory required increases with job runtime

• maybe blender keeps a history of all operations?
• consider splitting jobs into batches

Problems

• bounding box centering doesnt work