Difference between revisions of "Ray"

From PyMOLWiki
Jump to navigation Jump to search
Line 1: Line 1:
 
===DESCRIPTION===
 
===DESCRIPTION===
+
"ray" creates a ray-traced image of the current frame. This can take some time (up to several minutes, depending on image complexity).
  "ray" creates a ray-traced image of the current frame. This
+
 
  can take some time (up to several minutes, depending on image
 
  complexity).
 
 
 
===USAGE===
 
===USAGE===
   
+
  ray [width,height [,renderer [,angle [,shift ]]]  
  ray [width,height [,renderer [,angle [,shift ]]]
+
angle and shift can be used to generate matched stereo pairs
+
 
  angle and shift can be used to generate matched stereo pairs
 
 
 
 
===EXAMPLES===
 
===EXAMPLES===
   
+
  ray
  ray
+
ray 1024,768
  ray 1024,768
+
ray renderer=0
  ray renderer=0
+
 
 
 
===PYMOL API===
 
===PYMOL API===
 
<source lang="python">  
 
<source lang="python">  
  cmd.ray(int width,int height,int renderer=-1,float shift=0)
+
cmd.ray(int width,int height,int renderer=-1,float shift=0)
 
</source>
 
</source>
  
===NOTES
+
===NOTES===
 +
To magnify the effect of perspective on the scene,
 +
set field_of_view, X
 +
where 50<X<70.  Default is 20.  50-70 gives a very strong perspective effect.  Nb. the field of view is in Y, not X as one would expect.
 
   
 
   
  renderer = -1 is default (use value in ray_default_renderer)
+
renderer = -1 is default (use value in ray_default_renderer)
  renderer =  0 uses PyMOL's internal renderer
+
renderer =  0 uses PyMOL's internal renderer
  renderer =  1 uses PovRay's renderer.  This is Unix-only
+
renderer =  1 uses PovRay's renderer.  This is Unix-only and you must have "x-povray" in your path.  It utilizes two temporary files: "tmp_pymol.pov" and "tmp_pymol.png".
      and you must have "x-povray" in your path.  It utilizes two
 
      two temporary files: "tmp_pymol.pov" and "tmp_pymol.png".
 
 
   
 
   
 
===SEE ALSO===
 
===SEE ALSO===
+
"help faster" for optimization tips with the builtin renderer. "help povray" for how to use PovRay instead of PyMOL's built-in    ray-tracing engine.  
  "help faster" for optimization tips with the builtin renderer.
 
  "help povray" for how to use PovRay instead of PyMOL's built-in
 
   ray-tracing engine.  
 
  
 
==USER Comments==
 
==USER Comments==

Revision as of 12:11, 30 May 2005

DESCRIPTION

"ray" creates a ray-traced image of the current frame. This can take some time (up to several minutes, depending on image complexity).

USAGE

ray [width,height [,renderer [,angle [,shift ]]] 

angle and shift can be used to generate matched stereo pairs

EXAMPLES

ray
ray 1024,768
ray renderer=0

PYMOL API

 
 cmd.ray(int width,int height,int renderer=-1,float shift=0)

NOTES

To magnify the effect of perspective on the scene,

set field_of_view, X

where 50<X<70. Default is 20. 50-70 gives a very strong perspective effect. Nb. the field of view is in Y, not X as one would expect.

renderer = -1 is default (use value in ray_default_renderer) renderer = 0 uses PyMOL's internal renderer renderer = 1 uses PovRay's renderer. This is Unix-only and you must have "x-povray" in your path. It utilizes two temporary files: "tmp_pymol.pov" and "tmp_pymol.png".

SEE ALSO

"help faster" for optimization tips with the builtin renderer. "help povray" for how to use PovRay instead of PyMOL's built-in ray-tracing engine.

USER Comments

How do I ray trace a publication-ready (~300dpi) image using PyMol?

This answer is in the Advanced Issues (Image Manipulation Section).