[UPDATE] LIGHTING IS HERE!

v 2.2.0

Nodes

• [ADDED] World Environment Node
• [ADDED] Point light node
• [ADDED] Spot light node

Functions

• [ADDED] fauxton_buffer_set_uniform_script(buffer_name_or_id, uniform_control_script)
• [MODIFIED] draw_sprite_3d OPTIONAL parameter 'enable_lighting'
• [MODIFIED] draw_sprite_3d_ext OPTIONAL parameter 'enable_lighting'

Fixed

• [FIXED] fauxton_buffer_set (Would return an error)

Lighting is here!! With Fauxton 3D you can easily add lighting to a scene by just adding an instance of WorldEnvironment and either point lights or spotlights! Fauxton supports up to 64 different spot/point lights. This can be changed, however, by going into shd_default and change all numbers in the fragment shader that are 64. Let's look at what each of these nodes contains! 

** NOTE **

If you override buffer shaders with your own you will have to calculate lighting in your new shader! It is suggested that you should duplicate the shd_default shader and its uniform script found in:

RenderPipeline 

    > pipeline_initiate() 

        > default_world_shader_set()

And then proceed to make your changes.

Fig 14

World Environment

First, we have the WorldEnvironment node. This node MUST be added to a room in order to enable lighting. There are a few options in this node under the Variable Definitions button.

Fig 15

The AmbientColor will be the color of the ‘shadows’ or rather the color of the scene facing away from the sun. Setting this to white ( $ffffff / c_white ) will make it so that the shadows are completely illuminated. 

The SunColor is the color of our scene lit from the SunPosition. The sun position is an array that contains an X, Y, and Z. These values should be between a value of -1 and 1. So for example:

Due to the fact that sprite-stacks are just a series of stacked planes on top of one another it should generally be avoided setting the sun's z-position to -1 (as you will not easily be able to see them illuminated from the bottom).

Point Lights

Point lights are SUPER easy to add-in. Once you have an instance of WorldEnvironment added to your room you can add up to 64 point or spot lights! You can find the attributes for point lights in the Variable Definitions:

Spot Lights

Spotlights are SUPER easy to add-in. Once you have an instance of WorldEnvironment added to your room you can add up to 64 point or spot lights! You can find the attributes for spotlights in the Variable Definitions:

NEW FUNCTIONS: fauxton_buffer_set_uniform_script

This function allows you to set a custom shader uniform control script for a buffer created using fauxton_buffer_create.

Syntax:

Returns:

Example:

First we create a script to control our grass shader called uniform_script. We then create a buffer, set the shader to shd_grass_sway and set the uniform control script to our uniform_script.