Render stages for 3D primitives

[tederis]

This PR is aiming to fix a series of problems related to the purity of color of 3D lines and primitives(see #3399 and the discussion below #3321). It adds a new argument "stage" that can hold three values: "prefx", "postfx" and "postgui".

The syntax:

bool dxDrawLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ [, int color = 0xFFFFFFFF, float width = 1.0, bool postGUI = false / string stage = "prefx,postfx,postgui" ] )

bool dxDrawMaterialLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ, [ bool flipUV = false, ] element material, float width, [ int color = white, [ bool postGUI = false / string stage = "prefx,postfx,postgui", ] float faceTowardX, float faceTowardY, float faceTowardZ ] )

bool dxDrawMaterialSectionLine3D ( float startX, float startY, float startZ, float endX, float endY, float endZ, float u, float v, float usize, float vsize, [ bool flipUV = false, ] element material, float width, [ int color = white, [ bool postGUI = false / string stage = "prefx,postfx,postgui", ] float faceTowardX, float faceTowardY, float faceTowardZ ] )

bool dxDrawMaterialPrimitive3D ( primitiveType pType, mixed material, bool postGUI / string stage = "prefx,postfx,postgui", table vertex1 [, table vertex2, ...] )

bool dxDrawPrimitive3D ( string primitiveType, bool postGUI / string stage = "prefx,postfx,postgui", table vertex1, table vertex2, table vertex3 [, table vertex4, ...] )

To make colors correct out of the box the stage "postfx" is used by default. For the sake of backward compatibility the "postGUI" argument was preserved.

The meaning of render stages:

• prefx - Primitives are renderer before the color correction which leads to distorted primitive's colors. This render stage was known as postGUI = false.
• postfx - Primitives are renderer after the color correction. This is a new render stage that should be used in most situations as it fixes the colors distortion.
• postgui - Primitives are rendered after GUI. This render stage was known as postGUI = true.

The color that is used for these primitives: #4199d7.

[Nico8340]

Looks good 🎉

[Xenius97]

Something went wrong @tederis

If there is a 3D Material nearby, some dx images will be change to material's color.

https://streamable.com/fi91g1

[Xenius97]

https://streamable.com/d1cn9s

[tederis]

@Xenius97 Thanks for the report. I'll look into it.

[tederis]

@Xenius97 Thanks for the report. I'll look into it.

The fix: #3412