Difference between revisions of "Zoom"

From PyMOLWiki
Jump to: navigation, search
 
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
===DESCRIPTION===
+
 
    "zoom" scales and translates the window and the origin to cover the
+
'''zoom''' scales and translates the window and the origin to cover the atom selection.
  atom selection.
+
 
 
 
 
===USAGE===
 
===USAGE===
    zoom [ selection [,buffer [, state [, complete ]]]]
+
zoom [ selection [,buffer [, state [, complete ]]]]
+
 
 
===EXAMPLES===
 
===EXAMPLES===
    zoom
+
<source lang="python">
  zoom complete=1
+
# auto zoom depending on what's loaded in PyMOL
  zoom (chain A)
+
zoom
  zoom 142/
+
 
+
#
 +
zoom complete=1
 +
 
 +
# zoom on just chain A
 +
zoom (chain A)
 +
 
 +
# zoom on residue 142
 +
zoom 142/
 +
 
 +
# zoom consistenly 20 Ang from each object at the center
 +
center prot1
 +
zoom center, 20
 +
 
 +
# prot1 and prot2 will have the same exact zoom factor
 +
center prot2
 +
zoom center, 20
 +
</source>
 +
 
 
===PYMOL API===
 
===PYMOL API===
 
<source lang="python">  
 
<source lang="python">  
  cmd.zoom( string selection, float buffer=0.0,
+
cmd.zoom( string selection, float buffer=0.0,
            int state=0, int complete=0 )
+
          int state=0, int complete=0 )
 
</source>
 
</source>
 +
 
===NOTES===
 
===NOTES===
    state = 0 (default) use all coordinate states
+
state = 0 (default) use all coordinate states
  state = -1 use only coordinates for the current state
+
state = -1 use only coordinates for the current state
  state > 0  use coordinates for a specific state
+
state > 0  use coordinates for a specific state
   
+
 
  complete = 0 or 1:
+
  complete = 0 or 1:
      Normally the zoom command tries to guess an optimal zoom level
+
 
  for visualization, balancing closeness against occasional clipping
+
Normally the zoom command tries to guess an optimal zoom level for visualization, balancing closeness against occasional clipping of atoms out of the field of view.  You can change this behavior by setting the complete option to 1, which will guarantee that the atom positions for the entire selection will fit in the field of an orthoscopic view.  To absolutely prevent clipping, you may also need to add a buffer (typically 2 A) to account for the perspective transformation and for graphical representations which extend beyond the atom coordinates.
  of atoms out of the field of view.  You can change this behavior by
+
 
  setting the complete option to 1, which will guarantee that the
 
  atom positions for the entire selection will fit in the field of an
 
  orthoscopic view.  To absolutely prevent clipping, you may also
 
  need to add a buffer (typically 2 A) to account for the perpective
 
  transformation and for graphical representations which extend
 
  beyond the atom coordinates..
 
 
 
===SEE ALSO===
 
===SEE ALSO===
+
*[[Origin]]
  [[Cmd origin]], [[Cmd orient]], [[Cmd center]]  
+
*[[Orient]]
 +
*[[Center]]  
  
[[Category:Commands|zoom]]
+
[[Category:Commands|Zoom]]
 +
[[Category:States|Zoom]]
 +
[[Category:View Module|Zoom]]

Latest revision as of 14:44, 17 November 2009

zoom scales and translates the window and the origin to cover the atom selection.

USAGE

zoom [ selection [,buffer [, state [, complete ]]]]

EXAMPLES

# auto zoom depending on what's loaded in PyMOL
zoom

#
zoom complete=1

# zoom on just chain A
zoom (chain A)

# zoom on residue 142
zoom 142/

# zoom consistenly 20 Ang from each object at the center
center prot1
zoom center, 20

# prot1 and prot2 will have the same exact zoom factor
center prot2
zoom center, 20

PYMOL API

 
cmd.zoom( string selection, float buffer=0.0,
          int state=0, int complete=0 )

NOTES

state = 0 (default) use all coordinate states
state = -1 use only coordinates for the current state
state > 0  use coordinates for a specific state
complete = 0 or 1:

Normally the zoom command tries to guess an optimal zoom level for visualization, balancing closeness against occasional clipping of atoms out of the field of view. You can change this behavior by setting the complete option to 1, which will guarantee that the atom positions for the entire selection will fit in the field of an orthoscopic view. To absolutely prevent clipping, you may also need to add a buffer (typically 2 A) to account for the perspective transformation and for graphical representations which extend beyond the atom coordinates.

SEE ALSO