Editing Ray (section)

==Settings==
===Modes===
Setting the '''[[Ray_trace_mode]]''' variable in PyMOL changes the way PyMOL's internal renderer represents proteins in the final output.  New modes were recently added to give the user more options of molecular representation.  New modes are: normal rendering, but with a black outline (nice for presentations); black and white only; quantized color with black outline (also, very nice for presentations; more of a ''cartoony'' appearance).  

'''Note:''' Mode 3, the quantized color one, sort of '''burns''' the background if you're using this setting.  This will make a pure white background somewhat "offwhite"; thus, a poster would look poor because you could see the border for the image.  If you'll be using this mode, try the [[ray_opaque_background]] setting.

<source lang="python">
# normal color
set ray_trace_mode, 0

# normal color + black outline
set ray_trace_mode,  1

# black outline only
set ray_trace_mode,  2

# quantized color + black outline
set ray_trace_mode,  3

set ray_trace_mode, 1 # (or 2 or 3; best with "bg_color white;set antialias,2")
# These two new modes -- 2 and 3 -- are cool cartoon looking modes.

# change the color of the outline to a named color, or a hex-code
set ray_trace_color, magenta
set ray_trace_color, 0x0033ff
</source>

Here are the example images for the new modes
<gallery>
Image:Ray_mode_1_ex.png|set ray_trace_mode,1
Image:Ray_mode_2_ex.png|set ray_trace_mode,2
Image:Ray_mode_3_ex.png|set ray_trace_mode,3
</gallery>

The '''[[ray_trace_mode]]''' setting adds outlines to objects by detecting local changes in depth by surrounding pixels. However, since transparent objects do not typically affect the scene's depth information, they may not be outlined by default. You can control which objects receive an outline by adjusting '''[[ray_trace_trans_cutoff]]'''. This setting determines the minimum opacity an object must have to be included in ray-tracing outlining.

For example, if you want to omit outlining for objects below an opacity of 95% (5% transparency):
  set ray_trace_trans_cutoff, 0.05  # default

===Perspective===
====Perspective Example Images====
<gallery>
Image:No_persp.png|Example with Perspective Turned Off
Image:Persp1.png|Example with Perspective Turned On
Image:Persp2.png|Example with Perspective Turned On and Field of View Set High (70).
</gallery>

=====Notes=====
PyMol 0.97 and prior used '''orthoscopic''' rendering -- that is, no perspective.  Upon the arrival of 0.98 and later, we get perspective based rendering at a cost of a 4x decrease in render speed.  If you want perspective
 set orthoscopic, off
Otherwise
 set orthoscopic, on
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===
'''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 "povray" in your path.  It utilizes two temporary files: "tmp_pymol.pov" and "tmp_pymol.png". Also works on Mac via Povray37UnofficialMacCmd but it needs to be in your path as "povray".