How to write a directional light shader in GLSL

Oscar de la Hera Gomez
Two flowers that represent ReactJS and ThreeJS with the text "Directional Light Shader" beneath them.

A step by step guide for coding a directional light shader in Typescript, ReactJS, ThreeJS, ViteJS and GLSL.

The solution that we carried out below can be found on the tutorial/three-js/light-shaders branch of our Open Source React, Typescript & ViteJS Starter Project.

To clone this project, paste the code found below in Terminal.

git clone git@github.com:delasign/reactjs-3js-vitejs-starter-project.git

The tutorial was made possible thanks to the work of OGLDev which provided the code for directional lights at the tutorial linked below.

Step One: Setup the Project

A screenshot of Chrome showing that the plane is now using the shader that we offer in this tutorial.

Follow the tutorials below to learn how to setup a Typescript & ViteJS project that works with a GLSL shader whose R, G, B color values can be adapted using dat.gui.

Step Two: Create the Typescript Types

A screenshot of VSCode showing the Typescript types for the BaseLight and the DirectionalLight.

Create two files in your project called BaseLight.tsx and the DirectionalLight.tsx and paste in the code found below.

We recommend that you place these under a types folder.

BaseLight.tsx

DirectionalLight.tsx

Step Three: Create the GLSL Structs

A screenshot of VSCode highlighting the structs for a directional light.

Create a new file called structs.glsl and paste in the code found below.

We recommend that you place this under a shaders folder and use this for all your shared shader structs as unlike react, you cannot include the same file multiple times in a shader.

Step Four: Create the GLSL Directional Light Functionality

A screenshot of VSCode highlighting the directional light glsl functionality.

Create a file called functionality.glsl and paste in the code found below.

We recommend that you place this under a folder called shaders and use this file for all your shared shader functionality as unlike react, you cannot include the same file multiple times in a shader.

Step Five: Create the GLSL Directional Light Shader

A screenshot of VSCode showing the directional light vertex and fragment shader.

Create a vertex.glsl and fragment.glsl file for your shader.

We recommend that you place these files under a directionalLight within a shaders folder.

Vertex Shader

Fragment Shader

Step Six: Update the Scene

A screenshot of VSCode showing the updated scene for the directional light.

Update the scene to make use of the vertex and fragment shader that you created in Step Four.

Make sure that the shader material includes the directionalLight and geometryBaseColor required for the shader created in Step Four.

Step Seven: Test

A screenshot of Chrome showing the directional light in action on a plane geometry.

Run the code and make sure that everything works as expected.

If you wish to include dat.gui sliders like we have, consult the tutorials below.

Looking to learn more about ReactJS and ThreeJS ?

Search our blog to find educational content on learning how to use ReactJS and ThreeJS.

Any Questions?

We are actively looking for feedback on how to improve this resource. Please send us a note to inquiries@delasign.com with any thoughts or feedback you may have.
delasign logo

Book a Free Consultation.

An icon of an email.

Click here to email us.

Fill in the details below to book a free consultation or to let us know about something else. Whatever it is, we are here to help.

How can we help you ?

Contact Details