Stereo ray: Difference between revisions

From PyMOLWiki
Jump to navigation Jump to search
No edit summary
 
(some rearrangements)
 
(11 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Image:Stereo_ex_l.png|Left Image|200px|thumb|left]]
{{Infobox script-repo
[[Image:Stereo_ex_r.png|Right Image|200px|thumb|right]]
|type      = script
[[Image:Stereo_complete.png|Combined Images|center|thumb|250px]]
|filename  = stereo_ray.py
|author    = [[User:Inchoate|Jason Vertrees]]
|license  = -
}}


This scripts provides the [[stereo_ray]] command, which saves two ray traced images in PNG format.
The left image is rotated +3 degrees and the right image is rotated -3 degrees.


''Note that the end result is almost identical to using "walleye" [[stereo]] mode, which might be more convenient and is readily available in PyMOL.''


== Usage ==


stereo_ray filename [, width [, height ]]


== Example ==


<syntaxhighlight lang="python">
import stereo_ray
stereo_ray output, 1000, 600
</syntaxhighlight>


This will create two images, "output_l.png" and "output_r.png". Just paste the two images next to each other (in some image editing program) and you're done.


A user on the PyMol list wrote a very nice little stereo ray tracing script. Just copy this to a text file.  Then, in PyMol run
[[Image:Stereo_ex_l.png|Left Image|200px|thumb|left]]
run dirName/scriptName.pym
[[Image:Stereo_ex_r.png|Right Image|200px|thumb|right]]
where '''dirName''' is where you put it, and '''scriptName''' is what you named the file then run one something like the example lines given:
[[Image:Stereo_complete.png|Combined Images|center|thumb|250px]]
<source lang="python">
<br clear="all" />
EXAMPLE
  stereo_ray output, 1000, 600
  stereo_ray secondImage.png
</source>
This will create to images, one with an L and one with an R suffix.  Just paste the two images next to each other (in some image editing program) and you're done.
 
<source lang="python">
from pymol import cmd
 
def stereo_ray(output='', width='', height=''):
  '''
DESCRIPTION
  "stereo_ray" ray-traces the current scene twice (separated by
  a six-degree rotation around the y axis)
  and saves a pair of images that can be combined in any image
  manipulation software to form a stereoimage.
  The first argument, the output file name, is mandatory.
  The second and third arguments, the size of the image, are not.
  If the width is given, the height will be calculated.


USAGE
== Manually ==
  stereo_ray filename [, width [, height]]


EXAMPLE
To obtain the same result without the script, use the [[ray]] and the [[png]] command like this:
  stereo_ray output, 1000, 600
  stereo_ray secondImage.png
  '''


  if output == '':
ray angle=+3
      print 'no output filename defined\n'
png left-image.png
      print 'try: \'stereo_ray filename\''
ray angle=-3
      return -1
png right-image.png
      # abort if no output file name given


  if width == '':
Obtain almost the same result using the [[stereo]] command:
      width,height = cmd.get_session()['main'][0:2]
      # get dimensions from viewer if not given


  elif height == '':
stereo walleye
      oldWidth,oldHeight = cmd.get_session()['main'][0:2]
png combined.png, ray=1
      height = int(width)*oldHeight/oldWidth
      # calculate height from proportions of viewer if
      # only width is given


  cmd.ray(width, height, angle=-3)
== See Also ==
  cmd.png(output+"_r")
  cmd.ray(width, height, angle=3)
  cmd.png(output+"_l")


cmd.extend('stereo_ray',stereo_ray)
* [[stereo]]
</source>
* [[Stereo_Mode|stereo_mode]]


[[Category:Script_Library|Stereo Ray]]
[[Category:Script_Library|Stereo Ray]]
[[Category:UI_Scripts]]
[[Category:Pymol-script-repo]]
[[Category:Stereo]]

Latest revision as of 10:49, 31 May 2012

Type Python Script
Download stereo_ray.py
Author(s) Jason Vertrees
License -
This code has been put under version control in the project Pymol-script-repo

This scripts provides the stereo_ray command, which saves two ray traced images in PNG format. The left image is rotated +3 degrees and the right image is rotated -3 degrees.

Note that the end result is almost identical to using "walleye" stereo mode, which might be more convenient and is readily available in PyMOL.

Usage

stereo_ray filename [, width [, height ]]

Example

import stereo_ray 
stereo_ray output, 1000, 600

This will create two images, "output_l.png" and "output_r.png". Just paste the two images next to each other (in some image editing program) and you're done.

Left Image
Right Image
Combined Images


Manually

To obtain the same result without the script, use the ray and the png command like this: 

ray angle=+3
png left-image.png
ray angle=-3
png right-image.png

Obtain almost the same result using the stereo command: 

stereo walleye
png combined.png, ray=1

See Also

Retrieved from "https://pymolwiki.org/index.php?title=Stereo_ray&oldid=10662"