go.transform: position, localPosition, localMatrix, worldMatrix (#75) #84

New issue

Closed

opened 2026-09-06 01:25:28 +00:00 by crowmaki · 0 comments

crowmaki commented

2026-09-06 01:25:28 +00:00

Owner

Parent

#75

What to build

Moving something from a Script is one line. go.transform is a small userdata bound to the same GameObject Handle. position and localPosition read and write as {x, y, z} tables and are the translation column of the World Transform and the local transform; writing them replaces only that column and goes through gameobject_set_world_transform or gameobject_set_local_transform. worldMatrix and localMatrix read and write as the full sixteen numbers. Rotation and scale helpers are out of scope; the matrix is the escape hatch.

Acceptance criteria

Writing go.transform.localPosition = {1, 2, 3} is visible via gameobject_local_transform, and only the translation column changed
Writing go.transform.position under a parented GameObject is visible via gameobject_world_transform and the local transform is recomputed accordingly
Reading position and localPosition returns tables with x, y, z matching Odin
worldMatrix and localMatrix round-trip sixteen numbers in Mat4 column-major order
Writing a malformed table (missing component, wrong length) raises an error naming the property
go.transform on a dead GameObject raises

Blocked by

## Parent #75 ## What to build Moving something from a Script is one line. `go.transform` is a small userdata bound to the same GameObject Handle. `position` and `localPosition` read and write as `{x, y, z}` tables and are the translation column of the World Transform and the local transform; writing them replaces only that column and goes through `gameobject_set_world_transform` or `gameobject_set_local_transform`. `worldMatrix` and `localMatrix` read and write as the full sixteen numbers. Rotation and scale helpers are out of scope; the matrix is the escape hatch. ## Acceptance criteria - [ ] Writing `go.transform.localPosition = {1, 2, 3}` is visible via `gameobject_local_transform`, and only the translation column changed - [ ] Writing `go.transform.position` under a parented GameObject is visible via `gameobject_world_transform` and the local transform is recomputed accordingly - [ ] Reading `position` and `localPosition` returns tables with `x`, `y`, `z` matching Odin - [ ] `worldMatrix` and `localMatrix` round-trip sixteen numbers in Mat4 column-major order - [ ] Writing a malformed table (missing component, wrong length) raises an error naming the property - [ ] `go.transform` on a dead GameObject raises ## Blocked by - #82

crowmaki referenced this issue

2026-09-06 01:25:47 +00:00

Document the Script API surface and update the glossary (#75) #87

crowmaki added the

ready-for-agent

label

2026-09-06 01:25:48 +00:00

crowmaki referenced this issue from a pull request that will close it,

2026-09-06 05:46:01 +00:00

go.transform: position, localPosition, localMatrix, worldMatrix (#84) #96

crowmaki referenced this issue from a commit

2026-09-06 05:46:01 +00:00