From 95ceeb631b6cfc7bc1c4f876ee5874a7e3ef4f17 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 16:05:23 -0500
Subject: [PATCH 1/9] almost done

---
 .DS_Store        | Bin 0 -> 6148 bytes
 .gitignore       |   3 +-
 images/.DS_Store | Bin 0 -> 6148 bytes
 src/.DS_Store    | Bin 0 -> 6148 bytes
 src/main.js      | 136 ++++++++++++++++++++++++++++++++++++++++++++---
 5 files changed, 132 insertions(+), 7 deletions(-)
 create mode 100644 .DS_Store
 create mode 100644 images/.DS_Store
 create mode 100644 src/.DS_Store

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..543f7c2db523437bfcd05ab62d1b23e18b9c8c5a
GIT binary patch
literal 6148
zcmeH~%}T>i5QWc}A_X^Hy1cL88-!AypfAv(QUq<G#jdmSwLSBrv`yW*kTWp%By(qS
z$+yU40NDKF`2m;#n9^PG>C4!B-+g2^73rwv&)9F@cH2$fjk2!?ytcyzFW4QIXZ5#u
z#XHuqcevQ=aKIi<7t!k{C@KOXAOa#F0wQoqfIZu7dY7tI1VlgtehB#Yq0wFY(jhfI
z9b94rpiUSL<8{mu)aC(dUpk~RLbEKTW~tSPVOh?2tGvE+NX>Fs4Ifq~TTLhyr}OzO
z(qVn7RuK?^a{@kl(`MfPAL+l$|DGcg0TKA81Z=WcF6Ml>>aC;K^j_QOEBd!FH`2L8
kE2c&(=8d=F`;)xp*WB+*htw!%Jj$v15pXUt5%>!NUkCdfcK`qY

literal 0
HcmV?d00001

diff --git a/.gitignore b/.gitignore
index 8d4aaf4..7efe013 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,3 @@
 node_modules
-*.map
\ No newline at end of file
+*.map
+*.un~
diff --git a/images/.DS_Store b/images/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..2f3a33dfea334974dc0eb8b12f6dbbdafaac41bd
GIT binary patch
literal 6148
zcmeHKJ8r`;3?)+|Fpwo<M_r*e5RCK$xj+IG=+M>;5+p!3Pd!(UmdDTHy4{>5cm${?
zQG62g2GbM~?anVxB5M(8;fC^U!_;iwd}51?C=iY__HwvvkNx{+|2oP3J7C<Uoa9Zu
z<l`6L_Gnaq3Qz$mKn1A4yb5G}ZCCRi%hRX;6}STh?E6sQhBa{r^iKx{ZvlV}!fu#*
zF99qT0M^7I5D}OL6&O^_7DI!Mc*(q)I0Ob=G@B32n>9NW_1kfN@pRD|$dL+Afw2M)
zv0PjIe}@0l|Bp#rQ2{D&R|;se*={;KDQoNGaaL;!d<VCjAGjIjPQl>i80h5~3oFNu
co)me-=Gd=^L!i?UcRG+i1Evd&3fx+OE9Ea0tpET3

literal 0
HcmV?d00001

diff --git a/src/.DS_Store b/src/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..5008ddfcf53c02e82d7eee2e57c38e5672ef89f6
GIT binary patch
literal 6148
zcmeH~Jr2S!425mzP>H1@V-^m;4Wg<&0T*E43hX&L&p$$qDprKhvt+--jT7}7np#A3
zem<@ulZcFPQ@L2!n>{z**<q8>++&mCkOWA81W14cNZ<zv;LbK1Poaz?KmsK2CSc!(
z0ynLxE!0092;Krf2c+FF_Fe*7ECH>lEfg7;MkzE(HCqgga^y>{tEnwC%0;vJ&^%eQ
zLs35+`xjp>T0<F0fCPF1$Cyrb|F7^5{eNG?83~ZUUlGt@xh*qZDeu<Z%US-OSsOPv
j)R!Z4KLME7ReXlK;d!wEw5GODWMKRea10D2@KpjYNUI8I

literal 0
HcmV?d00001

diff --git a/src/main.js b/src/main.js
index fd8fbd4..486be53 100755
--- a/src/main.js
+++ b/src/main.js
@@ -4,6 +4,43 @@
 const THREE = require('three'); // older modules are imported like this. You shouldn't have to worry about this much
 import Framework from './framework'
 
+var tick = 0;
+var feathers = 100;
+var flap_motion = 100;
+var wind_direction = 0;
+var featherGeo;
+
+// bone stuff
+var bone_geometry = new THREE.Geometry();
+var curve = new THREE.QuadraticBezierCurve3();
+var boneMaterial = new THREE.LineBasicMaterial( { color: 0xe3dac9, linewidth: 1 } );
+var bone = new THREE.Line(bone_geometry, boneMaterial);
+
+
+var base_color = 0x000000;
+
+var feather_color = function() {
+    this.color = 0;
+};
+
+var visible_feathers = function() {
+    this.feather_count = 100;
+}
+
+var wind_speed = function() {
+    this.wind_speed = 0;
+};
+
+var wing_curve = function() {
+    this.curve = 0;
+};
+
+// defining our scales
+var wind_speed_scale = new wind_speed();
+var wing_curve_scale = new wing_curve();
+var feather_color_scale = new feather_color();
+var visible_feathers_scale = new visible_feathers();
+
 // called after the scene loads
 function onLoad(framework) {
     var scene = framework.scene;
@@ -33,16 +70,41 @@ function onLoad(framework) {
 
     scene.background = skymap;
 
+    curve.v0 = new THREE.Vector3(0, 0, 0);
+    curve.v1 = new THREE.Vector3(3, 0, 0);
+    curve.v2 = new THREE.Vector3(6, 0, 0);
+    for (var j = 0; j < feathers; j++) {
+        bone_geometry.vertices.push(curve.getPoint(j / feathers));
+    }
+    scene.add(bone);
+
     // load a simple obj mesh
     var objLoader = new THREE.OBJLoader();
     objLoader.load('/geo/feather.obj', function(obj) {
 
         // LOOK: This function runs after the obj has finished loading
-        var featherGeo = obj.children[0].geometry;
+        featherGeo = obj.children[0].geometry;
 
         var featherMesh = new THREE.Mesh(featherGeo, lambertWhite);
         featherMesh.name = "feather";
-        scene.add(featherMesh);
+        featherMesh.position.set(0.1, 0.3, 0);
+        //var clone = featherMesh.clone(true);
+        //clone.position.set(0.0, 0.0, 0.0);
+        //clone.rotateZ(-70);
+        // Y by PI/2
+        // Z by 180
+        //scene.add(featherMesh);
+        for (var i = 0; i < bone_geometry.vertices.length; i++) {
+            var vertex = bone_geometry.vertices[i];
+            var feather = featherMesh.clone(true);
+            feather.name = i;
+            feather.position.set(vertex.x, vertex.y, vertex.z);
+            feather.rotateY(90);
+            feather.rotateZ(180);
+            feather.scale.set((i/feathers), (i/feathers), (i/feathers));
+            feather.traverse( function ( object ) { object.visible = true; } );
+            scene.add(feather);
+        }
     });
 
     // set camera position
@@ -57,17 +119,79 @@ function onLoad(framework) {
     gui.add(camera, 'fov', 0, 180).onChange(function(newVal) {
         camera.updateProjectionMatrix();
     });
+
+    gui.add(wind_speed_scale, 'wind_speed', 0, 100).onChange(function(newVal) {
+        wind_speed_scale.scale = newVal;
+    });
+
+    gui.add(feather_color_scale, 'color', 0, 100).onChange(function(newVal) {
+        feather_color_scale.color = newVal;
+    });
+
+    gui.add(visible_feathers_scale, 'feather_count', 0, 100).onChange(function(newVal) {
+        visible_feathers_scale.feather_count = newVal;
+        for (var i = 0; i < newVal; i++) {
+            var feather = framework.scene.getObjectByName(i);
+            if (feather) {
+                feather.traverse( function ( object ) { object.visible = true; });
+            }
+        }
+        for (var i = Math.round(newVal); i < 100; i++) {
+            var feather = framework.scene.getObjectByName(i);
+            if (feather) {
+                feather.traverse( function ( object ) { object.visible = false; });
+            }
+        }
+    });
+
+    gui.add(wing_curve_scale, 'curve', -5, 5).onChange(function(newVal) {
+        wing_curve_scale.curve = newVal;
+        curve.v1 = new THREE.Vector3(3, newVal, 0);
+        //curve.v2 = new THREE.Vector3(6, newVal, 0);
+        scene.remove(bone);
+        bone_geometry = new THREE.Geometry();
+        for (var j = 0; j < feathers; j++) {
+            bone_geometry.vertices.push(curve.getPoint(j / feathers));
+        }
+        bone = new THREE.Line(bone_geometry, boneMaterial);
+        scene.add(bone);
+
+        for (var i = 0; i < bone_geometry.vertices.length; i++) {
+            var vertex = bone_geometry.vertices[i];
+            var feather = framework.scene.getObjectByName(i);
+            feather.position.set(vertex.x, vertex.y, vertex.z);
+        }
+
+        for (var i = 0; i < visible_feathers_scale.feather_count; i++) {
+            var feather = framework.scene.getObjectByName(i);
+            feather.traverse( function ( object ) { object.visible = true; });
+        }
+        for (var i = Math.round(visible_feathers_scale.feather_count); i < 100; i++) {
+            var feather = framework.scene.getObjectByName(i);
+            feather.traverse( function ( object ) { object.visible = false; });
+        }
+
+    });
 }
 
 // called on frame updates
 function onUpdate(framework) {
-    var feather = framework.scene.getObjectByName("feather");    
-    if (feather !== undefined) {
+    //var feather = framework.scene.getObjectByName("feather");
+    //if (feather !== undefined) {
         // Simply flap wing
+        //feather.rotateZ(Math.sin(date.getTime() / 100) * 2 * Math.PI / 180);
+    //}
+    tick += 1;
+    for (var i = 0; i < visible_feathers_scale.feather_count; i++) {
+        var feather = framework.scene.getObjectByName(i);
         var date = new Date();
-        feather.rotateZ(Math.sin(date.getTime() / 100) * 2 * Math.PI / 180);        
+        if (feather !== undefined) {
+            feather.rotateZ(wind_speed_scale.wind_speed / 100 * Math.sin(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+            feather.material.color.set(base_color + feather_color_scale.color * 167772);
+            //feather.translateZ(wind_speed * Math.sin(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+        }
     }
 }
 
 // when the scene is done initializing, it will call onLoad, then on frame updates, call onUpdate
-Framework.init(onLoad, onUpdate);
\ No newline at end of file
+Framework.init(onLoad, onUpdate);

From 788dedd4a284e9f9dd4a94b681cd25153d52612c Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 16:14:45 -0500
Subject: [PATCH 2/9] updates

---
 README.md   | 81 ++---------------------------------------------------
 src/main.js | 18 ++++++++++--
 2 files changed, 18 insertions(+), 81 deletions(-)

diff --git a/README.md b/README.md
index 1410c30..626c646 100644
--- a/README.md
+++ b/README.md
@@ -1,82 +1,7 @@
 # [Project2: Toolbox Functions](https://github.com/CIS700-Procedural-Graphics/Project2-Toolbox-Functions)
 
-## Overview
+Author: Joseph Gao
 
-The objective of this assignment is to procedurally model and animate a bird wing. Let's get creative!
+Features Implemented
+- CHECK BACK @ MIDNIGHT TODAY THANK YOU SORRY I WANT TO MAKE IT MORE PRETTY
 
-Start by forking and then cloning [this repository](https://github.com/CIS700-Procedural-Graphics/Project2-Toolbox-Functions)
-
-## Modeling
-
-##### Reference images
-
-Search for three or more images of a bird wing (or any flying creature, really) in order to provide yourself reference material, as you're going to base your modeling and animation from these images. For the more artistic minds, feel free to sketch your own concept.
-
-##### Make wing curve
-
-Begin with a 3D curve for your basic wing shape. Three.js provides classes to create many different types of curves, so you may use whatever type of curve you prefer.
-
-##### Distribute feathers
-
-We have provided a simple feather model from which to begin. You are not required to use this model if you have others that you prefer. From this base, you must duplicate the feather to model a complete wing, and your wing should consist of at least thirty feathers. Distribute points along the curve you created previously; you will append the feather primitives to the curve at these points. Make sure that you modify the size, orientation, and color of your feathers depending on their location on the wing. 
-
-Feel free to diversify your wings by using multiple base feather models.
-
-## Animation
-
-Add a wind force to your scene, and parameterize its direction and speed. You will use this wind force to animate the feathers of your wing by vibrating them slightly. Using Dat.GUI, allow the user to modify these wind parameters. Please note that we don't care about your feather motion being physically accurate, as long as it looks nice.
-
-Additionally, animate the control points of your wing curve to make the wing flap, and allow the user to control the speed of the wing flapping.
-
-## Interactivity
-
-Using Dat.GUI and the examples provided in the reference code, allow the user to adjust the following controls:
-
-1. The curvature of the wing's basic shape
-2. Feather distribution
-3. Feather size
-4. Feather color
-5. Feather orientation
-6. Flapping speed
-7. Flapping motion
-
-## For the Overachievers
-
-Suggestions:
-- Make a pretty iridescent or otherwise feather appropriate shader.
-- Otherwise, going the extra mile for this assignment is really in the polish!
-
-## Submission
-
-- Create a folder called `references` to include your reference images.
-
-- Update `README.md` to contain a solid description of your project
-
-- Publish your project to gh-pages. `npm run deploy`. It should now be visible at http://username.github.io/repo-name
-
-- Create a [pull request](https://help.github.com/articles/creating-a-pull-request/) to this repository, and in the comment, include a link to your published project.
-
-- Submit the link to your pull request on Canvas.
-
-## Getting Started
-
-1. [Install Node.js](https://nodejs.org/en/download/). Node.js is a JavaScript runtime. It basically allows you to run JavaScript when not in a browser. For our purposes, this is not necessary. The important part is that with it comes `npm`, the Node Package Manager. This allows us to easily declare and install external dependencies such as [three.js](https://threejs.org/), [dat.GUI](https://workshop.chromeexperiments.com/examples/gui/#1--Basic-Usage), and [glMatrix](http://glmatrix.net/). Some other packages we'll be using make it significantly easier to develop your code and create modules for better code reuse and clarity. These tools make it _signficantly_ easier to write code in multiple `.js` files without globally defining everything.
-
-2. Fork and clone your repository.
-
-3. In the root directory of your project, run `npm install`. This will download all of those dependencies.
-
-4. Do either of the following (but I highly recommend the first one for reasons I will explain later).
-
-    a. Run `npm start` and then go to `localhost:7000` in your web browser
-
-    b. Run `npm run build` and then go open `index.html` in your web browser
-
-    You should hopefully see the framework code with a 3D cube at the center of the screen!
-
-
-## Developing Your Code
-All of the JavaScript code is living inside the `src` directory. The main file that gets executed when you load the page as you may have guessed is `main.js`. Here, you can make any changes you want, import functions from other files, etc. The reason that I highly suggest you build your project with `npm start` is that doing so will start a process that watches for any changes you make to your code. If it detects anything, it'll automagically rebuild your project and then refresh your browser window for you. Wow. That's cool. If you do it the other way, you'll need to run `npm build` and then refresh your page every time you want to test something.
-
-## Publishing Your Code
-We highly suggest that you put your code on GitHub. One of the reasons we chose to make this course using JavaScript is that the Web is highly accessible and making your awesome work public and visible can be a huge benefit when you're looking to score a job or internship. To aid you in this process, running `npm run deploy` will automatically build your project and push it to `gh-pages` where it will be visible at `username.github.io/repo-name`.
\ No newline at end of file
diff --git a/src/main.js b/src/main.js
index 486be53..bfc57e5 100755
--- a/src/main.js
+++ b/src/main.js
@@ -7,7 +7,6 @@ import Framework from './framework'
 var tick = 0;
 var feathers = 100;
 var flap_motion = 100;
-var wind_direction = 0;
 var featherGeo;
 
 // bone stuff
@@ -35,11 +34,16 @@ var wing_curve = function() {
     this.curve = 0;
 };
 
+var wind_direction = function() {
+    this.wind_direction = 0;
+}
+
 // defining our scales
 var wind_speed_scale = new wind_speed();
 var wing_curve_scale = new wing_curve();
 var feather_color_scale = new feather_color();
 var visible_feathers_scale = new visible_feathers();
+var wind_direction_scale = new wind_direction();
 
 // called after the scene loads
 function onLoad(framework) {
@@ -170,7 +174,10 @@ function onLoad(framework) {
             var feather = framework.scene.getObjectByName(i);
             feather.traverse( function ( object ) { object.visible = false; });
         }
+    });
 
+    gui.add(wind_direction_scale, 'wind_direction', 0, 1).onChange(function(newVal) {
+        wind_direction_scale.wind_direction = newVal;
     });
 }
 
@@ -186,9 +193,14 @@ function onUpdate(framework) {
         var feather = framework.scene.getObjectByName(i);
         var date = new Date();
         if (feather !== undefined) {
-            feather.rotateZ(wind_speed_scale.wind_speed / 100 * Math.sin(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
             feather.material.color.set(base_color + feather_color_scale.color * 167772);
-            //feather.translateZ(wind_speed * Math.sin(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+
+            if (wind_direction_scale.wind_direction == 0) {
+                feather.rotateZ(wind_speed_scale.wind_speed / 100 * Math.sin(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+            }
+            else {
+                feather.rotateY(wind_speed_scale.wind_speed / 100 * Math.cos(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+            }
         }
     }
 }

From 1f3eb56685100c2396f1c9a4c62220bacde33669 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 16:17:36 -0500
Subject: [PATCH 3/9] updated the package.json

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index c80e8a3..cde25c8 100644
--- a/package.json
+++ b/package.json
@@ -2,7 +2,7 @@
   "scripts": {
     "start": "webpack-dev-server --hot --inline",
     "build": "webpack",
-    "deploy": "rm -rf npm-debug.log && git checkout master && git commit -am 'update' && gh-pages-deploy"
+    "deploy": "gh-pages-deploy"
   },
   "gh-pages-deploy": {
     "prep": [

From 4953f6c350b7ac908e460fabddf4becb6ba55138 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 22:34:48 -0500
Subject: [PATCH 4/9] finished

---
 .DS_Store     | Bin 6148 -> 6148 bytes
 npm-debug.log |  45 ++++++++++++++++++++
 src/main.js   | 116 ++++++++++++++++++++++++++++++++++++--------------
 3 files changed, 130 insertions(+), 31 deletions(-)
 create mode 100644 npm-debug.log

diff --git a/.DS_Store b/.DS_Store
index 543f7c2db523437bfcd05ab62d1b23e18b9c8c5a..441bac109af06199ff3a84b0951597330d045269 100644
GIT binary patch
delta 47
ycmZoMXfc@J&&V<{z#2&On2Pc+<T2zkq%fp1#53fAS)~j)8`l}KZ)WHC%MSn}01RvZ

delta 29
jcmZoMXfc@J&&WJ6z#2&Om~MP2$39trQDZYZ$6tN`iMk0F

diff --git a/npm-debug.log b/npm-debug.log
new file mode 100644
index 0000000..813a84f
--- /dev/null
+++ b/npm-debug.log
@@ -0,0 +1,45 @@
+0 info it worked if it ends with ok
+1 verbose cli [ '/usr/local/bin/node', '/usr/local/bin/npm', 'run', 'deploy' ]
+2 info using npm@3.10.10
+3 info using node@v6.9.4
+4 verbose run-script [ 'predeploy', 'deploy', 'postdeploy' ]
+5 info lifecycle @~predeploy: @
+6 silly lifecycle @~predeploy: no script for predeploy, continuing
+7 info lifecycle @~deploy: @
+8 verbose lifecycle @~deploy: unsafe-perm in lifecycle true
+9 verbose lifecycle @~deploy: PATH: /usr/local/lib/node_modules/npm/bin/node-gyp-bin:/Users/josephgao/Dropbox/developer/cis700_6/Project2-Toolbox-Functions/node_modules/.bin:/Users/josephgao/.rvm/gems/ruby-2.3.1/bin:/Users/josephgao/.rvm/gems/ruby-2.3.1@global/bin:/Users/josephgao/.rvm/rubies/ruby-2.3.1/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/josephgao/.rvm/bin:/Users/josephgao/.rvm/bin
+10 verbose lifecycle @~deploy: CWD: /Users/josephgao/Dropbox/developer/cis700_6/Project2-Toolbox-Functions
+11 silly lifecycle @~deploy: Args: [ '-c', 'gh-pages-deploy' ]
+12 silly lifecycle @~deploy: Returned: code: 1  signal: null
+13 info lifecycle @~deploy: Failed to exec deploy script
+14 verbose stack Error: @ deploy: `gh-pages-deploy`
+14 verbose stack Exit status 1
+14 verbose stack     at EventEmitter.<anonymous> (/usr/local/lib/node_modules/npm/lib/utils/lifecycle.js:255:16)
+14 verbose stack     at emitTwo (events.js:106:13)
+14 verbose stack     at EventEmitter.emit (events.js:191:7)
+14 verbose stack     at ChildProcess.<anonymous> (/usr/local/lib/node_modules/npm/lib/utils/spawn.js:40:14)
+14 verbose stack     at emitTwo (events.js:106:13)
+14 verbose stack     at ChildProcess.emit (events.js:191:7)
+14 verbose stack     at maybeClose (internal/child_process.js:877:16)
+14 verbose stack     at Process.ChildProcess._handle.onexit (internal/child_process.js:226:5)
+15 verbose pkgid @
+16 verbose cwd /Users/josephgao/Dropbox/developer/cis700_6/Project2-Toolbox-Functions
+17 error Darwin 16.3.0
+18 error argv "/usr/local/bin/node" "/usr/local/bin/npm" "run" "deploy"
+19 error node v6.9.4
+20 error npm  v3.10.10
+21 error code ELIFECYCLE
+22 error @ deploy: `gh-pages-deploy`
+22 error Exit status 1
+23 error Failed at the @ deploy script 'gh-pages-deploy'.
+23 error Make sure you have the latest version of node.js and npm installed.
+23 error If you do, this is most likely a problem with the  package,
+23 error not with npm itself.
+23 error Tell the author that this fails on your system:
+23 error     gh-pages-deploy
+23 error You can get information on how to open an issue for this project with:
+23 error     npm bugs
+23 error Or if that isn't available, you can get their info via:
+23 error     npm owner ls
+23 error There is likely additional logging output above.
+24 verbose exit [ 1, true ]
diff --git a/src/main.js b/src/main.js
index bfc57e5..1e1925c 100755
--- a/src/main.js
+++ b/src/main.js
@@ -5,9 +5,10 @@ const THREE = require('three'); // older modules are imported like this. You sho
 import Framework from './framework'
 
 var tick = 0;
+var damping = 0.1;
 var feathers = 100;
-var flap_motion = 100;
 var featherGeo;
+var wind_direction = 0;
 
 // bone stuff
 var bone_geometry = new THREE.Geometry();
@@ -16,7 +17,7 @@ var boneMaterial = new THREE.LineBasicMaterial( { color: 0xe3dac9, linewidth: 1
 var bone = new THREE.Line(bone_geometry, boneMaterial);
 
 
-var base_color = 0x000000;
+var base_color = 0xFFDFF00;
 
 var feather_color = function() {
     this.color = 0;
@@ -38,15 +39,31 @@ var wind_direction = function() {
     this.wind_direction = 0;
 }
 
+var feather_size = function() {
+    this.feather_size = 1;
+}
+
+var flap_speed = function() {
+    this.flap_speed = 1;
+}
+
+var flap_range = function() {
+    this.flap_range = 1;
+}
+
 // defining our scales
 var wind_speed_scale = new wind_speed();
 var wing_curve_scale = new wing_curve();
 var feather_color_scale = new feather_color();
 var visible_feathers_scale = new visible_feathers();
 var wind_direction_scale = new wind_direction();
+var feather_size_scale = new feather_size();
+var feather_flap_speed = new flap_speed();
+var feather_flap_range = new flap_range();
 
 // called after the scene loads
 function onLoad(framework) {
+    console.log('hi');
     var scene = framework.scene;
     var camera = framework.camera;
     var renderer = framework.renderer;
@@ -74,9 +91,9 @@ function onLoad(framework) {
 
     scene.background = skymap;
 
-    curve.v0 = new THREE.Vector3(0, 0, 0);
-    curve.v1 = new THREE.Vector3(3, 0, 0);
-    curve.v2 = new THREE.Vector3(6, 0, 0);
+    curve.v0 = new THREE.Vector3(-3, 0, 0);
+    curve.v1 = new THREE.Vector3(0, 0, 0);
+    curve.v2 = new THREE.Vector3(3, 0, 0);
     for (var j = 0; j < feathers; j++) {
         bone_geometry.vertices.push(curve.getPoint(j / feathers));
     }
@@ -92,12 +109,6 @@ function onLoad(framework) {
         var featherMesh = new THREE.Mesh(featherGeo, lambertWhite);
         featherMesh.name = "feather";
         featherMesh.position.set(0.1, 0.3, 0);
-        //var clone = featherMesh.clone(true);
-        //clone.position.set(0.0, 0.0, 0.0);
-        //clone.rotateZ(-70);
-        // Y by PI/2
-        // Z by 180
-        //scene.add(featherMesh);
         for (var i = 0; i < bone_geometry.vertices.length; i++) {
             var vertex = bone_geometry.vertices[i];
             var feather = featherMesh.clone(true);
@@ -115,7 +126,6 @@ function onLoad(framework) {
     camera.position.set(0, 1, 5);
     camera.lookAt(new THREE.Vector3(0,0,0));
 
-    // scene.add(lambertCube);
     scene.add(directionalLight);
 
     // edit params and listen to changes like this
@@ -150,8 +160,9 @@ function onLoad(framework) {
 
     gui.add(wing_curve_scale, 'curve', -5, 5).onChange(function(newVal) {
         wing_curve_scale.curve = newVal;
-        curve.v1 = new THREE.Vector3(3, newVal, 0);
-        //curve.v2 = new THREE.Vector3(6, newVal, 0);
+        curve.v0 = new THREE.Vector3(-3, -1 * newVal, 0);
+        curve.v1 = new THREE.Vector3(0, newVal, 0);
+        curve.v2 = new THREE.Vector3(3, -1 * newVal, 0);
         scene.remove(bone);
         bone_geometry = new THREE.Geometry();
         for (var j = 0; j < feathers; j++) {
@@ -165,41 +176,84 @@ function onLoad(framework) {
             var feather = framework.scene.getObjectByName(i);
             feather.position.set(vertex.x, vertex.y, vertex.z);
         }
+    });
 
-        for (var i = 0; i < visible_feathers_scale.feather_count; i++) {
-            var feather = framework.scene.getObjectByName(i);
-            feather.traverse( function ( object ) { object.visible = true; });
+    gui.add(wind_direction_scale, 'wind_direction', 0, 1).onChange(function(newVal) {
+        if (wind_direction !== 0) {
+            for (var i = 0; i < feathers; i++) {
+                var feather = framework.scene.getObjectByName(i);
+                if (feather && newVal != 1) {
+                    feather.rotateY(0.03);
+                }
+            }
+            if (newVal === 0) {
+                wind_direction = 0;
+            }
         }
-        for (var i = Math.round(visible_feathers_scale.feather_count); i < 100; i++) {
-            var feather = framework.scene.getObjectByName(i);
-            feather.traverse( function ( object ) { object.visible = false; });
+        else {
+            for (var i = 0; i < feathers; i++) {
+                var feather = framework.scene.getObjectByName(i);
+                if (feather && newVal != 0) {
+                    feather.rotateY(-0.03);
+                }
+            }
+            if (newVal === 1) {
+                wind_direction = 1;
+            }
         }
+        wind_direction_scale.wind_direction = newVal;
     });
 
-    gui.add(wind_direction_scale, 'wind_direction', 0, 1).onChange(function(newVal) {
-        wind_direction_scale.wind_direction = newVal;
+    gui.add(feather_size_scale, 'feather_size', 1, 10).onChange(function(newVal) {
+        feather_size_scale.feather_size = newVal;
+    });
+
+    gui.add(feather_flap_speed, 'flap_speed', 1, 10).onChange(function(newVal) {
+        feather_flap_speed.flap_speed = newVal;
+    });
+
+    gui.add(feather_flap_range, 'flap_range', 1, 5).onChange(function(newVal) {
+        feather_flap_range.flap_range = newVal;
     });
 }
 
 // called on frame updates
 function onUpdate(framework) {
-    //var feather = framework.scene.getObjectByName("feather");
-    //if (feather !== undefined) {
-        // Simply flap wing
-        //feather.rotateZ(Math.sin(date.getTime() / 100) * 2 * Math.PI / 180);
-    //}
-    tick += 1;
+    tick += feather_flap_speed.flap_speed / 10;
+    var flap_range = feather_flap_range.flap_range;
+    var disp = flap_range * Math.sin(tick);
+
+    curve.v0 = new THREE.Vector3(-3, -1 * disp, 0);
+    curve.v1 = new THREE.Vector3(0, disp, 0);
+    curve.v2 = new THREE.Vector3(3, -1 * disp, 0);
+    framework.scene.remove(bone);
+    bone_geometry = new THREE.Geometry();
+    for (var j = 0; j < feathers; j++) {
+        bone_geometry.vertices.push(curve.getPoint(j / feathers));
+    }
+    bone = new THREE.Line(bone_geometry, boneMaterial);
+    framework.scene.add(bone);
+    console.log(bone_geometry.vertices.length);
+    for (var i = 0; i < bone_geometry.vertices.length; i++) {
+        var vertex = bone_geometry.vertices[i];
+        var feather = framework.scene.getObjectByName(i);
+        if (feather) {
+            feather.position.set(vertex.x, vertex.y, vertex.z);
+        }
+    }
+
     for (var i = 0; i < visible_feathers_scale.feather_count; i++) {
         var feather = framework.scene.getObjectByName(i);
         var date = new Date();
+        var size_factor = feather_size_scale.feather_size;
         if (feather !== undefined) {
+            feather.scale.set((size_factor * i/feathers), (size_factor * i/feathers), (size_factor * i/feathers));
             feather.material.color.set(base_color + feather_color_scale.color * 167772);
-
             if (wind_direction_scale.wind_direction == 0) {
-                feather.rotateZ(wind_speed_scale.wind_speed / 100 * Math.sin(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+                feather.rotateZ(wind_speed_scale.wind_speed / 100 * Math.sin(i + date.getTime() / 100) * 2 * Math.PI / 180);
             }
             else {
-                feather.rotateY(wind_speed_scale.wind_speed / 100 * Math.cos(i * flap_motion + date.getTime() / 100) * 2 * Math.PI / 180);
+                feather.rotateY(wind_speed_scale.wind_speed / 100 * Math.cos(i + date.getTime() / 100) * 2 * Math.PI / 180);
             }
         }
     }

From aa81f4a2908300d7e3fa80e7be7dc3d9a631b441 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 22:50:28 -0500
Subject: [PATCH 5/9] updated readme and added ref images

---
 .DS_Store                         | Bin 6148 -> 6148 bytes
 README.md                         |  21 +++++++++++++++++++--
 references/owl_wing_bone.jpg      | Bin 0 -> 31735 bytes
 references/wing_with_feathers.jpg | Bin 0 -> 16637 bytes
 src/main.js                       |   2 +-
 5 files changed, 20 insertions(+), 3 deletions(-)
 create mode 100644 references/owl_wing_bone.jpg
 create mode 100644 references/wing_with_feathers.jpg

diff --git a/.DS_Store b/.DS_Store
index 441bac109af06199ff3a84b0951597330d045269..d45803c6fedc307892353c8465ee5b982889fe13 100644
GIT binary patch
delta 232
zcmZoMXfc=|#>B)qu~2NHo+2a1!~pBf0*noeKvqv|Jr_d}Ln=cW5QFGEhGZaFoRe-C
zoSdIqz<>Z))#c{9xTKVpBr`Bv+0Ly2R*XYk3J!I0s1_Gwpjy1~86)dvb`E|Hp!+v7
cGJa>C%r9anzzDRd0f>P#h{>=yKx7Lu0EQDVod5s;

delta 64
zcmZoMXfc=|#>CJ*u~2NHo+2a5!~knXmdQL!v70%W|FLW~U{+w-%+A5j0aUVCk@-9G
UWPTAtMuy2YJkpzEL{=~Z03*N<TmS$7

diff --git a/README.md b/README.md
index 626c646..e4227e6 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,24 @@
 # [Project2: Toolbox Functions](https://github.com/CIS700-Procedural-Graphics/Project2-Toolbox-Functions)
 
-Author: Joseph Gao
+* Author: Joseph Gao
+* PennKey: gaoj
 
 Features Implemented
-- CHECK BACK @ MIDNIGHT TODAY THANK YOU SORRY I WANT TO MAKE IT MORE PRETTY
+--------------------
+* Modeling 
+I based my wing and feather structure from that of an owl. 
+
+To make the bone, I used QuadraticBezierCurve3 to sketch out its rough outline. I attempted to make the bone follow the general structure of an owl wing by finding points that would make the closest parabola possible. Once the Bezier curve was created, I distributed vertices evenly along the bone structure that would serve as the locations of the 100 feathers.
+
+* Animation
+My scene contains a dynamic, movable wind (just use the GUI). The wind force causes the feathers to be blown a different direction in 3D space. The wind itself causes the feathers to vibrate in place, and the intensity of this can be changed. Additionally, the wing is always flapping.
+
+* Interactivity
+All the required interactivity features have been implemented, and the user is able to alter the intensity and direction of the wind, manually change the curvature of the bone, alter the number of feathers present on the bone, change the feather size, color, and orientation, as well as alter the flapping speed and intensity of the wing. All this can be done through the GUI in the upper right.
+
+
+Extra Credit
+------------
+- No extra credit implemented for this homework. 
+
 
diff --git a/references/owl_wing_bone.jpg b/references/owl_wing_bone.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..7bc0c9fef6a99a458bedb8f1c562ac227212cf8e
GIT binary patch
literal 31735
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

literal 0
HcmV?d00001

diff --git a/references/wing_with_feathers.jpg b/references/wing_with_feathers.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..ba65cc466370b6e053aa2cab95e49f2393421644
GIT binary patch
literal 16637
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
KW(R&<`ab}AB#f8<

literal 0
HcmV?d00001

diff --git a/src/main.js b/src/main.js
index 1e1925c..a850571 100755
--- a/src/main.js
+++ b/src/main.js
@@ -28,7 +28,7 @@ var visible_feathers = function() {
 }
 
 var wind_speed = function() {
-    this.wind_speed = 0;
+    this.wind_speed = 10;
 };
 
 var wing_curve = function() {

From feb82d151187ff4fae2651460d359332a267e877 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 23:15:50 -0500
Subject: [PATCH 6/9] updates

---
 npm-debug.log | 45 ---------------------------------------------
 src/main.js   |  5 ++---
 2 files changed, 2 insertions(+), 48 deletions(-)
 delete mode 100644 npm-debug.log

diff --git a/npm-debug.log b/npm-debug.log
deleted file mode 100644
index 813a84f..0000000
--- a/npm-debug.log
+++ /dev/null
@@ -1,45 +0,0 @@
-0 info it worked if it ends with ok
-1 verbose cli [ '/usr/local/bin/node', '/usr/local/bin/npm', 'run', 'deploy' ]
-2 info using npm@3.10.10
-3 info using node@v6.9.4
-4 verbose run-script [ 'predeploy', 'deploy', 'postdeploy' ]
-5 info lifecycle @~predeploy: @
-6 silly lifecycle @~predeploy: no script for predeploy, continuing
-7 info lifecycle @~deploy: @
-8 verbose lifecycle @~deploy: unsafe-perm in lifecycle true
-9 verbose lifecycle @~deploy: PATH: /usr/local/lib/node_modules/npm/bin/node-gyp-bin:/Users/josephgao/Dropbox/developer/cis700_6/Project2-Toolbox-Functions/node_modules/.bin:/Users/josephgao/.rvm/gems/ruby-2.3.1/bin:/Users/josephgao/.rvm/gems/ruby-2.3.1@global/bin:/Users/josephgao/.rvm/rubies/ruby-2.3.1/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/josephgao/.rvm/bin:/Users/josephgao/.rvm/bin
-10 verbose lifecycle @~deploy: CWD: /Users/josephgao/Dropbox/developer/cis700_6/Project2-Toolbox-Functions
-11 silly lifecycle @~deploy: Args: [ '-c', 'gh-pages-deploy' ]
-12 silly lifecycle @~deploy: Returned: code: 1  signal: null
-13 info lifecycle @~deploy: Failed to exec deploy script
-14 verbose stack Error: @ deploy: `gh-pages-deploy`
-14 verbose stack Exit status 1
-14 verbose stack     at EventEmitter.<anonymous> (/usr/local/lib/node_modules/npm/lib/utils/lifecycle.js:255:16)
-14 verbose stack     at emitTwo (events.js:106:13)
-14 verbose stack     at EventEmitter.emit (events.js:191:7)
-14 verbose stack     at ChildProcess.<anonymous> (/usr/local/lib/node_modules/npm/lib/utils/spawn.js:40:14)
-14 verbose stack     at emitTwo (events.js:106:13)
-14 verbose stack     at ChildProcess.emit (events.js:191:7)
-14 verbose stack     at maybeClose (internal/child_process.js:877:16)
-14 verbose stack     at Process.ChildProcess._handle.onexit (internal/child_process.js:226:5)
-15 verbose pkgid @
-16 verbose cwd /Users/josephgao/Dropbox/developer/cis700_6/Project2-Toolbox-Functions
-17 error Darwin 16.3.0
-18 error argv "/usr/local/bin/node" "/usr/local/bin/npm" "run" "deploy"
-19 error node v6.9.4
-20 error npm  v3.10.10
-21 error code ELIFECYCLE
-22 error @ deploy: `gh-pages-deploy`
-22 error Exit status 1
-23 error Failed at the @ deploy script 'gh-pages-deploy'.
-23 error Make sure you have the latest version of node.js and npm installed.
-23 error If you do, this is most likely a problem with the  package,
-23 error not with npm itself.
-23 error Tell the author that this fails on your system:
-23 error     gh-pages-deploy
-23 error You can get information on how to open an issue for this project with:
-23 error     npm bugs
-23 error Or if that isn't available, you can get their info via:
-23 error     npm owner ls
-23 error There is likely additional logging output above.
-24 verbose exit [ 1, true ]
diff --git a/src/main.js b/src/main.js
index a850571..d8f62f0 100755
--- a/src/main.js
+++ b/src/main.js
@@ -63,7 +63,6 @@ var feather_flap_range = new flap_range();
 
 // called after the scene loads
 function onLoad(framework) {
-    console.log('hi');
     var scene = framework.scene;
     var camera = framework.camera;
     var renderer = framework.renderer;
@@ -81,7 +80,7 @@ function onLoad(framework) {
 
     // set skybox
     var loader = new THREE.CubeTextureLoader();
-    var urlPrefix = '/images/skymap/';
+    var urlPrefix = 'images/skymap/';
 
     var skymap = new THREE.CubeTextureLoader().load([
         urlPrefix + 'px.jpg', urlPrefix + 'nx.jpg',
@@ -101,7 +100,7 @@ function onLoad(framework) {
 
     // load a simple obj mesh
     var objLoader = new THREE.OBJLoader();
-    objLoader.load('/geo/feather.obj', function(obj) {
+    objLoader.load('geo/feather.obj', function(obj) {
 
         // LOOK: This function runs after the obj has finished loading
         featherGeo = obj.children[0].geometry;

From 91de22435cf0bb900bee56d5e8ab49f58db3a426 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 23:21:34 -0500
Subject: [PATCH 7/9] fixes?

---
 src/main.js | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/main.js b/src/main.js
index d8f62f0..9417544 100755
--- a/src/main.js
+++ b/src/main.js
@@ -80,7 +80,7 @@ function onLoad(framework) {
 
     // set skybox
     var loader = new THREE.CubeTextureLoader();
-    var urlPrefix = 'images/skymap/';
+    var urlPrefix = 'Project2-Toolbox-Functions/images/skymap/';
 
     var skymap = new THREE.CubeTextureLoader().load([
         urlPrefix + 'px.jpg', urlPrefix + 'nx.jpg',
@@ -100,7 +100,7 @@ function onLoad(framework) {
 
     // load a simple obj mesh
     var objLoader = new THREE.OBJLoader();
-    objLoader.load('geo/feather.obj', function(obj) {
+    objLoader.load('Project2-Toolbox-Functions/geo/feather.obj', function(obj) {
 
         // LOOK: This function runs after the obj has finished loading
         featherGeo = obj.children[0].geometry;

From 11850faf97ae98dcd68375b5b27aa1a0ec611282 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 23:24:18 -0500
Subject: [PATCH 8/9] updates to readme

---
 README.md   | 16 +++++++++++-----
 src/main.js |  4 ++--
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index e4227e6..db7e022 100644
--- a/README.md
+++ b/README.md
@@ -3,17 +3,23 @@
 * Author: Joseph Gao
 * PennKey: gaoj
 
-Features Implemented
---------------------
-* Modeling 
+# Features Implemented
+
+Modeling 
+-------
+
 I based my wing and feather structure from that of an owl. 
 
 To make the bone, I used QuadraticBezierCurve3 to sketch out its rough outline. I attempted to make the bone follow the general structure of an owl wing by finding points that would make the closest parabola possible. Once the Bezier curve was created, I distributed vertices evenly along the bone structure that would serve as the locations of the 100 feathers.
 
-* Animation
+Animation
+---------
+
 My scene contains a dynamic, movable wind (just use the GUI). The wind force causes the feathers to be blown a different direction in 3D space. The wind itself causes the feathers to vibrate in place, and the intensity of this can be changed. Additionally, the wing is always flapping.
 
-* Interactivity
+Interactivity
+-------------
+
 All the required interactivity features have been implemented, and the user is able to alter the intensity and direction of the wind, manually change the curvature of the bone, alter the number of feathers present on the bone, change the feather size, color, and orientation, as well as alter the flapping speed and intensity of the wing. All this can be done through the GUI in the upper right.
 
 
diff --git a/src/main.js b/src/main.js
index 9417544..d8f62f0 100755
--- a/src/main.js
+++ b/src/main.js
@@ -80,7 +80,7 @@ function onLoad(framework) {
 
     // set skybox
     var loader = new THREE.CubeTextureLoader();
-    var urlPrefix = 'Project2-Toolbox-Functions/images/skymap/';
+    var urlPrefix = 'images/skymap/';
 
     var skymap = new THREE.CubeTextureLoader().load([
         urlPrefix + 'px.jpg', urlPrefix + 'nx.jpg',
@@ -100,7 +100,7 @@ function onLoad(framework) {
 
     // load a simple obj mesh
     var objLoader = new THREE.OBJLoader();
-    objLoader.load('Project2-Toolbox-Functions/geo/feather.obj', function(obj) {
+    objLoader.load('geo/feather.obj', function(obj) {
 
         // LOOK: This function runs after the obj has finished loading
         featherGeo = obj.children[0].geometry;

From 3ce7292569dd5509ee1157f2a2bdb93d79483105 Mon Sep 17 00:00:00 2001
From: Joseph Gao <gaoj@seas.upenn.edu>
Date: Tue, 31 Jan 2017 23:25:24 -0500
Subject: [PATCH 9/9] final readme

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index db7e022..834029f 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,10 @@
 
 # Features Implemented
 
-Modeling 
+Modeling
 -------
 
-I based my wing and feather structure from that of an owl. 
+I based my wing and feather structure from that of an owl.
 
 To make the bone, I used QuadraticBezierCurve3 to sketch out its rough outline. I attempted to make the bone follow the general structure of an owl wing by finding points that would make the closest parabola possible. Once the Bezier curve was created, I distributed vertices evenly along the bone structure that would serve as the locations of the 100 feathers.
 
@@ -25,6 +25,6 @@ All the required interactivity features have been implemented, and the user is a
 
 Extra Credit
 ------------
-- No extra credit implemented for this homework. 
+No extra credit implemented for this homework.