Add directory for scene template files

Author: j-miet

docs/scene.json scene-template/scene.jsondocs/scene.json renamed to scene-template/scene.json

@@ -26,7 +26,7 @@
             },
 			"transform": {
                 "scale": [0.05, 0.05, 0.05],
-                "position": [-0.3, -0.2, -0.28]
+                "translate": [-0.3, -0.2, -0.28]
             }
         },
         {
@@ -47,7 +47,7 @@
                 "linearBounce": true
             },
             "transform": {
-                "position": [-0.6, -0.25, -0.75],
+                "translate": [-0.6, -0.25, -0.75],
                 "scale": [0.25, 0.35, 0.25]
             }
         },
@@ -58,7 +58,7 @@
                 "color": [0.8, 0.1, 0.1]
             },
             "transform": {
-                "position": [-0.6, 0.45, -0.75],
+                "translate": [-0.6, 0.45, -0.75],
                 "scale": [0.25, 0.35, 0.25],
                 "rotation": [
                     [1, 0, 0, 180]
@@ -74,7 +74,7 @@
                 "bounce": 1
             },
             "transform": {
-                "position": [-1.55, 0.7, -1.2],
+                "translate": [-1.55, 0.7, -1.2],
                 "scale": [0.25, 1, 0.25],
                 "rotation": [
                     [1, 0, 0, 90],
@@ -83,6 +83,7 @@
             }
         },
         {
+            "name": "torus1",
             "type": "torus",
             "minorRadius": 0.2,
             "majorRadius": 0.1,
@@ -91,7 +92,7 @@
                 "color": [0.5, 1, 0.5]
             },
             "transform": {
-                "position": [0, 0.05, -0.75],
+                "translate": [0, 0.05, -0.75],
                 "rotation": [
                     [1, 0, 0, 90]
                 ]
@@ -112,7 +113,7 @@
                 "color": [0.6, 0.6, 0.6]
             },
             "transform": {
-                "position": [2, 0.5, -3]
+                "translate": [2, 0.5, -3]
             }
         },
         {
@@ -124,7 +125,7 @@
                 "color": [1, 0.65, 0]              
             },
             "transform": {
-                "position": [0.22, -0.2, -0.45]
+                "translate": [0.22, -0.2, -0.45]
             }
         },
         {
@@ -134,7 +135,7 @@
 				"color": [0.1, 0.8, 0.8]
 			},
 			"transform": {
-				"position": [0, -0.25, 0]
+				"translate": [0, -0.25, 0]
 			}
 		},
 		{
@@ -144,7 +145,7 @@
 				"color": [1, 1, 1]
 			},
 			"transform": {
-				"position": [0, 0, -20],
+				"translate": [0, 0, -20],
 				"rotation": [
 					[1, 0, 0, 90]
 				]
@@ -193,4 +194,4 @@
             "shadowBands": 0
         }
     ]
-}
+}

scene-template/scene.txt

@@ -0,0 +1,10 @@
+To produce image and gif from README:
+
+[Scene image]
+
+PixelRay -i scene.json -o output.png
+
+
+[Scene animation]
+
+PixelRay -i scene.json -s script.lua 195 -g

scene-template/script.lua

@@ -0,0 +1,46 @@
+torus1 = scene:GetObject("torus1")
+
+function update(t)
+    torus1:ResetTransform() -- this resets transform back to default in scene file. Useful for parametrized equations
+
+    frames = 195 -- total frames required ()
+    rotationFrames = 120 -- 120 is good for smooth full camera rotation
+
+    if t < 15 then
+        -- keep camera at default position
+    elseif t >= 15 and t < 30 then
+        -- gradually move camera to look towards cone + zoom in a bit
+        cosAngle = math.cos((2*math.pi/rotationFrames)*(t-15))
+        sinAngle = math.sin((2*math.pi/rotationFrames)*(t-15))
+
+        camera:LookAt(-sinAngle, 0, -cosAngle)
+        camera:Position(-0.02*(t-15), 0, -0.025*(t-15))
+    elseif t >= 30 and t < 45 then
+        -- keep camera pointed at cone
+    elseif t >= 45 and t < 60 then
+        -- revert back to default position
+        cosAngle = math.cos((2*math.pi/rotationFrames)*(59-t))
+        sinAngle = math.sin((2*math.pi/rotationFrames)*(59-t))
+
+        camera:LookAt(-sinAngle, 0, -cosAngle)
+        camera:Position(-0.02*(59-t), 0, -0.025*(59-t))
+    elseif t >= 60 and t < 75 then
+        -- keep camera at default position
+    else
+        -- full xz-plane camera rotation around center
+        cosAngle = math.cos((2*math.pi/rotationFrames)*(t-75))
+        sinAngle = math.sin((2*math.pi/rotationFrames)*(t-75))
+        center = {0, 0, -1}
+        radius = 1.5
+        x = radius*(sinAngle-center[1])
+        z = radius*(cosAngle+center[3])
+
+        camera:Position(x, 0, z)
+    end
+
+    -- torus y-axis rotation into opposite direction
+    unit = 360 / frames;
+    torus1:Translate(0, -0.05, 0.75)
+    torus1:Rotate(0, 1, 0, -2*unit*t)
+    torus1:Translate(0, 0.05, -0.75)
+end