/term-project-20

term-project-20 created by GitHub Classroom

Primary LanguageJavaScript

Recordplayerinator 5000

Welcome to our team project for CS 174A, Spring Quarter 2019 at UCLA! Our project is a record player, as you may have surmised from the title.

Here's what you're looking at, sorted by contributor:

Note: fill out the TODO spots with a small explanation of the difficulties and complexities of that feature (for brownie points!)

Amanda:

  • A record player, complete with lid, body, spindle, and disc, modeled in Fusion360 and MeshMixer. The modeling wasn't too complex, as many of the parts are cylinders or boxes. The spindle was very difficult to model, and took roughly 5 hours to model due to complex construction planes. This was a bit more complicated than just modeling the objects. Because Fusion 360 does not export OBJ files with vertex normals, I had to find a workaround. I discovered that the program Autodesk Meshmixer can reexport OBJ files with vertex normals, but with the condition that all objects are moved to the origin. Unfortunately, Meshmixer also exports vertexes with extra vertices. So, I had to directly edit the OBJ file using Notepad++ and find-and-replace all instances of the extra vertices. Then finally, because Meshmixer repositioned and scaled all objects, I had to re-scale and re-position all the objects in the scene.
  • A wood shader applied to the body of the player. This generates wood grain using Simplex noise. Then, it uses a linear interpolation (lerp) and mix() in order to create the rings;
  • A toon shader applied to the spindle. This finds the distance from the uniform model matrix and a light vector to determine the shading on the object. After determining distances, it simply uses an array of brightness levels to color the object. The difficult part of this shader was figuring out how to pass the model matrix into the shader.
  • A cool water shader on the spinning record, with little waves oscillating about. The fragment shader, with adaptation from the vertex shader, wasn't too difficult except for the fact that the uv attribute was undefined. My workaround was using position.xz instead of uv to make fake UV mapping. The fragment shader performs most of the same calculations as the vertex shader, but the vertex shader uses the "color" as a multiplier to its y coordinate.
  • A fire/space shader. This also required fake UV mapping. The difficult part was that the shader I had based this on created a small flame in one region of the disk, and I had to change the UV mapping to cover more of the disk.
  • Disc playing. I made a box for the records and had it take out the records from the box. Then, I made it so clicking the "next song" button would toggle different shaders on the disc. Also, the song only plays when there is a disc present on the record player.
  • Lag issues. The pixelation shader was drawing every frame but only displaying when toggled, so I added an extra check to ensure that it would only be called when toggled.

Cynthia:

  • A particle shader that permeates the viewport with billboard---that's 2D elements (Squares) floating in a 3D space.
  • A particle class that utilized squares and is based on the Square class. The particle class calculates the center vertex of each square, uses the insert_transformed_copy_into() function to populate the area, and keeps track of an offset value to generate the billboard effect for the particles. Each individual particle was also scaled and transanslated by a random number to diversify its position and size. This step was not too complicated with the Professor's help and Piazza posts. However, it did take me a bit of time to understand how to construct the particle and how its individual parts relate to the big picture. I also had a bit of difficulty in trying to understand the use of the insert_transformed_copy_into function so I ended up basing my class on the Square class, which had also used the same function.
  • In addition to the particle class, I also created 2 particle shaders - one using color and one with texture. The vertex shaders use the arrays declared in the particle class to achieve the billboard effect. A piazza post helped a lot with this implementation but took me a while to fully understand how to execute it. I also added a wrap around feature so when particles left a specific range, they would be respawned on the other side. One of the most difficult obstacles I faced when creating these shaders was just figuring out what went wrong and how to integrate everything. I looked through a lot of online tutorials and guides to understand how to implement a particle system.
  • For the fragment shaders, the textured one is very similar to the colored one, however the textured one uses a texture image with a transparent background in addition to having color. I attempted to change among multiple colors but had a difficult time implementing a smooth transition from one color to the next and aligning it with a mathematical function. The colored shader is present to better display the billboard effect of the particles. While the textured shader also has the effect, the texture makes it slightly difficult to see the effect in place.

Angela:

  • A flowery shader. Tinkered with diplacement variables from the sun shader example in assignment 4 to make it look more like a flower. Used vector math to predict how vertices would be displaced (higher on the sides). Uses a perlin noise algorithm.
  • A trippy, mind-bending shader that we can't think of a name for (Cellular Noise is too boring). ANGELA TODO Taken from a 2-d cellular noise example I found online. The example used a built in attribute called u_resolution that I didn't have so I basically made my own u_resolution and made it a vec2 that represented the "resolution" of the disk (basically the size). Shader divides the normalized gl_coord into a grid and then draws points. I wanted to use something tht was different from the perlin noise algorithm so I found cellular noise, which is based on distance fields and is generated by getting neighboring random points using a gridlike algorithm and determining color through distance from the points. The result of this, when used with the step function was a super cool trippy shader.
  • A rainbow shader! :D This shader was almost entirely my own creation! Got some inspiration from a medium article that did simple sine wave displacement on a sphere and experimented to map that onto the disc. There were a lot of stages of the rainbow shader until I go it to look fuller. Didn't use any fancy noise functions, but that could've easily been added in.
  • Linking audio (see Arjun below) to the shaders on the disc, so it grooves to the sick beats we're dropping. Messed with the Web audio API to fill audio buffers (pitch and volume) with audio data from the songs arjun played. Then used a special type of uniform for int arrays to pass the audio data (freqData) into the rainbow shader. This is where I met some issues and wasn't able to get it to change the amplitudes of the shader.

Arjun:

  • A pixelation effect over the whole scene. This was accomplished using a shader that pixelates a supplied texture image, and a crude implementation of two-pass rendering. The scene with the record player is drawn but not displayed in the viewport; instead, it is saved to a texture. A Square is then drawn in front of the camera (anchored to the camera's position and rotation so that it is always in front and facing the camera), with the pixelation shader applied to it using the aforementioned texture. This effect is togglable, and the code allows for more effects that require two-pass rendering, such as Gaussian Blurs (which could not be implemented in time, unfortunately).
  • Audio controls. You can play and pause music, as well as cycle through various songs from a playlist that we have curated for you an album called Ember by Kubbi.
  • Fixing merge conflicts lmao (thanks arjun -angela)