Metadata-Version: 2.1
Name: stereoscopy
Version: 1.2.0
Summary: StereoscoPy, stereoscopic 3D image creator
Home-page: https://github.com/2sh/StereoscoPy
Author: Seán Hewitt
Author-email: contact@2sh.me
License: UNKNOWN
Description: # StereoscoPy
        This is a Python script/library for
        converting two images into a stereoscopic 3D image:
        anaglyph,
        side-by-side (cross-eye and parallel),
        over/under,
        wiggle GIF,
        interlaced and
        checkerboard.
        
        ## Requirements
        * Python3
        * Pillow
        * cv2 (optional for auto align)
        * numpy (optional for auto align)
        
        ## Installation
        From the Python Package Index:
        ```
        pip install stereoscopy
        ```
        
        With the optional requirements for the auto align feature:
        ```
        pip install "stereoscopy[auto_align]"
        ```
        
        Or download and run:
        ```
        python3 setup.py install
        ```
        
        ## Command-Line
        ### Help
        ```
        StereoscoPy --help
        ```
        
        ### Cross-eyed (Right/Left)
        With white 5px wide border and image division. Auto aligned, resized to be 450
        pixels in width and shifted horizontally by 1 pixel.
        ```
        StereoscoPy -A -R 400 0 -S 1 0 -x --div 5 --border 5 --bg 255 255 255 0 left.jpg right.jpg cross_eye.jpg
        ```
        ![](/example_images/cross_eye.jpg?raw=true "Cross eyed")
        
        ### Anaglyph
        For red-cyan glasses, there are various methods for creating anaglyphs available.
        ```
        StereoscoPy -A -R 400 0 -S 1 0 -a left.jpg right.jpg anaglyph_wimmer.jpg
        StereoscoPy -A -R 400 0 -S 1 0 -am dubois left.jpg right.jpg anaglyph_dubois.jpg
        StereoscoPy -A -R 400 0 -S 1 0 -am gray left.jpg right.jpg anaglyph_gray.jpg
        StereoscoPy -A -R 400 0 -S 1 0 -am color left.jpg right.jpg anaglyph_color.jpg
        StereoscoPy -A -R 400 0 -S 1 0 -am half-color left.jpg right.jpg anaglyph_half_color.jpg
        ```
        ![](/example_images/anaglyph_wimmer.jpg?raw=true "Wimmer anaglyph") ![](/example_images/anaglyph_dubois.jpg?raw=true "Dubois anaglyph")
        ![](/example_images/anaglyph_gray.jpg?raw=true "Gray anaglyph") ![](/example_images/anaglyph_color.jpg?raw=true "Color anaglyph")
        ![](/example_images/anaglyph_half_color.jpg?raw=true "Half-Color anaglyph")
        
        The Dubois anaglyph method for amber-blue glasses.
        ```
        StereoscoPy -am dubois --cs amber-blue left.jpg right.jpg anaglyph_dubois_ab.jpg
        ```
        
        ### Wiggle GIF
        Without alignment
        ```
        StereoscoPy -R 400 0 -wt 400 left.jpg right.jpg simple.gif
        ```
        ![](/example_images/simple.gif?raw=true "Simple")
        
        Shifting an image moves the right image in relation to the left image. An images can be shifted after the auto align to change its center.
        ```
        StereoscoPy -A -R 400 0 -S 1 0 -wt 200 left.jpg right.jpg align_shift.gif
        ```
        ![](/example_images/align_shift.gif?raw=true "Aligned and shifted")
        
        ### Squashed Parallel (Left/Right) and Top/Bottom for TVs
        ```
        StereoscoPy -A -R 400 0 -S 1 0 -ps left.jpg right.jpg tv_left_right.jpg
        StereoscoPy -A -R 400 0 -S 1 0 -os left.jpg right.jpg tv_over_under.jpg
        ```
        ![](/example_images/tv_left_right.jpg?raw=true "Top/Bottom") ![](/example_images/tv_over_under.jpg?raw=true "Left/Right")
        
        ### Two separate image outputs
        Before converting to the stereoscopic outputs, I find this (or a slow wiggle GIF) to be a nice way to check for the correct dimensions, shift and rotation by switching between the two output images in an image viewer.
        ```
        StereoscoPy --shift 19 30 --crop 20% 0 0 0 --resize 1920 1080 --offset 100% --parallel left.jpg right.jpg out1.jpg out2.jpg
        ```
        
        ### Misc
        20% cropped from the top, resized to 1920x1080 and offset to the right by 100%.
        ```
        StereoscoPy --crop 20% 0 0 0 --resize 1920 1080 --offset 100% --cross-eye left.jpg right.jpg out.jpg
        StereoscoPy -C 20% 0 0 0 -R 1920 1080 -O 100% -x left.jpg right.jpg out.jpg
        ```
        
        20% cropped from left and right and resized to be 1080 high and 0 width to preserve the aspect ratio.
        ```
        StereoscoPy -R 0 1080 -C 0 20% 0 20% -o left.jpg right.jpg out.jpg
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3
Description-Content-Type: text/markdown
Provides-Extra: auto_align
