Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs: a 2D box collider has a fixed corner radius and a sub-viewport camera draws only into its own rectangle

yhh12a63dca2237
diff --git a/docs/astro/src/content/docs/core-concepts/screen.mdx b/docs/astro/src/content/docs/core-concepts/screen.mdx
index 02e6cccda..249123a59 100644
--- a/docs/astro/src/content/docs/core-concepts/screen.mdx
+++ b/docs/astro/src/content/docs/core-concepts/screen.mdx
@@ -259,10 +259,10 @@ In the editor the mask is a multi-select of your project's **sorting layer names
(Settings → Project → Rendering → Layer names). The editor's own viewport ignores it
and always shows every layer, so culling never hides content while you author.
-<Aside type="caution">
- A sub-viewport camera clears only its own rectangle, but its draws are not
- clipped to it — content it renders can spill across the full frame. Culling
- decides *what* such a camera draws; scoping *where* is a separate gap.
+<Aside>
+ A sub-viewport camera draws and clears only its own rectangle, so two cameras
+ with a half each give a split screen. Culling decides *what* such a camera
+ draws; its `viewport` decides *where*.
</Aside>
## Screen size & orientation: `ScreenInfo`
diff --git a/docs/astro/src/content/docs/gameplay/physics.mdx b/docs/astro/src/content/docs/gameplay/physics.mdx
index 04ce2bdf8..5dd50c580 100644
--- a/docs/astro/src/content/docs/gameplay/physics.mdx
+++ b/docs/astro/src/content/docs/gameplay/physics.mdx
@@ -128,7 +128,7 @@ lists the exceptions). Dimensions are in meters.
| Component | Shape parameters |
|---|---|
-| `BoxCollider2D` | `halfExtents` (`{0.5, 0.5}`), `radius` (rounded corner, `0.05`). |
+| `BoxCollider2D` | `halfExtents` (`{0.5, 0.5}`). Its corners are always rounded by `0.05` m; there is no field to change that (a `radius` written to the component is not stored). |
| `CircleCollider2D` | `radius` (`0.5`). |
| `CapsuleCollider2D` | `radius` (`0.25`), `halfHeight` (`0.5`). |
| `SegmentCollider2D` | `point1` (`{-0.5, 0}`), `point2` (`{0.5, 0}`) — a one-sided edge; no `offset`. |
diff --git a/docs/astro/src/content/docs/zh-cn/core-concepts/screen.mdx b/docs/astro/src/content/docs/zh-cn/core-concepts/screen.mdx
index 8eb39de5f..ed0d625b6 100644
--- a/docs/astro/src/content/docs/zh-cn/core-concepts/screen.mdx
+++ b/docs/astro/src/content/docs/zh-cn/core-concepts/screen.mdx
@@ -226,9 +226,9 @@ const setupMinimap = defineSystem([GetWorld()], (world) => {
编辑器里这个遮罩是一个按**项目排序层名字**列出的多选框(设置 → 项目 → 渲染 → 层名称)。
编辑器自己的视口不受它影响、永远显示所有层,所以剔除不会在创作时挡住内容。
-<Aside type="caution">
- 子视口相机只清除自己那块矩形,但它的**绘制并不会被裁剪到该矩形内**——它画的东西可能
- 铺满整帧。剔除决定这类相机**画什么**,限定**画在哪**是另一个尚未合上的口子。
+<Aside>
+ 子视口相机只在自己那块矩形里绘制和清除,所以两台各占一半的相机就是分屏。剔除决定这类相机
+ **画什么**,它的 `viewport` 决定**画在哪**。
</Aside>
## 屏幕尺寸与方向:`ScreenInfo`
diff --git a/docs/astro/src/content/docs/zh-cn/gameplay/physics.mdx b/docs/astro/src/content/docs/zh-cn/gameplay/physics.mdx
index 14693e641..2cc4fd4f2 100644
--- a/docs/astro/src/content/docs/zh-cn/gameplay/physics.mdx
+++ b/docs/astro/src/content/docs/zh-cn/gameplay/physics.mdx
@@ -120,7 +120,7 @@ const spawnBall = defineSystem([Commands()], (cmds) => {
| 组件 | 形状参数 |
|---|---|
-| `BoxCollider2D` | `halfExtents`(`{0.5, 0.5}`)、`radius`(圆角,`0.05`)。 |
+| `BoxCollider2D` | `halfExtents`(`{0.5, 0.5}`)。四个角固定圆角 `0.05` 米,没有字段可以改(写进组件的 `radius` 不会被保存)。 |
| `CircleCollider2D` | `radius`(`0.5`)。 |
| `CapsuleCollider2D` | `radius`(`0.25`)、`halfHeight`(`0.5`)。 |
| `SegmentCollider2D` | `point1`(`{-0.5, 0}`)、`point2`(`{0.5, 0}`)——单边;没有 `offset`。 |