Editing FocalBlur (section)

==Description==

This script creates fancy figures by introducing a focal blur to the image. The object at the origin will be in focus. 

===Usage===

Load the script using the [[run]] command. Execute the script using PyMOL syntax:
<source lang="python">
FocalBlur aperture=2.0,samples=20,ray=1
</source>
or using python syntax:
<source lang="python">
FocalBlur(aperture=2.0,samples=20,ray=1)
</source>


For additional options, see the script comments.

===Notes===

* When using raytracing, the image creation will take ''n'' times longer than normal, where ''n'' is the number of samples.
* The aperture is related to the aperture on a camera, and is inversely proportional to the f-number.

===Bugs===

* FocalBlur uses the Python Image Library (PIL), a necessary components of PIL is missing in the Windows version of PyMOL
* There is a bug when not using ray tracing with the free version of PyMOL

===Examples===

<gallery perrow=3 widths=300 heights=240>
Image:FocalBlur_a1.0_r1.png|FocalBlur aperture=1,samples=100,ray=1
Image:FocalBlur_a2.0_r1.png|FocalBlur aperture=2,samples=100,ray=1
Image:FocalBlur_a4.0_r1.png|FocalBlur aperture=4,samples=400,ray=1
Image:FocalBlur_a4.0_r0.png|FocalBlur aperture=4,samples=400,ray=0
Image:Focal_blur _ex6.png
Image:Focal blur_ex_ap3.png
Image:Focal blur_ex_ap3_mode1.png
Image:Focal blur_ex_ap3_mode2.png
Image:Focal blur_ex_ap3_mode3.png
</gallery>