CS 457 / 557 -- Computer Graphics Shaders

Winter Quarter 2018

http://cs.oregonstate.edu/~mjb/cs557

Classes	Projects	Handouts	Grades	VHR	Piazza

This page was last updated: March 15, 2018

"Don't wake me for the end of the world unless it has very good special effects."

-- Roger Zelazny (science fiction writer)

Announcements:

• March 15, 2018
  My father (retired engineer, way too much web-browsing time on his hands) sends along one of the most amazing cat animations I've ever seen!

• March 13, 2018
  Alert Student Behnam Saeedi found this link to the Mozilla A-Frame API, which makes it easier to create WebGL.
  He also created a tutorial on how to use it.

• March 13, 2018
  Alert Student Sean Moore found a great source of texture images at https://3dtextures.me/

• February 27, 2018
  For February 28, please grab: Feb28.zip.

• February 27, 2018 Interested in helping out at this year's Oregon Game Project Challenge (OGPC) competition for middle- and high-schoolers? Go here for more information.
  (I volunteer here every year -- it is a lot of fun. I can tell you more if you want.)

• February 27, 2018 Way cool! Using computer graphics to look at an extinct animal. Remember this when we talk about using shaders for volume rendering.

• February 23, 2018
  For February 23, please grab: Feb23.zip.

• February 16, 2018
  For February 16, please grab: Feb16.zip.

• February 13, 2018
  For February 14, please grab: Feb14.zip.

• February 12, 2018 Wow! Drone 3D pixels at the Olympics Opening Ceremony! Go here to see it.
  (I've taken to calling these "droxels".)

• February 5, 2018 For more information on the EECS Networking Night, go here
  Both the Student Registration and Upload Resume links are under LINKS FOR STUDENTS in the upper-right.
  First, follow the About Companies link to see what companies are coming.

• January 29, 2018 Be aware that the CGEL is already being used:

  When	What
  Thursdays, 10:00-12:00	VR 419/519 class
  Saturday, May 3, 8:00-1:00	Outreach program for middle school girls

• January 29, 2018
  Here are the shaders to perform A-D-S lighting: LightingForClass.zip.

• January 29, 2018 Thursday, February 15 is Intel Day at OSU. Stand by for more details.

• January 25, 2018
  For Monday, please grab the file Jan29.zip and unzip it into its own folder.

• January 25, 2018
  Here is an MP4 recording of the cube mapping demo. This is here because our classroom computer doesn't support cube mapping.

• January 23, 2018
  For Friday, please grab the file Jan26.zip and unzip it into its own folder.

• January 16, 2018
  For Wednesday, please grab the file Jan17.zip and unzip it into its own folder.

• January 10, 2018
  For Friday, please grab the file Jan12.zip and unzip it into its own folder.

• January 8, 2018
  Go fill out this web form. This seeds my grading spreadhseet, email reflector, office hours, etc. Do this by the end of Tuesday, January 9!

• The "signature object" this quarter is a giraffe. Get the OBJ file here: giraffe.obj

• The OpenGL 4.6/GLSL 4.60 Reference Card can be found here.
  This isn't absolutely essential to print out, but it is really handy to have around.
  

• Here is a very fun computer graphics geometry video: Click here

• Check out this optical illusion. It will amaze you! Watch the video before reading the explanation.

• Here is an Online 3D Model Converter, which you might find handy to convert 3D model files into different formats for your own use.

• Check this out. A very impressive CGI video.

What We Will Be Doing

The goals of this course are to leave you "career-ready" (i.e., both work-ready and research-ready) for tasks that require the implementation of graphics algorithms in the form of shaders.

You will have access to the graphics systems in OSU's Computer Graphics Education Lab (CGEL) in Batcheller Hall 244. It is also a place to get access to the OpenGL Shading Language (GLSL), although you probably have it if you've bought a good graphics card in the last 3-4 years.

Access to the CGEL is by the card-reader chip in your OSU ID. I will be submitting a class roster to EECS so that you can all be enabled.

CS 457/557 topics include:

• A more advanced look at the graphics pipeline
• A more advanced look at transformations
• Lighting
• Color
• Opacity
• Step boundaries
• Smooth step boundaries
• Positional and gradient noise
• Fractional Brownian Motion (FBM, 1/f, octave) noise
• The OpenGL Shading Language (GLSL)
• GLSL Vertex shaders
• GLSL Fragment shaders
• GLSL Geometry shaders
• GLSL Tessellation shaders
• GLSL Compute shaders
• Using shaders in visualization
• Hiding data in textures
• Place one of your images on the "Class Poster"

Graphics Card Levels

If you are wondering what types of shaders your own graphics card supports, check this table. You can tell what shaders the card supports by looking at the Shader Model (or Shader Level) or what DirectX / OpenGL version it supports:

Shader Model	OpenGL	DirectX	Supporting
3.0	2.x	9	Vertex, Fragment
4.0	3.x	10	Geometry
5.0	4.x	11	Tessellation, Compute

We will cover all of these different types of shaders.

Prerequisites

Professor

Office:	Kelley 2117 (2nd floor, south side)
Phone:	541-737-2542
E-mail:	mjb@cs.oregonstate.edu

Prof. Bailey's Office Hours:

alsaleha@oregonstate.edu.

Ali's Office Hours:

Mondays	8:00 - 10:00, 11:00 - 1:00	CGEL (Bat 244)
Tuesdays	8:00 - 1:00	CGEL (Bat 244)
Wednesdays	8:00 - 10:00, 11:00 - 1:00	CGEL (Bat 244)
Thursdays	8:00 - 1:00	CGEL (Bat 244)
Fridays	8:00 - 10:00	CGEL (Bat 244)

The Virtual Hand Raise (VHR)

It takes courage to ask a question in class. But, the worst thing of all is to not ask! So, this class also has the Virtual Hand Raise. Click here to get into it. It will allow you to send me a question or comment, completely anonymously. I will answer questions submitted this way by email to the class or in class.

Optional Textbook

Other Good References

Handouts

Class Schedule

To see an Academic Year calendar, click here.

Class time is: Monday, Wednesday, and Friday, 10:00 - 10:50.

Be sure to check the class room in the table below to see what days we will be in Weniger 149 and what days we will be in the Computer Graphics Education Lab (CGEL -- Batcheller Hall room 244).

	Date	Room	Topics
1	Jan 8	Wngr 149	Introductions. General course information. Project #1. The graphics pipeline -- how it really works. Homogeneous coordinates. Coordinate systems: Model, World, Eye, NDC, Clip, Screen.
2	Jan 10	Wngr 149	Introduction to the OpenGL Shading Language (GLSL) Attribute, Uniform, and Varying variables GLSL built-in functions and variables glman Vertex shaders
3	Jan 12	Wngr 149	Grab the file Jan12.zip and unzip it into its own folder. Stripes in model vs. world coordinates The smoothstep( ) function Checkers Z-buffer pollution
4	Jan 15	-----	Martin Luther King holiday -- no class today
5	Jan 17	Wngr 149	Geometry Morphing GLSL Textures: unsigned byte, floating point, 2D, 3D, parameters, binding, texture units, multitextures, sampler functions Noise: Positional, Gradient. Cubic and quintic interpolation. Fractional Brownian Motion (FBM, 1/f), turbulence. glman Noise
6	Jan 19	-----	Prof. Bailey out of the office -- no class today -- sorry.
7	Jan 22	Wngr 149	More noise.
8	Jan 24	Wngr 149	Noise stripes
9	Jan 26	Wngr 149	More fun with vertex shaders: Dome projection,
10	Jan 29	Wngr 149	More fun with vertex shaders: Hyperbolic geometry. Fragment Shaders, I Lighting
11	Jan 31	Wngr 149	Fragment Shaders, II
12	Feb 2	Wngr 149	Cube mapping. Reflection, Refraction. Happy Ground Hogs Day!
13	Feb 5	Wngr 149	Test #1 review. Cube mapping, continued.
14	Feb 7	Wngr 149	Bump mapping, I
15	Feb 9	Wngr 149	Test #1
16	Feb 12	Wngr 149	Discuss the Final Project. Image Manipulation, I Don't forget that Valentine's Day is in two days!
17	Feb 14	Wngr 149	Go over test answers Image Manipulation, II Happy Valentine's Day!
18	Feb 16	Wngr 149	The optics of rainbows The optics of diffraction The optics of lenses
19	Feb 19	Wngr 149	Geometry Shaders, I
20	Feb 21	Wngr 149	Geometry Shaders, II The Winter Quarter Career Fair is today!
21	Feb 23	Wngr 149	Written Final Project proposals due Finish Geometry Shaders
22	Feb 26	Wngr 149	The GLSL API. The glslprogram C++ class.
23	Feb 28	Wngr 149	Tessellation shaders, I
24	March 2	Wngr 149	Tessellation shaders, II
25	March 5	Wngr 149	Scientific Visualization using shaders
26	March 7	Wngr 149	Scientific Visualization using shaders
27	March 9	Wngr 149	Compute Shaders Click here to see the Compute Shader particle system from the class notes.
28	March 12	Wngr 149	Compute Shaders Vulkan
29	March 14	Wngr 149	Class Evaluations Test #2 review. More Information
30	March 16	Wngr 149	Help session. Review session.
*	March 22	Wngr 149	Test #2 Tuesday, March 20, 6:00 PM - 7:30 PM. You can confirm this for yourself by going here.

Projects

Project Turn-In Procedures

• Your project turnins will be electronic.

• Your electronic turnin will be done at http://engr.oregonstate.edu/teach and will consist of:
  
  1. A PDF report. The PDF file should include:
     • A cover page (name, email address, project name)
     • Images
     • Key snippets of code
     • The link to a Kaltura video demonstrating that your project does what the requirements ask for. Narrate your video so that you can tell me what it is doing.
  2. Source files of everything (.glib, .vert, .frag, .geom, .tcs, .tes).

• You can zip up all the files you are turning in except the PDF. Please turn it in separately so I can run my gather-up-all-the-PDFs script.

• Submissions are due at 23:59:59 on the listed due date.

• I know some of you know the Cg and HLSL languages for shaders, but all GPU assignments must be done in GLSL.

• Your project will be graded and the score posted to the class web page.
  If you want to know why you did not receive full credit, send me an email asking about it, or see me during Office Hours.
  You have one week to do this.

Bonus Days and Late Assignments

Projects are due at 23:59:59 on the listed due date, with the following exception:

Each of you has been granted 5 Bonus Days, which are no-questions-asked one-day extensions which may be applied to any project, subject to the following rules:

1. No more than 2 Bonus Days may be applied to any one project
2. Bonus Days cannot be applied to tests
3. Bonus Days cannot be applied such that they extend a project due date past the start of Test #2.

Click here to get a copy of the Bonus Day Submission Form. Fill this out and turn it in within a week after turning in your project.

Grading

Click here to see the current grade posting.

CS 557 will be graded on a fill-the-bucket basis. There will be 7 projects, 10 quizzes, and two tests. You get to keep all the points you earn.

Your final grade will be based on your overall class point total. Based on an available point total of 1120, grade cutoffs will be no higher than:

Points	Grade
1070	A
1050	A-
1030	B+
1010	B
990	B-
970	C+
950	C
930	C-
910	D+
890	D
870	D-

Notice that this grade scale is not 90%-80%-70%-60%. That is because I do a soft grade on the projects.

Downloadable Files

1. OpenGL/GLSL-related files
2. .obj files

3. Want to use the Kelley Atrium in a cube map? Here are the files:
   kec.posx.bmp
   kec.negx.bmp
   kec.posy.bmp
   kec.negy.bmp
   kec.posz.bmp
   kec.negz.bmp

Executables

These executables are all loaded on the CGEL machines, but you can also get them here in case you want to run them on other Windows machines.

1. noisegraph.exe
2. glman.exe

The bvrman executable is not included here because it looks for a local copy of RenderMan in order to work. Unless you have RenderMan installed on your own computer, you will need to do the RenderMan work in the CGEL.

You might also need these dlls:

1. glew32.dll
2. glut32.dll
3. libcd.dll
4. libcid.dll
5. msvcr71d.dll

Class Rules

• Lab Rules: No propping the CGEL doors open, no food in the lab, drinks only in closed containers. (I am not being a mindless jerk about the no-food requirement -- ask me to see my shrine to the cockroaches that once inhabited the CGEL. Their friends are no doubt waiting for a reason to come back.)

• Keep the air conditioning running -- we have had problems with systems in that room failing because the temperature gets too high.

• Computer Security: We take computer security very seriously. Please use intelligently-chosen passwords and protect them. Anyone caught abusing the system or causing deliberate damage will be asked to drop the class and the matter will be turned over to the Dean's Office.

• Working Together: It is OK to work together by sharing information and teaching each other, but each person's projects must be original work with no sharing of code.

• Cheating: You are expected to do your own work. Sharing code is considered cheating. Anyone caught cheating will fail this class, and the matter will be turned over to the Dean's Office.

• Academic Dishonesty: You are expected to read and understand Oregon State University's Code of Student Conduct.

Students With Disabilities

Accommodations for students with disabilities are determined and approved by Disability Access Services (DAS). If you, as a student, believe you are elig ible for accommodations but have not obtained approval please contact DAS immediately at 541-737-4098 or at http://ds.oregonstate.edu.DAS notifies students and faculty members of approved academic accommodations and coordinates implementation of those accommodations. While not required, students and faculty members are encouraged to discuss details of the implementation of individual accommodations.

Religious Holidays

Oregon State University strives to respect all religious practices. If you have religious holidays that are in conflict with any of the requirements of this class, please see me immediately so that we can make alternative arrangements.

Other Useful Online Graphics and Shader Information

• OpenGL:
  • Industry-wide OpenGL Information: http://www.opengl.org
  • The OpenGL 1.1 State Machine Diagram http://www.opengl.org/documentation/specs/version1.1/state.pdf
  • Free OpenGL textbook rscfullbook.pdf
  • Another free OpenGL textbook http://openglbook.com/
  • The OpenGL 4.5 Reference Card can be found here.
    The OpenGL 4.6 Reference Card can be found here.
    Neither of these is absolutely essential to print out, but they can be really handy to have around.
  • OpenGL Man Pages: http://www.cs.rutgers.edu/~decarlo/428/glman.html

• The GLUT Library:
  • HTML GLUT Documentation: http://www.opengl.org/documentation/specs/glut/spec3/spec3.html
  • PDF GLUT Documentation: http://www.opengl.org/documentation/specs/glut/glut-3.spec.pdf

• The GLUI Library:
  • OpenGL User Interface (GLUI) Documentation http://www.cs.unc.edu/~rademach/glui/src/release/glui_manual_v2_beta.pdf
  • General GLUI Information http://www.cs.unc.edu/~rademach/glui

• GLSL:

• WebGL:
  • Khronos group's WebGL Page: http://khronos.org/webgl
  • OSU WebGL site: http://cs.oregonstate.edu/~mjb/webgl
  • three.js: http://threejs.org/
  • JQuery user interface: http://api.jqueryui.com/
  • Ed Angel's WebGL site for his book examples: http://www.cs.unm.edu/~angel/BOOK/INTERACTIVE_COMPUTER_GRAPHICS/SIXTH_EDITION/CODE/WebGL/

• SIGGRAPH (The Special Interest Group on Computer Graphics): http://www.siggraph.org

• SIGGRAPH Online Computer Graphics Bibliography Database: http://www.siggraph.org/learn/computer-graphics-bibliography-database

• Game Information:
  • Game Developer: http://www.gamedev.net
  • Gamasutra: http://www.gamasutra.com

• 3D Models you can download:
  • Free 3D Models: http://thefree3dmodels.com
  • Free 3D: https://free3d.com
  • Level of Detail book support (free): http://lodbook.com/models
  • Florida State (free): http://people.sc.fsu.edu/~jburkardt/data/data.html
  • Buy 3D Models (but these are free): http://www.buy3dmodels.com/free3dmodels.php
  • ChromeSphere: http://www.chromesphere.com/3dmodels.html
  • TurboSquid: http://www.turbosquid.com/Search/3D-Models/free/obj
  • Remnants of the old Avalon site (free): ftp://ftp.uniovi.es/pub/mirrors/avalon.viewpoint.com/objects/
  • Digimation (costs money): http://www.digimation.com

• Interesting visualization of the world's intercontinental networks http://www.cablemap.info/

• WebGL isosurface of low-frequency 3D noise function http://kirox.de/test/Surface.html