Difference between revisions of "Scene"

From PyMOLWiki
Jump to navigation Jump to search
 
m
Line 1: Line 1:
 
===DESCRIPTION===
 
===DESCRIPTION===
+
'''scene''' makes it possible to save and restore multiple scenes scene within a single session.  A scene consists of the view, all object activity information, all atom-wise visibility, color, representations, and the global frame index.
  "scene" makes it possible to save and restore multiple scenes scene
+
 
  within a single session.  A scene consists of the view, all object
 
  activity information, all atom-wise visibility, color,
 
  representations, and the global frame index.
 
 
 
===USAGE===
 
===USAGE===
 
 
   scene key [,action [,message [ ,view [,color [,active [,rep [,frame]]]]]]]
 
   scene key [,action [,message [ ,view [,color [,active [,rep [,frame]]]]]]]
 
   scene *
 
   scene *
Line 19: Line 14:
 
   rep: 1 or 0 controls whether the representations are stored
 
   rep: 1 or 0 controls whether the representations are stored
 
   frame: 1 or 0 controls whether the frame is stored
 
   frame: 1 or 0 controls whether the frame is stored
 
+
 
 
===PYMOL API===
 
===PYMOL API===
<source lang="python">
+
<source lang="python">
  cmd.scene(string key,string action,string-or-list message,int view,
+
cmd.scene(string key,string action,string-or-list message,int view,
 
             int color, int active, int rep, int frame)
 
             int color, int active, int rep, int frame)
</source>
+
</source>
+
 
 
===EXAMPLES===
 
===EXAMPLES===
 
 
   scene F1, store
 
   scene F1, store
 
   scene F2, store, This view shows you the critical hydrogen bond.
 
   scene F2, store, This view shows you the critical hydrogen bond.
Line 33: Line 27:
 
   scene F1
 
   scene F1
 
   scene F2
 
   scene F2
+
 
 
===NOTES===
 
===NOTES===
+
Scenes F1 through F12 are automatically bound to function keys provided that "set_key" hasn't been used to redefine the behaviour of the respective key.
  Scenes F1 through F12 are automatically bound to function keys
+
 
  provided that "set_key" hasn't been used to redefine the behaviour
 
  of the respective key.
 
 
 
 
===SEE ALSO===
 
===SEE ALSO===
+
[[Cmd view]], [[Cmd set_view]], [[Cmd get_view]]
  [[Cmd view]], [[Cmd set_view]], [[Cmd get_view]]
+
 
 
 
===DEVELOPMENT TO DO===
 
===DEVELOPMENT TO DO===
+
Add support for save/restore of a certain global and object-and-state specific settings, such as: state, surface_color, ribbon_color, stick_color, transparency, sphere_transparency, etc.  This would probably best be done by defining a class of "scene" settings which are treated in this manner.  The current workaround is to create separate objects which are enabled/disabled differentially.
  Add support for save/restore of a certain global and
+
 
      object-and-state specific settings, such as: state,
 
      surface_color, ribbon_color, stick_color, transparency,
 
      sphere_transparency, etc.  This would probably best be done by
 
      defining a class of "scene" settings which are treated in this
 
      manner.  The current workaround is to create separate objects
 
      which are enabled/disabled differentially.  
 
 
 
[[Category:Commands|scene]]
 
[[Category:Commands|scene]]

Revision as of 13:57, 9 June 2005

DESCRIPTION

scene makes it possible to save and restore multiple scenes scene within a single session. A scene consists of the view, all object activity information, all atom-wise visibility, color, representations, and the global frame index.

USAGE

  scene key [,action [,message [ ,view [,color [,active [,rep [,frame]]]]]]]
  scene *

  key can be any string
  action should be 'store' or 'recall' (default: 'recall')

  view: 1 or 0 controls whether the view is stored
  color: 1 or 0 controls whether colors are stored
  active: 1 or 0 controls whether activity is stored
  rep: 1 or 0 controls whether the representations are stored
  frame: 1 or 0 controls whether the frame is stored

PYMOL API

cmd.scene(string key,string action,string-or-list message,int view,
             int color, int active, int rep, int frame)

EXAMPLES

  scene F1, store
  scene F2, store, This view shows you the critical hydrogen bond.

  scene F1
  scene F2

NOTES

Scenes F1 through F12 are automatically bound to function keys provided that "set_key" hasn't been used to redefine the behaviour of the respective key.

SEE ALSO

Cmd view, Cmd set_view, Cmd get_view

DEVELOPMENT TO DO

Add support for save/restore of a certain global and object-and-state specific settings, such as: state, surface_color, ribbon_color, stick_color, transparency, sphere_transparency, etc. This would probably best be done by defining a class of "scene" settings which are treated in this manner. The current workaround is to create separate objects which are enabled/disabled differentially.