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.
_format to function bbmod_surface_check, which is the surface format to use when the surface is created.Format to BBMOD_Cubemap, which is the format of created surfaces. Default value is surface_rgba8unorm.SurfaceOctahedron to BBMOD_Cubemap, which is a surface with the cubemap converted into an octahedral map._clearColor and _clearAlpha of method BBMOD_Cubemap.to_single_surface are now optional and they default to c_black and 1 respectively.to_octahedron to BBMOD_Cubemap, which converts the cubemap to an octahedral map.bbmod_vertex_buffer_load, which loads a vertex buffer from a file.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.DrawSprite, DrawSpriteExt, DrawSpriteGeneral, DrawSpritePart, DrawSpritePartExt, DrawSpritePos, DrawSpriteStretched, DrawSpriteStretchedExt, DrawSpriteTiled and DrawSpriteTiledExt to enum BBMOD_ERenderCommand, which are render commands for drawing sprites.DrawSprite, DrawSpriteExt, DrawSpriteGeneral, DrawSpritePart, DrawSpritePartExt, DrawSpritePos, DrawSpriteStretched, DrawSpriteStretchedExt, DrawSpriteTiled and DrawSpriteTiledExt to struct BBMOD_RenderQueue, which add respective commands into the queue.BBMOD_ReflectionProbe, which is used to capture surrounding scene at a specific position into a texture, which is then used for reflections.bbmod_reflection_probe_add, which adds a reflection probe to be sent to shaders.bbmod_reflection_probe_count, which retrieves number of reflection probes added to be sent to shaders.bbmod_reflection_probe_get, which retrieves a reflection probe at given index.bbmod_reflection_probe_find, which finds an enabled reflection probe at given position.bbmod_reflection_probe_remove, which removes a reflection probe so it is not sent to shaders anymore.bbmod_reflection_probe_remove_index, which removes a reflection probe so it is not sent to shaders anymore.bbmod_reflection_probe_clear, which removes all reflection probes sent to shaders.ReflectionCapture to BBMOD_ERenderPass, which is a render pass where objects are rendered into reflection probes.prefilter_ibl to BBMOD_Cubemap, which prefilters the cubemap for use with image based lighting.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.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.BBMOD_EShaderUniformType, which is an enumeration of shader uniform types.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.bbmod_material_props_set, using which you can set the current material property block.bbmod_material_props_get, using which you can retrieve the current material property block.bbmod_material_props_reset, using which you can unset the current material property block.ApplyMaterialProps to enum BBMOD_ERenderCommand, which is a render command to apply a material property block.SetMaterialProps to enum BBMOD_ERenderCommand, which is a render command to set current material property block.ResetMaterialProps to enum BBMOD_ERenderCommand, which is a render command to reset current material property block.apply_material_props to struct BBMOD_RenderQueue, which adds a BBMOD_ERenderCommand.ApplyMaterialProps command into the queue.set_material_props to struct BBMOD_RenderQueue, which adds a BBMOD_ERenderCommand.SetMaterialProps command into the queue.reset_material_props to struct BBMOD_RenderQueue, which adds a BBMOD_ERenderCommand.ResetMaterialProps command into the queue.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.BBMOD_U_TEXTURE_OFFSET, which is the name of a vertex shader uniform of type vec2 that holds offset of texture coordinates.BBMOD_U_TEXTURE_SCALE, which is the name of a vertex shader uniform of type vec2 that holds scale of texture coordinates.BBMOD_U_BONES, which is the name of a vertex shader uniform of type vec4[2 * BBMOD_MAX_BONES] that holds bone transformation data.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.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).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.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.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.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.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).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).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).BBMOD_U_NORMAL_W, which is the name of a fragment shader uniform of type sampler2D that holds normal smoothness/roughness texture.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).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.BBMOD_U_EMISSIVE, which is the name of a fragment shader uniform of type sampler2D that holds a texture with RGBM encoded emissive color.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.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.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.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.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.BBMOD_U_CAM_POS, which is the name of a fragment shader uniform of type vec3 that holds the world-space camera position.BBMOD_U_ZFAR, which is the name of a fragment shader uniform of type float that holds the distance to the far clipping plane.BBMOD_U_EXPOSURE, which is the name of a fragment shader uniform of type float that holds the camera exposure value.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.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.BBMOD_U_FOG_COLOR, which is the name of a fragment shader uniform of type vec4 that holds the fog color.BBMOD_U_FOG_INTENSITY, which is the name of a fragment shader uniform of type float that holds the maximum fog intensity.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.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.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.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.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.BBMOD_U_LIGHT_DIRECTIONAL_DIR, which is the name of a fragment shader uniform of type vec3 that holds the directional light's direction.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.BBMOD_U_SSAO, which is the name of a fragment shader uniform of type sampler2D that holds the screen-space ambient occlusion texture.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).BBMOD_U_IBL, which is the name of a fragment shader uniform of type sampler2D that holds the image based lighting texture.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.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.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.BBMOD_U_SPLATMAP, which is the name of a fragment shader uniform of type sampler2D that holds the splatmap texture.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.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).BBMOD_U_SHADOWMAP, which is the name of a fragment shader uniform of type sampler2D that holds the shadowmap texture.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.BBMOD_U_SHADOWMAP_AREA, which is the name of a fragment shader uniform of type float that holds the area that the shadowmap captures.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.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.BBMOD_MAX_PUNCTUAL_LIGHTS, which is the maximum number of punctual lights in shaders. Equals to 8.BBMOD_BaseShader.MaxPunctualLights is now read-only and deprecated. Please use the new macro BBMOD_MAX_PUNCTUAL_LIGHTS instead.Negate to structs BBMOD_Vec2, BBMOD_Vec3 and BBMOD_Vec4, which negates the vector and returns the result as a new vector.*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.BBMOD_MeshBuilder.make_tangents should now run faster.world_to_screen and screen_point_to_vec3 of BBMOD_BaseCamera, which returned coordinates mirrored on the Y axis on some platforms.BBMOD_Cubemap contents being flipped vertically on Windows.bbmod_instance_to_buffer when saving BBMOD_EPropertyType.RealArray properties.Copyright © 2023, BlueBurn. Built on September 11, 2023 using GMDoc.