205 box2d scripting queries

physics/box2d_queries/all.texture_profiles

@@ -0,0 +1,18 @@
+path_settings {
+  path: "**"
+  profile: "Default"
+}
+profiles {
+  name: "Default"
+  platforms {
+    os: OS_ID_GENERIC
+    formats {
+      format: TEXTURE_FORMAT_RGBA
+      compression_level: BEST
+      compression_type: COMPRESSION_TYPE_DEFAULT
+    }
+    mipmaps: false
+    max_texture_size: 0
+    premultiply_alpha: true
+  }
+}

physics/box2d_queries/assets/fonts/text28.font

@@ -0,0 +1,5 @@
+font: "/assets/fonts/SourceSansPro-Semibold.ttf"
+material: "/builtins/fonts/font-df.material"
+size: 28
+output_format: TYPE_DISTANCE_FIELD
+characters: " !\"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~"

physics/box2d_queries/assets/images/textures.atlas

@@ -0,0 +1,13 @@
+images {
+  image: "/assets/images/pixel_white.png"
+}
+images {
+  image: "/assets/images/triangle_white.png"
+}
+images {
+  image: "/assets/images/diamond_white.png"
+}
+images {
+  image: "/assets/images/ball.png"
+}
+extrude_borders: 2

physics/box2d_queries/assets/shapes/diamond_target.convexshape

@@ -0,0 +1,13 @@
+shape_type: TYPE_HULL
+data: -30.0
+data: 0.0
+data: 0.0
+data: 0.0
+data: -30.0
+data: 0.0
+data: 30.0
+data: 0.0
+data: 0.0
+data: 0.0
+data: 30.0
+data: 0.0

physics/box2d_queries/assets/shapes/triangle_target.convexshape

@@ -0,0 +1,10 @@
+shape_type: TYPE_HULL
+data: -28.0
+data: -28.0
+data: 0.0
+data: 28.0
+data: -28.0
+data: 0.0
+data: 0.0
+data: 28.0
+data: 0.0

physics/box2d_queries/box2d_v2.appmanifest

@@ -0,0 +1,95 @@
+platforms:
+  arm64-ios:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  x86_64-ios:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  armv7-android:
+    context:
+      excludeLibs: []
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+      jetifier: true
+  arm64-android:
+    context:
+      excludeLibs: []
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+      jetifier: true
+  arm64-osx:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  x86_64-osx:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      frameworks: []
+      linkFlags: []
+  x86_64-linux:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  arm64-linux:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  x86-win32:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  x86_64-win32:
+    context:
+      excludeLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  wasm-web:
+    context:
+      excludeLibs: []
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []
+  wasm_pthread-web:
+    context:
+      excludeLibs: []
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: []
+      linkFlags: []

physics/box2d_queries/box2d_v3.appmanifest

@@ -0,0 +1,100 @@
+platforms:
+  armv7-ios:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+  arm64-ios:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  x86_64-ios:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  armv7-android:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+      jetifier: true
+  arm64-android:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJars: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+      jetifier: true
+  arm64-osx:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  x86_64-osx:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      frameworks: []
+      linkFlags: []
+  x86_64-linux:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+  arm64-linux:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+  x86-win32:
+    context:
+      excludeLibs: [libphysics, libbox2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [libphysics_2d.lib, libbox2d.lib, libscript_box2d.lib, libphysics_3d.lib]
+      linkFlags: []
+  x86_64-win32:
+    context:
+      excludeLibs: [libphysics, libbox2d_defold, script_box2d_defold]
+      excludeSymbols: []
+      symbols: []
+      libs: [libphysics_2d.lib, libbox2d.lib, libscript_box2d.lib, libphysics_3d.lib]
+      linkFlags: []
+  wasm-web:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []
+  wasm_pthread-web:
+    context:
+      excludeLibs: [physics, box2d_defold, script_box2d_defold]
+      excludeJsLibs: []
+      excludeSymbols: []
+      symbols: []
+      libs: [physics_2d, box2d, script_box2d, physics_3d]
+      linkFlags: []

physics/box2d_queries/example.md

@@ -0,0 +1,67 @@
+---
+tags: physics, box2d
+title: Box2D Queries
+brief: This example shows how to use Box2D world overlap and raycast queries.
+author: Defold Foundation
+scripts: box2d_queries.script
+thumbnail: thumbnail.webp
+---
+
+This example places four static targets with box, circle, triangle, and diamond collision shapes, and user controllable AABB, circle, and raycast queries.
+Move the mouse or drag to move the query areas and aim the ray, watch the hit counts, and see the query overlays, ray, target shapes, and AABB (Axis Aligned Bounding Box) outlines change color.
+
+It ships with app manifests for Box2D V3 and Box2D V2 (legacy Defold version).
+The project is configured to build with the V3 app manifest by default, and the same script works with both Box2D backends.
+
+## What You'll Learn
+
+- How to get the active Box2D world with `b2d.get_world()`.
+- How to build AABB, circle, and raycast queries.
+- How to use `b2d.world.overlap_aabb()`, `b2d.world.overlap_shape()`, and `b2d.world.cast_ray()`.
+- How to read query result tables and use them.
+- How to handle the Box2D V2 and V3 query result table differences.
+- How to draw temporary AABB and ray helper lines through the render socket.
+
+## Setup
+
+The collection contains one `controller` game object with the query script, and two visual query overlays: one AABB box and one circle shape sprite.
+The overlay objects only show where the scripted queries are being run - they do not have collision objects.
+The raycast is drawn as a temporary helper line from the center of the scene to the pointer.
+
+Additionally, there are four static target objects with collision objects with shapes: one box, one circle, and two convex hull collision shapes - a triangle and a diamond (rotated square),
+and sprites for visual representation of the shape. The target sprites highlight exact shape and raycast hits, while the line rectangles highlight the target broad-phase AABBs hit by the AABB query.
+
+![setup](setup.png)
+
+The `game.project` of this example is configured to build with `/box2d_v3.appmanifest` by default. To test V2 locally after downloading the example, change `Native Extensions -> App Manifest` in `game.project` to `/box2d_v2.appmanifest`.
+
+## How It Works
+
+The controller stores the mouse or touch position and uses `update()` to drive the queries each frame.
+An AABB and a circle are tested directly against the Box2D world at the pointer position, and a ray is cast from the scene center to the pointer.
+
+Each query uses the Box2D scripting API directly.
+
+Unlike sensors or triggers, the query calls do not create persistent detector objects or send physics messages.
+They immediately return the fixtures or shapes hit by the query for the current frame.
+
+The AABB query builds a table with `lower` and `upper` vector fields, then passes it to `b2d.world.overlap_aabb()`.
+The circle query builds a shape table with `type`, `center`, and `radius`, then passes it to `b2d.world.overlap_shape()`.
+The raycast passes an origin position and a translation vector to `b2d.world.cast_ray()`.
+The translation is the direction and length of the segment, not the end position.
+
+The collection has one query controller script.
+The script reads bodies directly from fixture hits in V2, while in V3 it reads bodies from shape hits with `b2d.shape.get_body()`.
+The hit body's position is then matched against the cached target positions so the controller can update the correct target game object.
+The script caches the four static target positions and their defined AABBs at startup.
+
+The important backend difference is the query result format:
+Box2D V2 overlap results expose the body directly as `hit.body`, while V2 raycast results expose it through `hit.fixture.body`.
+Box2D V3 overlap results expose `hit.shape_id`, while V3 raycast results expose `hit.shape.shape_id`; both are passed to `b2d.shape.get_body()` to get the owning body.
+After that, the rest of the example uses the body in the same way for both backends.
+
+In `update()`, the query controller directly moves the query overlay sprites, changes target sprite colors, and draws the helper outlines and ray.
+The controller updates the count label to display how many fixtures or shapes each query detects.
+The target sprites are highlighted by the exact circle shape query and raycast results.
+The target AABB helper outlines are highlighted separately by the AABB query results.
+The helper visual outlines and ray are created using `draw_line` messages sent to `@render:` every frame, which then draws the debug lines on top.