unknownue / glslcookbook.rs Goto Github PK

View Code? Open in Web Editor NEW

2.0 1.0 1.0 30.58 MB

A Rust implementation of the book OpenGL 4 Shading Language Cookbook Third Editoin

Rust 79.41% GLSL 19.80% Shell 0.78%

opengl glsl cookbook rust-lang

glslcookbook.rs's Introduction

GLSLCookbook.rs

A Rust implementation of the book OpenGL 4 Shading Language Cookbook Third Editoin.

This repo uses glium as backend and is mainly written for learning GLSL.

Currently, except for chapter08 and chapter11, all examples have been tested on Windows and macOS.

How to run

# At project root directory
$ cargo run --example chapter01 # This will list the name of all available example in chapter01

$ cargo run --example chapter01 basic # This will run the example named basic in chapter01

If you find any programs fail to run on your platform or the incorrect image is rendered, welcome to create an issue.

glslcookbook.rs's People

Contributors

Stargazers

Watchers

Forkers

sjinno

glslcookbook.rs's Issues

Chapter06 tone-map example failed to read data from texture

glium does not suppot read format UncompressedFloatFormat::F32F32F32F32 from texture2d.
Related issue: glium/glium#1502.

Strange behavior when calling "insert_debug_marker()" method

GLSLCookbook.rs/src/scenerunner.rs

Lines 60 to 61 in 850e8e9

 display.insert_debug_marker("Start debugging") 

 .or_else(|_| { eprintln!("Current backend does not support Debug Marker"); Err(()) }).ok();

When running the above code on my windows machine, insert_debug_marker return Err(()) and "Start debugging" does not output to the console. It should means the backend doesn't support this functionality as explain in glium docs, but the debug message can print to console and seem work well.

When running the above code on my mbp running macOS 10.14.5, insert_debug_marker return Ok(()) which means this feature should be supported. But actually there aren't any debug message output to the console.

Some artifacts in Chapter10 particles example

The fps rate of this example is extremely slow and it fails to release the power of draw instanced.

Chapter06 hdr-bloom example seems under overexposure

There are some areas seem to be overexposure comparing to C++ implementation.
May be some rendering setting are wrong.

Chapter05 normal-map example renders incorrect image

The rendering effect of Chapter05 Normal-Map example is not the same with C++ version.
It seems like the normal map is applied to the incorrect texture coordinate.

Chapter05 proj-tex example renders incorrect image

Since glium does not provide interface to set wrap function for texture sampler equivalent to GL_CLAMP_TO_BORDER, this example renders an incorrect image.

The animation of fire example in Chapter10 is not continuous

Chapter06 ssao example renders incorrect image

The rendered image is not identical to the C++ implementation.
Keep this issue open to track this problem.

Adopt to EventLoop 2.0

When this project started on, the version of glium was 0.24. Since version 0.26 has been released, EventLoop 2.0 is also introduced which is a breaking change of its usage.
This repo currently still uses the old EventsLoop.

Examples in chapter11 currently can't implement.

Chapter11 introduce the usage of compute shader.
As said in glium/glium#1790, examples can't be implemented right now.

Chapter06 blur example failed to transfer uniform array to shader on macOS

When running chapter06 blur example, the rendering image looks darker. I found that the uniform array Weight does not set to the value I transfer from CPU.
After set the Weight as pre-calculate constants, the example finally renders the correct image.

Chapter08 shadow-map example render incorrect image

The shadow-map is basically implemented.
However some issues still haven't been dealt with:

the frustum in the rendering scene look at upper direction(it does not face to the object)
we still can't see the shadow.
polygon offset is not support, since this is the missing feature in glium.

There are some artifacts on the loading image

We can find some artifacts on texture rendering.
Examples in chapter05 including diff-ibl and render-to-tex share this issue.

	display.insert_debug_marker("Start debugging")
	.or_else(\|_\| { eprintln!("Current backend does not support Debug Marker"); Err(()) }).ok();