Metadata-Version: 2.1
Name: cube2sphere
Version: 0.2.0
Summary: Utility to map 6 cube (cubemap, skybox) faces into an equirectangular (cylindrical projection, skysphere) map
Home-page: http://github.com/Xyene/cube2sphere
Author: Tudor Brindus
Author-email: me@tbrindus.ca
License: UNKNOWN
Description: cube2sphere [![PyPI version](https://badge.fury.io/py/cube2sphere.svg)](https://pypi.python.org/pypi/cube2sphere) [![PyPI](https://img.shields.io/pypi/pyversions/cube2sphere.svg)](https://pypi.python.org/pypi/cube2sphere)
        ===========
        
        `cube2sphere` is a Python script to map 6 cube (cubemap, skybox) faces
        into an equirectangular (cylindrical projection, skysphere) map. See
        also [sphere2cube](https://github.com/Xyene/sphere2cube).
        
        Usage
        =====
        
            $ cube2sphere -h
            usage: cube2sphere [-h] [-v] [-r <width> <height>] [-R <rx> <ry> <rz>]
                           [-o <path>] [-f <name>] [-b <path>] [-t <count>] [-V]
                           <front> <back> <right> <left> <top> <bottom>
        
            Maps 6 cube (cubemap, skybox) faces into an equirectangular (cylindrical
            projection, skysphere) map.
        
            positional arguments:
              <front>               source front cube face filename
              <back>                source back cube face filename
              <right>               source right cube face filename
              <left>                source left cube face filename
              <top>                 source top cube face filename
              <bottom>              source bottom cube face filename
        
            optional arguments:
              -h, --help            show this help message and exit
              -v, --version         show program's version number and exit
              -r <width> <height>, --resolution <width> <height>
                                    resolution for rendered map (defaults to 1024x512)
              -R <rx> <ry> <rz>, --rotation <rx> <ry> <rz>
                                    rotation in degrees to apply before rendering map (z
                                    is up)
              -o <path>, --output <path>
                                    filename for rendered map (defaults to "out")
              -f <name>, --format <name>
                                    format to use when saving map, i.e. "PNG" or "TGA"
              -b <path>, --blender-path <path>
                                    filename of the Blender executable (defaults to
                                    "blender")
              -t <count>, --threads <count>
                                    number of threads to use when rendering (1-64)
              -V, --verbose         enable verbose logging
        
        Supported output formats depend on the Blender installation, but will
        generally include TGA, IRIS, JPEG, MOVIE, IRIZ, RAWTGA, AVIRAW, AVIJPEG,
        PNG, BMP, and FRAMESERVER.
        
        `cube2sphere` can be run in a headless environment (e.g., a server).
        
        Examples
        ========
        
        If we wanted to stitch 6 cube faces named `${face}.jpg` into a 2048x1024
        TGA equirectangular map, we could use the following command:
        
            $ cube2sphere front.jpg back.jpg right.jpg left.jpg top.jpg bottom.jpg -r 2048 1024 -fTGA -ostitched
        
        This would generate `stitched.tga` in the working directory.
        
        Installation
        ============
        
        `cube2sphere` can be easily installed with `pip`. It requires a Python 3
        installation.
        
        It assumes that Blender is installed and the `blender` executable is
        listed in the system PATH environment variab
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Artistic Software
Description-Content-Type: text/markdown
