Metadata-Version: 2.4
Name: stereoscopy
Version: 3.0.0
Summary: StereoscoPy, stereoscopic 3D image creator
Author-email: 2sh <contact@2sh.me>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/2sh/StereoscoPy
Project-URL: Repository, https://github.com/2sh/StereoscoPy
Project-URL: Issues, https://github.com/2sh/StereoscoPy/issues
Keywords: 3d,anaglyph,dubois,stereoscopy,wiggle-gif
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.4
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: Pillow
Requires-Dist: opencv-python
Requires-Dist: numpy
Dynamic: license-file

# 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
* Python 3.4+
* Pillow
* opencv-python
* numpy

## Installation
From the Python Package Index:
```
pip install stereoscopy
```

## 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
```

### MPO
Saving as an MPO file for the Nintendo 3DS.
```
StereoscoPy -A -R 400 240 -S 1 0 left.jpg right.jpg PY3D0001.MPO
```

### 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
```
