Defold 1.6.4
Summary
- NEW: (#8364) Updated to Xcode 15.1, iOS 17.2 and macOS 14.2
- NEW: (#8353) Added options to control how json data is encoded and decoded
- NEW: (#8352) Generate a node id when cloning a gui node
- NEW: (#8336) Added engine loader fallback when WebAssembly streaming fails
- NEW: (#8255) Custom vertex format support for Models
- NEW: (#8296) Remove glfw from the engine builds
- NEW: (#8300) Dynamic resizing of collision shapes
- NEW: (#8330) Load images in runtime as buffers
- NEW: (#8419) Add new default filtering keyword for material samplers (Engine support)
- NEW: (#8421) Remove material count limit for models
-
NEW: (#8428) Added options in
sound.stop(url, [options])
where it’s possible to specify what exactly voice should be stopped - NEW: (#8416) New API functions: sys.load_buffer and sys.load_buffer_async
-
NEW: (#8429) Added
physics.set_listener(fn)
to set a function as the physics world listener - NEW: (#8258) Added sprite multitexture support
-
NEW: (#8456) New function
physics.update_mass(url, mass)
- NEW: (#8318) Select the default build server based on channel
- NEW: (#8375) Slightly improve editor memory usage for large projects
-
NEW: (#8434) Add
editor.create_directory()
and code completion to editor scripts -
NEW: (#8439) Add
physics.JOINT_TYPE_WHEEL
for 2d physics -
FIX: (#8310) Update node transform if adjust mode changed using
gui.set_adjust_mode()
- FIX: (#8338) Fix for outputting the correct skinned tangents
- FIX: (#8344) Buffered render buffers support
- FIX: (#8357) Add missing functions to null physics libraries
- FIX: (#8358) Set data correctly when recreating dynamic texture in gui
- FIX: (#8293) Compute shader support, part deux
- FIX: (#8367) Fix ogg-validate invocation for sounds from mounted extensions
- FIX: (#8369) Add hot reload functionality for label component.
-
FIX: (#8450) If the
hash
string is unknown, show its value instead. - FIX: (#8452) Remove redunant malloc in font_map
- FIX: (#8461) Fixed how mass is calculated for physics collision objects with more than one shape.
- FIX: (#8418) Don’t request LSP completions for dependencies
Engine
NEW: (#8364) Updated to Xcode 15.1, iOS 17.2 and macOS 14.2
NEW: (#8353) Added options to control how json data is encoded and decoded
It is now possible to configure the behaviour when encoding and decoding JSON data.
When encoding to JSON it is possible to control wether an empty Lua table should encode as a JSON object or array. The default behaviour when encoding an empty Lua table is to encode to a JSON object.
When decoding from JSON it is now possible to control wether a JSON null value should decode to json-null
or nil
. The default behaviour when decoding a JSON null value is to decode to nil.
local t = {}
json.encode(t, { encode_empty_table_as_object = true }) -- {}
json.encode(t, { encode_empty_table_as_object = false }) -- []
json.encode(t) -- {}
local s = "[ 1, 2, null, 3 ]"
json.decode(s, { decode_null_as_userdata = true}) -- { 1, 2, json.null, 4 }
json.decode(s, { decode_null_as_userdata = false}) -- { 1, 2, nil, 4 }
json.decode(s) -- { 1, 2, nil, 4 }
NEW: (#8352) Generate a node id when cloning a gui node
Cloned gui nodes are now automatically assigned a node id instead of an empty hash.
NEW: (#8336) Added engine loader fallback when WebAssembly streaming fails
The engine loader will now use XMLHttpRequest as a fallback when WebAssembly compilation and instantiation from a streamed source fails.
NEW: (#8255) Custom vertex format support for Models
We have added initial support for custom vertex formats for models.
NEW: (#8296) Remove glfw from the engine builds
GLFW is no longer being built as part of our main engine build. Instead, the current GLFW version (modified 2.7) is now begin built and distributed as an external package. We have also removed GLFW from our SDK, which means that some extensions might potentially break. This is considered a bugfix instead of a breaking change, since the headers should never have been part of the SDK from the first place.
This is the second part of our ongoing task (#7970) of migrating the current GLFW version to the latest stable official release, as well as separating all non-desktop platforms our of the GLFW infrastructure.
NEW: (#8300) Dynamic resizing of collision shapes
Added script functions to get and set collision shape sizes in runtime. The new functions are:
physics.get_shape(url, shape_name)
physics.set_shape(url, shape_name, table)
For example, to update the box shape my_box
for a collision object located at /go#collisionobject
:
local box = physics.get_shape("/go#collisionobject", "my_box")
box.dimensions = box.dimensions + vmath.vector3(5,10,15)
physics.set_shape("/go#collisionobject", "my_box", box)
NEW: (#8330) Load images in runtime as buffers
The image
script module now has a new function to return a buffer object. The new function is called image.load_buffer
and can be used to dynamically create texture resources in runtime:
local img = image.load_buffer(compressed_data)
-- img.buffer now contains an actual buffer object that can be passed into resource.create_texture
local tparams = {
width = img.width,
height = img.height,
type = resource.TEXTURE_TYPE_2D,
format = resource.TEXTURE_FORMAT_RGBA
}
local my_texture_id = resource.create_texture("/my_custom_texture.texturec", tparams, img.buffer)
NEW: (#8419) Add new default filtering keyword for material samplers (Engine support)
This PR adds new filtering keyword for material samplers called:
FILTER_MODE_MIN_DEFAULT
FILTER_MODE_MAG_DEFAULT
When using these settings on a sampler in the material, the engine will pick the global min and mag settings that is specified in the game.project -> graphics
setting. This can be useful for having a global base filtering method, while still being able to specialise settings per sampler if needed.
NEW: (#8421) Remove material count limit for models
We have removed the limit for how many materials a model component can reference.
NEW: (#8428) Added options in sound.stop(url, [options])
where it’s possible to specify what exactly voice should be stopped
Now it’s possible to stop one particular voice of the sound component:
sound.stop("#sound")
local id = sound.play("#sound")
sound.stop("#sound", {play_id = id}) -- stop only one voice
NEW: (#8416) New API functions: sys.load_buffer and sys.load_buffer_async
Two new script functions has been added:
function async_callback(self, request_id, status, buf)
-- do something with data here
end
local buf = sys.load_buffer(path)
local request_id = sys.load_buffer_async(path, callback)
These functions can be used to read data into a buffer object from either via the resource system, or direct file locations if the resource could not be found on any of the mounted resource locations. Meaning, the path supplied is not necessary a custom resource location, it can be any file on disk.
NEW: (#8429) Added physics.set_listener(fn)
to set a function as the physics world listener
Now, it is possible to set a function that will receive all physics interaction events in one place. If a function is set, physics messages will no longer be sent.
physics.set_listener(function(self, event, data)
if event == hash("contact_point_event") then
pprint(data)
-- {
-- applied_impulse = 310.00769042969,
-- distance = 0.0714111328125,
-- a = {
-- position = vmath.vector3(446, 371, 0),
-- relative_velocity = vmath.vector3(1.1722083854693e-06, -20.667181015015, -0),
-- mass = 0,
-- group = hash: [default],
-- id = hash: [/flat],
-- normal = vmath.vector3(-0, -1, -0)
-- },
-- b = {
-- position = vmath.vector3(185, 657.92858886719, 0),
-- relative_velocity = vmath.vector3(-1.1722083854693e-06, 20.667181015015, 0),
-- mass = 10,
-- group = hash: [default],
-- id = hash: [/go2],
-- normal = vmath.vector3(0, 1, 0)
-- }
-- }
elseif event == hash("collision_event") then
pprint(data)
-- {
-- a = {
-- group = hash: [default],
-- position = vmath.vector3(183, 666, 0),
-- id = hash: [/go1]
-- },
-- b = {
-- group = hash: [default],
-- position = vmath.vector3(185, 704.05865478516, 0),
-- id = hash: [/go2]
-- }
-- }
elseif event == hash("trigger_event") then
pprint(data)
-- {
-- enter = true,
-- b = {
-- group = hash: [default],
-- id = hash: [/go2]
-- },
-- a = {
-- group = hash: [default],
-- id = hash: [/go1]
-- }
-- },
elseif event == hash("ray_cast_response") then
pprint(data)
--{
-- group = hash: [default],
-- request_id = 0,
-- position = vmath.vector3(249.92222595215, 249.92222595215, 0),
-- fraction = 0.68759721517563,
-- normal = vmath.vector3(0, 1, 0),
-- id = hash: [/go]
-- }
elseif event == hash("ray_cast_missed") then
pprint(data)
-- {
-- request_id = 0
--},
end
end)
NEW: (#8456) New function physics.update_mass(url, mass)
Added new function physics.update_mass(url, mass)
which updates the mass of a dynamic 2D collision object in the physics world.
The function recalculates the density of each shape based on the total area of all shapes and the specified mass, then updates the mass of the body accordingly.
NEW: (#8258) Added sprite multitexture support
With the latest version, we now have support for multiple atlases in the sprite component.
To use it, you need a material and shader that has multiple samplers available.
The sprite will then display property fields where you can select an atlas for each sampler.
The animations shown are selected from the first sampler’s atlas.
The sprite will use this animation’s fps setting and frame names.
You will also need to match animations between atlases. If the default animation is “jump”, then it will automatically choose the “jump” animation from the other atlases as well.
It is also required that frames within the animations matches.
In a scenario where A.atlas
has animation jump
:
jump
frame1.png
frame2.png
Then B.atlas
needs this animation as well:
jump
frame_normal_1.png
frame_normal_1.png
In this case, the frame names don’t match, and you’ll need to use the rename_patterns
field to alter the frame names.
It is a comma separated list of patterns:
rename_patterns: _normal_=
In this example, it replaces the string “normal” with the string “”, resulting in the final animation/frame names for B.atlas
:
jump
frame1.png
frame1.png
The documentation has been updated: Showing 2D images
NEW: (#8439) Add physics.JOINT_TYPE_WHEEL
for 2d physics
Added physics.JOINT_TYPE_WHEEL
for 2d physics
FIX: (#8310) Update node transform if adjust mode changed using gui.set_adjust_mode()
Fix bug when adjust mode applied to a node only after window resize.
FIX: (#8338) Fix for outputting the correct skinned tangents
Due to a typo, the skinned tangents weren’t calculated correctly.
FIX: (#8344) Buffered render buffers support
Fixed an issue for certain graphics adapter where vertex and index buffers are overwritten during the same frame.
FIX: (#8357) Add missing functions to null physics libraries
FIX: (#8358) Set data correctly when recreating dynamic texture in gui
Bugfix for when recreating a deleted texture within the same frame in GUI:
gui.new_texture(tex_id, img.width, img.height, img.type, img.buffer)
gui.delete_texture(tex_id)
gui.new_texture(tex_id, img.width, img.height, img.type, img.buffer)
gui.set_texture(node, tex_id)
FIX: (#8293) Compute shader support, part deux
This is the second part of the compute shader support, this PR includes engine resources for the compute program and shaders needed to build the compute program. At this point we cannot still reference the compute programs anywhere in the engine (which is the next step - to formalize a user-facing API around this work).
FIX: (#8367) Fix ogg-validate invocation for sounds from mounted extensions
Copy ogg resource to temp file to deal with resources from mount points (e.g. extensions).
Ogg validation runs on temp ogg file now.
Temp files created into Bob root folder which removed at the end of the build.
FIX: (#8369) Add hot reload functionality for label component.
Add hot reload functionality for label component.
Reread properties from reloaded label resource and mark component to be rehashed.
FIX: (#8450) If the hash
string is unknown, show its value instead.
Instead of showing just <unknown>
when the corresponding string value is unknown, print its numeric value. For example:
<unknown:2256903789829718645>
FIX: (#8452) Remove redunant malloc in font_map
FIX: (#8461) Fixed how mass is calculated for physics collision objects with more than one shape.
Fixed a bug where the mass specified in the Collision Object component was applied to each shape, resulting in the object’s total mass becoming Collision Object mass
x Shapes count
.
With this fix, the mass will remain as specified in the Collision Object, and the density will be recalculated depending on it to be equal for each shape.
Editor
NEW: (#8318) Select the default build server based on channel
If the “Build Server” preference was never modified or is set to an empty string, the editor will pick either https://build-stage.defold.com or https://build.defold.com depending on the editor channel.
NEW: (#8375) Slightly improve editor memory usage for large projects
Slightly improve editor memory usage in projects with a large number of node endpoints. This typically corresponds to the number of files in the project, but varies significantly by file type.
Improves #8261
NEW: (#8434) Add editor.create_directory()
and code completion to editor scripts
This changeset adds a new function to editor scripts that allows the user to create a new directory. The function expects a resource path, i.e. a /
-prefixed path from the root of the project, for example:
editor.create_directory("/assets/generated")
local file = io.open("assets/generated/build.json")
file:write(...)
file:flush()
file:close()
Additionally, the editor now provides code completions for functions in the editor
module.
FIX: (#8418) Don’t request LSP completions for dependencies