Zoom: Difference between revisions

From PyMOLWiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
===DESCRIPTION===
===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
zoom
  zoom complete=1
zoom complete=1
  zoom (chain A)
zoom (chain A)
  zoom 142/
zoom 142/
 
===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===
   
  [[Cmd origin]], [[Cmd orient]], [[Cmd center]]  
  [[Cmd origin]], [[Cmd orient]], [[Cmd center]]  


[[Category:Commands|zoom]]
[[Category:Commands|zoom]]

Revision as of 15:13, 3 January 2006

DESCRIPTION

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

USAGE

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

EXAMPLES

zoom
zoom complete=1
zoom (chain A)
zoom 142/

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

Cmd origin, Cmd orient, Cmd center