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.
- Python 3.4+ or Python 2.7+
- Pillow
- cv2 (optional for auto align)
- numpy (optional for auto align)
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:
python setup.py install
StereoscoPy --help
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
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
The Dubois anaglyph method for amber-blue glasses.
StereoscoPy -am dubois --cs amber-blue left.jpg right.jpg anaglyph_dubois_ab.jpg
Without alignment
StereoscoPy -R 400 0 -wt 400 left.jpg right.jpg simple.gif
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
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
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
Saving as an MPO file for the Nintendo 3DS.
StereoscoPy -A -R 400 240 -S 1 0 left.jpg right.jpg PY3D0001.MPO
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