How do I use szgpovskel.py to view my POV-Ray scene in Syzygy?

The script szgpovskel.py is intended to allow you quickly to bring a POV-Ray scene into Syzygy. Important points to remember:

• The result is not particularly interactive, except in the sense that
  
  1. it is headtracked, and
  2. a wand is added to the scene, and you may move that around.
• Some POV-Ray scene files (including those modeled with Moray) use a coordinate system with floor and ceiling parallel to the xy-plane (i.e., ``z is up''). They will not display correctly in Syzygy without modification.
• Navigation is confined to ``CUBE-space''; i.e., (-5,5) units in the x and z directions, (0,10) units in the y direction.
• Support for object animation using the POV-Ray ``clock'' identifier is built in. Keep in mind, though, that in the interactive setting, there is no specified ``initial frame'' and ``final frame,'' as defined in POV-Ray. However, a substitute, cycling ``clock'' of sorts can be used for animated effects. See instructions below.
• And the usual caveats about the balance between engaging visual effects and satisfactory frame rate, as described in the document szgpov.html, should be noted.

Instructions

1. Make sure a copy of szgpovskel.py and a copy of szgpov0730.py are saved in a directory on the path of your Syzygy shell. On my computer running Aszgard, I put them in \aszgard\user\szgpov\ .
2. Save a copy of your POV-Ray scene file in the same directory as szgpovskel.py; name the .pov file szgpovscn.pov.
3. Copy any files required by your scene (POV-Ray include files, bitmaps, text files, etc.) into the same directory as szgpovscn.pov. Double-check path references of #include and/or #fopen statements in the scene file (/files); correct as needed.
4. For animated scenes: By default, szgpov0730.py cycles through clock values from 0 to 1. The increment is clockDelta, found in POVApp.__init__( ); 0.01 is the default value, giving 100 frames per cycle. This allows szgpovskel.py to preserve animation of objects, light sources, etc.
   Automatic animation of the primary camera doesn't make much sense in the head-tracked VR setting; szgpovskel.py places the Syzygy camera definition at the end of the scene, overriding the primary camera defined in your existing POV-Ray scene file. (MegaPOV's camera_view camera/pigment system should be unaffected, although this has not been tested, since render speed is already an issue with only one camera.) For further info, see the POV-Ray (3.6) for Windows Help documentation, section 3.1.2.1: Animation Options. (From the IPython prompt in Aszgard, type ``povdoc''.)
5. Run szgpovskel.py from your Syzygy shell. For example,
   
   • In Aszgard, using standalone mode:
     movpy szgpovskel.py
   • or if in Phleet mode:
     dex vcsingle szgpovskel.py

You may try a POV-Ray scene animating a "Helicoid-Catenoid morph" as an example. (Equations from Pacific Tech's Graphing Calculator for Macintosh and Windows.) Remember to save this in the same directory with the files above, and change its name to szgpovscn.pov.