Skip to content

3.17.0
Compare
Choose a tag to compare
@kraifpatrik kraifpatrik released this 02 May 07:53
3.17.0
b8c2bfb

The main new feature of this release are reflection probes, which are used to capture surrounding scene at a specific position into a texture, which is then used for reflections. You can have as many reflection probes as you like, but currently only one reflection probe is used when the camera enters its area of influence. There is a smooth transition when changing from one reflection probe to other. BBMOD now also has material property blocks, which are useful in case you want to render multiple models using the same material and only change a few properties for each model. Using material property blocks should lead into better performance than creating a clone of a material for each model. Other noteworthy updates included are fixed Gizmo module, new commands for rendering sprites through render queues and new *Self/*Other variations of methods of vectors, quaternions and matrices, which instead of creating new structs store the result into self or a struct passed in as an argument, which makes them more garbage collector-friendly.

Changelog:

  • Added an optional argument _format to function bbmod_surface_check, which is the surface format to use when the surface is created.
  • Added new property Format to BBMOD_Cubemap, which is the format of created surfaces. Default value is surface_rgba8unorm.
  • Added new property SurfaceOctahedron to BBMOD_Cubemap, which is a surface with the cubemap converted into an octahedral map.
  • Arguments of _clearColor and _clearAlpha of method BBMOD_Cubemap.to_single_surface are now optional and they default to c_black and 1 respectively.
  • Added new method to_octahedron to BBMOD_Cubemap, which converts the cubemap to an octahedral map.
  • Added new function bbmod_vertex_buffer_load, which loads a vertex buffer from a file.
  • For each method of BBMOD_RenderQueue that adds a render command into the queue there is now an equivalent function with an UpperCamelCase name (matching the command name defined in BBMOD_ERenderCommand). Please from now on use these methods instead of the original ones, as they are now deprecated.
  • Added new members DrawSprite, DrawSpriteExt, DrawSpriteGeneral, DrawSpritePart, DrawSpritePartExt, DrawSpritePos, DrawSpriteStretched, DrawSpriteStretchedExt, DrawSpriteTiled and DrawSpriteTiledExt to enum BBMOD_ERenderCommand, which are render commands for drawing sprites.
  • Added new methods DrawSprite, DrawSpriteExt, DrawSpriteGeneral, DrawSpritePart, DrawSpritePartExt, DrawSpritePos, DrawSpriteStretched, DrawSpriteStretchedExt, DrawSpriteTiled and DrawSpriteTiledExt to struct BBMOD_RenderQueue, which add respective commands into the queue.
  • Added new struct BBMOD_ReflectionProbe, which is used to capture surrounding scene at a specific position into a texture, which is then used for reflections.
  • Added new function bbmod_reflection_probe_add, which adds a reflection probe to be sent to shaders.
  • Added new function bbmod_reflection_probe_count, which retrieves number of reflection probes added to be sent to shaders.
  • Added new function bbmod_reflection_probe_get, which retrieves a reflection probe at given index.
  • Added new function bbmod_reflection_probe_find, which finds an enabled reflection probe at given position.
  • Added new function bbmod_reflection_probe_remove, which removes a reflection probe so it is not sent to shaders anymore.
  • Added new function bbmod_reflection_probe_remove_index, which removes a reflection probe so it is not sent to shaders anymore.
  • Added new function bbmod_reflection_probe_clear, which removes all reflection probes sent to shaders.
  • Added new member ReflectionCapture to BBMOD_ERenderPass, which is a render pass where objects are rendered into reflection probes.
  • Added new method prefilter_ibl to BBMOD_Cubemap, which prefilters the cubemap for use with image based lighting.
  • Materials BBMOD_MATERIAL_SKY, BBMOD_MATERIAL_TERRAIN and BBMOD_MATERIAL_TERRAIN_UNLIT now have a shader for the new BBMOD_ERenderPass.ReflectionCapture pass, so they are visible in reflection probes.
  • Added new property RenderPass to struct BBMOD_Light, which is bitwise OR of 1 << render pass in which the light is enabled. By default this is BBMOD_ERenderPass.Forward and BBMOD_ERenderPass.ReflectionCapture, which means the light is visible only in the forward render pass and during capture of reflection probes.
  • Added new enum BBMOD_EShaderUniformType, which is an enumeration of shader uniform types.
  • Added new struct BBMOD_MaterialPropertyBlock, which is a collection of material properties. Useful in case you want to use the same material when rendering multiple models and only change some of its properties for each model.
  • Added new function bbmod_material_props_set, using which you can set the current material property block.
  • Added new function bbmod_material_props_get, using which you can retrieve the current material property block.
  • Added new function bbmod_material_props_reset, using which you can unset the current material property block.
  • Added new member ApplyMaterialProps to enum BBMOD_ERenderCommand, which is a render command to apply a material property block.
  • Added new member SetMaterialProps to enum BBMOD_ERenderCommand, which is a render command to set current material property block.
  • Added new member ResetMaterialProps to enum BBMOD_ERenderCommand, which is a render command to reset current material property block.
  • Added new method apply_material_props to struct BBMOD_RenderQueue, which adds a BBMOD_ERenderCommand.ApplyMaterialProps command into the queue.
  • Added new method set_material_props to struct BBMOD_RenderQueue, which adds a BBMOD_ERenderCommand.SetMaterialProps command into the queue.
  • Added new method reset_material_props to struct BBMOD_RenderQueue, which adds a BBMOD_ERenderCommand.ResetMaterialProps command into the queue.
  • Added new macro BBMOD_U_NORMAL_MATRIX, which is the name of a vertex shader uniform of type mat4 that holds a matrix using which normal vectors of vertices are transformed.
  • Added new macro BBMOD_U_TEXTURE_OFFSET, which is the name of a vertex shader uniform of type vec2 that holds offset of texture coordinates.
  • Added new macro BBMOD_U_TEXTURE_SCALE, which is the name of a vertex shader uniform of type vec2 that holds scale of texture coordinates.
  • Added new macro BBMOD_U_BONES, which is the name of a vertex shader uniform of type vec4[2 * BBMOD_MAX_BONES] that holds bone transformation data.
  • Added new macro BBMOD_U_BATCH_DATA, which is the name of a vertex shader uniform of type vec4[BBMOD_MAX_BATCH_VEC4S] that holds dynamic batching data.
  • Added new macro BBMOD_U_SHADOWMAP_ENABLE_VS, which is the name of a vertex shader uniform of type float that holds whether shadowmapping is enabled (1.0) or disabled (0.0).
  • Added new macro BBMOD_U_SHADOWMAP_MATRIX, which is the name of a vertex shader uniform of type mat4 that holds a matrix that transforms vertices from world-space to shadowmap-space.
  • Added new macro BBMOD_U_SHADOWMAP_NORMAL_OFFSET, which is the name of a vertex shader uniform of type float that holds how much are vertices offset by their normal before they are transformed into shadowmap-space, using formula vertex + normal * normalOffset.
  • Added new macro BBMOD_U_INSTANCE_ID, which is the name of a fragment shader uniform of type vec4 that holds an ID of the instance that draws the model, encoded into a color.
  • Added new macro BBMOD_U_MATERIAL_INDEX, which is the name of a fragment shader uniform of type float that holds the index of the current material within array BBMOD_Model.Materials.
  • Added new macro BBMOD_U_BASE_OPACITY_MULTIPLIER, which is the name of a fragment shader uniform of type vec4 that holds a multiplier for the base opacity texture (gm_BaseTexture).
  • Added new macro BBMOD_U_IS_ROUGHNESS, which is the name of a fragment shader uniform of type float that holds whether the material uses roughness workflow (1.0) or not (0.0).
  • Added new macro BBMOD_U_IS_METALLIC, which is the name of a fragment shader uniform of type float that holds whether the material uses metallic workflow (1.0) or not (0.0).
  • Added new macro BBMOD_U_NORMAL_W, which is the name of a fragment shader uniform of type sampler2D that holds normal smoothness/roughness texture.
  • Added new macro BBMOD_U_MATERIAL, which is the name of a fragment shader uniform of type sampler2D that holds a texture with either metalness in the R channel and ambient occlusion in the G channel (for materials using metallic workflow), or specular color in RGB (for materials using specular color workflow).
  • Added new macro BBMOD_U_SUBSURFACE, which is the name of a fragment shader uniform of type sampler2D that holds a texture with subsurface color in RGB and subsurface effect intensity (or model thickness) in the A channel.
  • Added new macro BBMOD_U_EMISSIVE, which is the name of a fragment shader uniform of type sampler2D that holds a texture with RGBM encoded emissive color.
  • Added new macro BBMOD_U_LIGHTMAP, which is the name of a fragment shader uniform of type sampler2D that holds a texture with a baked lightmap applied to the model.
  • Added new macro BBMOD_U_BASE_OPACITY_UV, which is the name of a fragment shader uniform of type vec4 that holds top left and bottom right coordinates of the base opacity texture on its texture page.
  • Added new macro BBMOD_U_NORMAL_W_UV, which is the name of a fragment shader uniform of type vec4 that holds top left and bottom right coordinates of the normal texture on its texture page.
  • Added new macro BBMOD_U_MATERIAL_UV, which is the name of a fragment shader uniform of type vec4 that holds top left and bottom right coordinates of the material texture on its texture page.
  • Added new macro BBMOD_U_ALPHA_TEST, which is the name of a fragment shader uniform of type float that holds the alpha test threshold value. Fragments with alpha less than this value are discarded.
  • Added new macro BBMOD_U_CAM_POS, which is the name of a fragment shader uniform of type vec3 that holds the world-space camera position.
  • Added new macro BBMOD_U_ZFAR, which is the name of a fragment shader uniform of type float that holds the distance to the far clipping plane.
  • Added new macro BBMOD_U_EXPOSURE, which is the name of a fragment shader uniform of type float that holds the camera exposure value.
  • Added new macro BBMOD_U_GBUFFER, which is the name of a fragment shader uniform of type sampler2D that holds the G-buffer texture. This can also be just the depth texture in a forward rendering pipeline.
  • Added new macro BBMOD_U_SOFT_DISTANCE, which is the name of a fragment shader uniform of type float that holds a distance over which particles smoothly disappear when intersecting with geometry in the depth buffer.
  • Added new macro BBMOD_U_FOG_COLOR, which is the name of a fragment shader uniform of type vec4 that holds the fog color.
  • Added new macro BBMOD_U_FOG_INTENSITY, which is the name of a fragment shader uniform of type float that holds the maximum fog intensity.
  • Added new macro BBMOD_U_FOG_START, which is the name of a fragment shader uniform of type float that holds the distance from the camera at which the fog starts.
  • Added new macro BBMOD_U_FOG_RCP_RANGE, which is the name of a fragment shader uniform of type float that holds 1.0 / (fogEnd - fogStart), where fogEnd is the distance from the camera where fog reaches its maximum intensity and fogStart is the distance from camera where the fog begins.
  • Added new macro BBMOD_U_LIGHT_AMBIENT_DIR_UP, which is the name of a fragment shader uniform of type vec3 that holds the ambient light's up vector.
  • Added new macro BBMOD_U_LIGHT_AMBIENT_UP, which is the name of a fragment shader uniform of type vec4 that holds the ambient light color on the upper hemisphere.
  • Added new macro BBMOD_U_LIGHT_AMBIENT_DOWN, which is the name of a fragment shader uniform of type vec4 that holds the ambient light color on the lower hemisphere.
  • Added new macro BBMOD_U_LIGHT_DIRECTIONAL_DIR, which is the name of a fragment shader uniform of type vec3 that holds the directional light's direction.
  • Added new macro BBMOD_U_LIGHT_DIRECTIONAL_COLOR, which is the name of a fragment shader uniform of type vec4 that holds the directional light's color in RGB and intensity in the A channel.
  • Added new macro BBMOD_U_SSAO, which is the name of a fragment shader uniform of type sampler2D that holds the screen-space ambient occlusion texture.
  • Added new macro BBMOD_U_IBL_ENABLE, which is the name of a fragment shader uniform of type float that holds whether image based lighting is enabled (1.0) or disabled (0.0).
  • Added new macro BBMOD_U_IBL, which is the name of a fragment shader uniform of type sampler2D that holds the image based lighting texture.
  • Added new macro BBMOD_U_IBL_TEXEL, which is the name of a fragment shader uniform of type vec2 that holds the texel size of image based lighting texture.
  • Added new macro BBMOD_U_LIGHT_PUNCTUAL_DATA_A, which is the name of a fragment shader uniform of type vec4[2 * BBMOD_MAX_PUNCTUAL_LIGHTS] that holds vectors (x, y, z, range) and (r, g, b, intensity) for each punctual light.
  • Added new macro BBMOD_U_LIGHT_PUNCTUAL_DATA_B, which is the name of a fragment shader uniform of type vec3[2 * BBMOD_MAX_PUNCTUAL_LIGHTS] that holds vectors (isSpotLight, dcosInner, dcosOuter) and (dirX, dirY, dirZ) for each punctual light.
  • Added new macro BBMOD_U_SPLATMAP, which is the name of a fragment shader uniform of type sampler2D that holds the splatmap texture.
  • Added new macro BBMOD_U_SPLATMAP_INDEX, which is the name of a fragment shader uniform of type int that holds the index of a channel to read from the splatmap.
  • Added new macro BBMOD_U_SHADOWMAP_ENABLE_PS, which is the name of a fragment shader uniform of type float that holds whether shadowmapping is enabled (1.0) or disabled (0.0).
  • Added new macro BBMOD_U_SHADOWMAP, which is the name of a fragment shader uniform of type sampler2D that holds the shadowmap texture.
  • Added new macro BBMOD_U_SHADOWMAP_TEXEL, which is the name of a fragment shader uniform of type vec2 that holds the texel size of a shadowmap texture.
  • Added new macro BBMOD_U_SHADOWMAP_AREA, which is the name of a fragment shader uniform of type float that holds the area that the shadowmap captures.
  • Added new macro BBMOD_U_SHADOWMAP_BIAS, which is the name of a fragment shader uniform of type float that holds the distance over which models smoothly transition into shadow. Useful for example for volumetric look of particles.
  • Added new macro BBMOD_U_SHADOW_CASTER_INDEX, which is the name of a fragment shader uniform of type float that holds the index of a punctual light that casts shadows or -1.0, if it's the directional light.
  • Added new macro BBMOD_MAX_PUNCTUAL_LIGHTS, which is the maximum number of punctual lights in shaders. Equals to 8.
  • Property BBMOD_BaseShader.MaxPunctualLights is now read-only and deprecated. Please use the new macro BBMOD_MAX_PUNCTUAL_LIGHTS instead.
  • Added new method Negate to structs BBMOD_Vec2, BBMOD_Vec3 and BBMOD_Vec4, which negates the vector and returns the result as a new vector.
  • Added *Self and *Other variations of methods of structs BBMOD_Vec2, BBMOD_Vec3, BBMOD_Vec4, BBMOD_Quaternion, BBMOD_DualQuaternion and BBMOD_Matrix, which instead of creating new struct store the result into themselves or the other struct passed in as an argument.
  • Method BBMOD_MeshBuilder.make_tangents should now run faster.
  • Fixed methods world_to_screen and screen_point_to_vec3 of BBMOD_BaseCamera, which returned coordinates mirrored on the Y axis on some platforms.
  • Fixed BBMOD_Cubemap contents being flipped vertically on Windows.
  • Fixed crash in bbmod_instance_to_buffer when saving BBMOD_EPropertyType.RealArray properties.
  • Fixed gizmo, which did not work after update 3.16.8.
Assets 3
Loading