htf-community

This readme is outdated! We’ll let you know about the changes during the workshop, and we’ll update this shortly afterwards for archival purposes.

WebGL Workshop

Part of ACM Hacktoberfest 2020

A Good Idea

It might be a good idea to clone this repo and test everything to make sure it works, and perhaps skim the code/comments so you already have an idea of what we’re doing before the workshop (not a requirement though; we’ll go through almost all of it again during the workshop). If you run into any issues, hit us up on Discord!

Overview

ACM Hacktoberfest is a one-day event celebrating open source with workshops and speakers about modern software practices.

What You’ll Learn

  1. How to use WebGL, a powerful Javascript API for high-performance graphics
  2. How to configure the graphics pipeline for your content
  3. How to write shaders for texturing and lighting

Technologies

Cloning via Git

There are two options for downloading this repository to your device (you only need to do one of these):

  1. Open your terminal and run git clone https://github.com/acmutd/htf-community.git
  2. Download the ZIP file

HTTP Server for Examples

In these examples, we demonstrate the use of textures to apply an image onto a 3D surface. This functionality is only available if you use a local HTTP server to run the examples, rather than double-clicking the HTML files.

If you’re using VS Code, you can open this repo and use the Live Server plugin to host the examples.

If you don’t want to use Live Server, follow these instructions to set up Python’s built-in HTTP server.

Additional notes for MDN instructions:

Deployment

After your pull request is approved, you’ll be able to see the finished product at community.acmutd.co.

Documentation

MDN’s WebGL API Reference is an indispensable resource for understanding the semantics of WebGL’s API calls. Don’t be intimidated by the number of functions listed - simply search for the name of a WebGL function you want to learn about (e.g. texImage2D) and follow the link to its reference, where you’ll see a list of accepted arguments accompanied by detailed explanations and example code. The code for this workshop is loosely based on MDN’s WebGL tutorial, so if a traditional online tutorial is more convenient for you than the workshop format, you should definitely check out that link.

Directory Layout

Stages

Inside each stage

More Important

Less Important