Suggested render width/height to set at initialization

Author: monkstone

raytracing/cornell_box.py

@@ -34,7 +34,7 @@ class CornellBox(object):
     Cornell box mainly as an object, except for the lights which are bit complicated
     """
     def __init__(self):
-        self.scene = POVFile("cornell_box.pov",  "colors.inc",  "skies.inc")
+        self.scene = POVFile("cornell_box.pov",  (300, 300), "colors.inc",  "skies.inc")
 
         self.cam = Camera(
                           location = (27.8, 27.3, -80), 

raytracing/povwriter/povwriter.py

@@ -5,14 +5,15 @@
 __all__ = ['POVFile',  'Vector',  'Sphere',  'Box',  'Triangle', 'Pigment', 
 'Blob', 'Texture', 'Finish', 'Normal', 'Camera', 'LightSource',  'Torus', 
 'Union', 'Intersection', 'Difference',  'SkySphere', 'Mesh', 'Plane']
-HEADER = """
+HEADER1 = """
 // Persistence Of Vision Ray Tracer Scene Description pov_fib
 // pov_fib:    Generated by tracer.py
 // tracer.py is based on http://code.activestate.com/recipes/205451/ (r1)
 // For PovRAY Version: 3.7 (includes radiosity)
 // Date: September 2011
 // Auth: Martin Prout 
-// +width 800 +height 600 for basic_scene example
+"""
+HEADER2= """
 #version 3.7;
 global_settings{
     assumed_gamma 1.0
@@ -34,16 +35,22 @@ class POVFile(object):
 
     """
     In the original recipe this was simply called file class, it seems sensible 
-    to use a more descriptive name
+    to use a more descriptive name, also included size, this can be useful.
+    PovRAY sketches should have a suggested size if only to set the aspect
+    ratio.
     """
-    def __init__(self, fnam = "out.pov", *items):
+    def __init__(self, fnam = "out.pov", size = (300,  300),  *items):
         """
         Initialize the POVFile object with hard coded HEADER, this
         could easily be read from file for greater flexiblity
         """
         self.file = open(fnam, "w")
         self.__indent = 0
-        self.writeln(HEADER)
+        self.writeln(HEADER1)
+        self.size = size # could use this data to set aspect ratio
+        # Split header to add suggested render size in comments
+        self.writeln( '// width %s height %s' %  size)
+        self.writeln(HEADER2)
         self.write(*items)
     def include(self, name):
         """
@@ -355,7 +362,7 @@ def basic_scene():
     Basic external scene
     Note the use of tuples to group scalar values for vector type
     """
-    scene = POVFile("basic_scene.pov",  "colors.inc",  "skies.inc")
+    scene = POVFile("basic_scene.pov",  (800, 600), "colors.inc",  "skies.inc")
     cam = Camera(location = (0, 2, -3), look_at = (0, 1, 2))
     sky = SkySphere("S_Cloud3")
     ground = Plane((0.0, 1.0, 0.0), 0.0,
@@ -382,7 +389,7 @@ def spiral():
     """
     from math import sqrt, pi,  cos,  sin
     gamma = (sqrt(5) - 1) / 2
-    fib = POVFile()
+    fib = POVFile("spiral.pov")
     Camera(location=(0, 0, -128), look_at = (0, 0, 0)).write(fib)
     LightSource((100, 100, -100), color = (1, 1, 1)).write(fib)
     LightSource((150, 150, -100), color = (0, 0, 0.3)).write(fib)
@@ -409,7 +416,7 @@ def test():
     """
     The current test function is ...
     """
-    basic_scene()
+    spiral()
 
 if (__name__ == "__main__"):
     test()