Python library for automatically splitting and writing cubemap subset images
Project description
Cubemap Splitter
Python library to split up single file cubemaps into multiple block images.
Cubemap images are typically implemented as a single image. Some applications and game engines require multiple images when setting up a cubemap. This library takes the single image and writes subset block images (top, bottom, left, right, front, back) for a variety of formats.
Installation
pip install cubemap-splitter
Numpy 1.19.4 & 64bit Python
Numpy version 1.19.3 will install alongside the package if it is not currently installed. There is a bug with 64bit Python and Numpy 1.19.4:
- https://github.com/opencv/opencv/issues/8139
- https://developercommunity.visualstudio.com/content/problem/1207405/fmod-after-an-update-to-windows-2004-is-causing-a.html
If you have Numpy 1.19.4 installed you will have to downgrade to 1.19.3. This is not an issue on 32bit Python.
Usage
from cubemap_splitter import split_cubemap
# Automatically determine format and create new directory with images at original image location
split_cubemap("C:\\Users\\paulb\\Desktop\\cubemap_formats\\cubemap.png")
# Specify format and write to user defined directory
split_cubemap("C:\\Users\\paulb\\Desktop\\cubemap_formats\\cubemap.png", format_type=1, output_directory="c:/users/paulb/new_splits")
Supported Formats
The following formats are supported. Note that the format_type = "auto" default argument will likely suffice. If the split images look incorrect, you can manually specify the format:
-
format_type = 1
-
format_type = 2
-
format_type = 3
-
format_type = 4
-
format_type = 5
Release History
- 0.1.1
- Initial Release
Meta
Paul Burgess: paulburgess1357@gmail.com
Distributed under the MIT license. See LICENSE
for more information.
https://github.com/paulburgess1357/Cubemap-Splitter/blob/master/LICENSE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cubemap_splitter-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2fc702620ec1383209e0a7ee654e317db95c2ce51101009b6700d81809d68f6f |
|
MD5 | dc989064b50b00ee1a29d26f27d632c3 |
|
BLAKE2b-256 | 23526cfc0e8df60f95ad9040680cb8e52cd52ee490367ed528e0c385b1c60a1a |