core: text under a rotated transform keeps upright, unscaled glyph cells, so rotate plus scale spreads the letters

オープン
#728 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
62/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
rust, typescript, wasm

調査の方向性

Read the transforms section of docs/DESIGN.md and the header of engine/core/src/draw.rs, then compare the TEX_QUAD glyph path at draw.rs:3415 with the GLYPH_RUN emission at draw.rs:3471-3480; the existing TEX_TRI path used for rotated images is the model to follow. Reproduce with the programs/sim/sim.ts script and render.rgba from the issue, measuring letter bounding boxes. Done means the third row's glyphs match the scale-200 row's 23 px height, turned by 3 degrees.

索引モデルが issue の本文から書いたものです。

説明

enhancement

Version

PocketJS v0.17.0 (83c6cac9, current main). macOS 27.2 arm64, Bun 1.4.2. Rendered with the wasm core's software rasterizer through programs/sim/sim.ts.

Gap

docs/DESIGN.md (transforms) and the header of engine/core/src/draw.rs state that axis-aligned scale transforms glyph positions and glyph cells, while rotated and perspective text keeps upright glyph behaviour. With a rotation in the transform, each glyph is drawn at its unscaled size and upright at its transformed anchor. Combined with a scale, the letters move apart to the scaled advance and keep their 1x size.

Rotation with a scale is common in device UIs: a label on a turning dial or card, a "zoom and turn" entrance animation, a card tilted by a few degrees (the edit-mode jiggle that #418 makes work for rounded boxes and arcs). #418 leaves text out.

Repro

A guest application (no AOT) with three rows of the same text.

pocket.host.json:

{
  "format": "pocket-host/2",
  "id": "repro-esp32s3",
  "platform": "esp-idf",
  "form": "takeover",
  "cadences": [30],
  "display": {
    "logicalViewports": [[240, 240]],
    "presentations": ["native"],
    "rasterDensity": 1,
    "animation": "repaint"
  },
  "panel": { "primary": [240, 240] },
  "capabilities": ["input.buttons", "text.glyphs.baked"]
}
// pocket.host.config.ts
import { defineHostConfig } from "@pocketjs/framework/host-config";

export default defineHostConfig({
  host: "./pocket.host.json",
  app: {
    id: "dev.example.render",
    title: "Render",
    version: "0.1.0",
    entry: "main.tsx",
    output: "render",
    framework: "solid",
    viewport: { logical: [240, 240], presentation: "native" },
    features: ["input.buttons", "text.glyphs.baked"],
  },
});
// main.tsx
import { mount } from "@pocketjs/framework/solid";
import { Text, View } from "@pocketjs/framework/solid/components";

mount(() => (
  <View class="w-full h-full bg-white">
    <Text class="absolute left-[10px] top-[10px] text-base text-black">HELLO</Text>
    <Text class="absolute left-[60px] top-[60px] text-base text-black scale-200">HELLO</Text>
    <Text class="absolute left-[60px] top-[120px] text-base text-black scale-200 rotate-3">HELLO</Text>
  </View>
));
// render.ts: bun render.ts <pocketjs>
const { bootBundle } = await import(`${Bun.argv[2]}/programs/sim/sim.ts`);
const world = await bootBundle({ js: "dist/render.js", pak: "dist/render.pak", viewport: { width: 240, height: 240 } });
for (let i = 0; i < 10; i++) world.step();
const { width, height, rgba } = world.pixels();
await Bun.write("render.rgba", rgba);
console.log(width, height);
bun $POCKETJS/tools/pocket.ts compile --config pocket.host.config.ts --output out/app.pkb
bun render.ts $POCKETJS

Actual

Bounding boxes of the dark connected components (one per letter) in render.rgba, 240×240 px:

Row H Glyph height Left edges of H, E, L, L, O
text-base 9×12 at (11, 14) 12 px 11, 23, 33, 42, 51
scale-200 18×23 at (37, 59) 23 px 37, 61, 81, 99, 116
scale-200 rotate-3 9×12 at (36, 111) 12 px 36, 60, 80, 98, 116

In the third row the glyphs have the size of the first row and the spacing of the second. They stay upright; each glyph's top is 1 px lower than the previous one (y = 111 to 115).

Expected

Glyphs under any 2D affine are drawn transformed, as axis-aligned scaled text is: the third row shows the second row turned by 3°.

Cause

engine/core/src/draw.rs:3415: only an axis-aligned world with a scale other than 1 draws glyphs as TEX_QUADs from the shared glyph pages. Every other transform emits a GLYPH_RUN whose cells stay axis-aligned and unscaled while their anchors are transformed (draw.rs:3471–3480). The glyph pages and the TEX_TRI path that rotated images use already exist.

Related

#418 (open): rounded boxes and arcs under rotation. #322 (open): rounded boxes under rotation.

主要言語
TypeScript
スター
1.6k
フォーク
88
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトの環境構築ファイルはまだ確認していません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

pocket-stack/pocketjs のほかの issue

pocket-stack/pocketjs の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。