Skip to content

RmlUi サンプル ​

ネイティブ SFML ウィンドウで RmlUi 文書を実行します。カウンターから始めて、テーマ、移動可能なウィンドウ、テンプレート、視覚テストへ進みます。

前提条件 ​

すべてのコマンドは monorepo のルートで実行します。bootstrap は依存関係を導入し、各パッケージをビルドします。画面と OpenGL が必要です。macOS のビルドには Xcode Command Line Tools と CMake も必要です。クイックスタートを参照してください。

sh
node tools/bootstrap.cjs

RmlUi の TypeScript ソースを変更したら、npm run build:ts --prefix packages/sfml.js-rmlui を実行します。サンプルはローカルでビルドしたパッケージを使います。

ランチャーはパッケージの third_party/rmlui にある RmlUi 6.3 同梱素材を読み込みます。全項目を一覧表示するには:

sh
node packages/sfml.js-rmlui/examples/official.cjs --list

サンプル一覧 ​

ダークテーマとミッションボタン

テーマと変数

テーマ切り替え、アクセントカラー、ホバースタイル

node packages/sfml.js-rmlui/examples/official.cjs variables

操作:1 はダーク、2 はライト、3 は高コントラスト、 R はランダムなアクセント、C はアクセントのリセットです。Escape で終了します。 ミッションボタンはホバー表示のみで、上流にはクリック処理がありません。

元のスタイルシートは固定の px 長を使います。 highDpi: false により Retina でも 1024 × 768 の フレームバッファーを保持し、上流のウィンドウサイズに合わせます。 F8 で Debugger を切り替え、Ctrl +/-/0 で Shell の表示密度を調整します。

上流 RML

2 つのインベントリウィンドウ

ドラッグチュートリアル

移動・リサイズ可能なインベントリウィンドウ

node packages/sfml.js-rmlui/examples/official.cjs drag

操作:マウスで 2 つのウィンドウを移動・リサイズします。Escape で終了します。

チュートリアルのウィンドウ設定を移植したもので、上流の basic/drag アプリとは別です。

上流 RML

テクスチャで装飾したウィンドウ

テンプレートチュートリアル

9 分割テクスチャと外部テンプレート

node packages/sfml.js-rmlui/examples/official.cjs template

操作:装飾されたウィンドウを確認します。Escape で終了します。

上流 RML

上流の文書と素材

文書の読み込み

元のテンプレート、フォント、テクスチャとともに上流の文書を読み込む

node packages/sfml.js-rmlui/examples/official.cjs load-document

操作:読み込んだ文書を確認します。Escape で終了します。他の上流デモのアプリ操作は接続していません。

上流 RML

カスタムフォント効果で描画した緑色のテキスト

カスタムフォント効果

JavaScript の FontEffectInstancer とネイティブのグリフテクスチャコールバック

node packages/sfml.js-rmlui/examples/font-effect.cjs

操作:Space でグロー効果を切り替え、Escape で終了します。

有限スモーク実行:--frames N、--screenshot path.png で最終フレームを保存します。

三種類のネイティブバイトストリーム

バイトストリーム

ファイル文書、ネイティブメモリコピー、同期コールバックの RCSS 入力

node packages/sfml.js-rmlui/examples/streams.cjs

操作:Escape で終了。--frames N --screenshot path.png で有限フレームを保存します。

Stream API とライフサイクル

RGBA 生成、所有テクスチャ転送、ネイティブレイヤー保存

コールバックテクスチャ

遅延乗算済みバイト生成、所有ハンドル転送、シザー領域のレイヤー保存

node packages/sfml.js-rmlui/examples/callback-textures.cjs

操作:Space で色を再生成。Escape で終了。

--frames 6 --exercise --screenshot path.png でキャッシュと再生成を確認し、最終フレームを保存します。

提出方法、寿命、所有権

ネイティブ入力の生成と RML の子の解析

要素ファクトリー

カスタムコンテキストと入力の生成・解放、所有文書ストリーム、独立タグと Factory キャッシュ

node packages/sfml.js-rmlui/examples/factory-elements.cjs

操作:入力欄を編集、Space で更新、Escape で終了。

--frames 6 --exercise --screenshot path.png で編集を検証し、最終フレームを撮影します。

Factory の解析とキャッシュ

要素生成器の所有権

ネイティブモデル式と双方向コントロール

ネイティブデータモデル

ネイティブスカラー、再帰 data-for、共有配列、部分更新、getter と変換、自作 Factory ビューと既定双方向コントローラーの委譲

node packages/sfml.js-rmlui/examples/data-models.cjs

操作:Increment で計数更新、タイトル編集、詳細切替、Escape で終了。

--frames 6 --exercise --screenshot path.png でバインドを検証し、最終フレームを撮影します。

データモデル契約と残りの範囲

上流のイベントモデルと記録したマウス座標

公式データバインディング

Basics、Events、Invaders、Forms の四モデルで、ネイティブ式と同期配列変更を実行

node packages/sfml.js-rmlui/examples/official.cjs data-binding

操作:タブ切り替え、入力、マウス座標の記録と消去、項目の追加と削除、ゲーム開始と射撃。Escape で終了。

--frames 45 --exercise --panel invaders --screenshot path.png は状態を検証し、選択したタブを撮影します。

Basics · Invaders · Forms

上流アプリケーション

元の RML と RCSS エディターで実際の入れ子文書を更新

公式コントロールとサンドボックス

元の六タブ、デコレーターと色の補間、フォーム、四秒の送信アニメーション、ライブ RML/RCSS エディター

node packages/sfml.js-rmlui/examples/official.cjs basic-demo

操作:タブ切り替え、補間設定、フォーム送信、サンドボックス編集。Escape は開いた選択欄を取消し、それ以外は終了します。F8 で Debugger を切り替えます。

--panel sandbox --frames 8 --exercise --screenshot path.png は両エディターを検証し、サンドボックスを撮影します。パネル:welcome、decorators、font-effects、animations、controls、sandbox。

フォーム · ウィンドウ処理 · イベントリスナー

上流アプリケーション

上流サンプルの実ディレクトリーツリー

公式ツリービュー

サンプルディレクトリーを走査し、FileBrowser の規則で子孫の表示を切り替え

node packages/sfml.js-rmlui/examples/official.cjs tree-view

操作:矢印をクリックして展開と折りたたみ。Escape で終了。

--frames 12 --exercise --screenshot path.png は実ディレクトリーの切り替えを検証します。

上流アプリケーション

元の変換、混合単位、遷移アニメーション

公式アニメーション

元の変換列、色のキー、フェード周期、遷移とアニメーションイベント

node packages/sfml.js-rmlui/examples/official.cjs animation

操作:Space で停止、Return で一回実行、+/- で微調整、矢印でアニメーション、F8 で Debugger、Escape で終了。

--frames 8 --exercise --screenshot path.png は停止、一回実行、クリックを検証して撮影します。

上流アプリケーション

元のベンチマークの経路行、範囲入力と選択項目

公式ベンチマーク

更新ごとに元の 50 行を再生成し、独立した描画と 200 項目の FPS リングを維持

node packages/sfml.js-rmlui/examples/official.cjs benchmark

操作:Space で描画停止、Down で一回描画、Return で行更新停止、Right で一回更新、F8 で Debugger、Escape で終了。

--frames 3 --screenshot path.png はフレーム数を限定して撮影します。

上流アプリケーション

二つのネイティブウィンドウの元のドラッグアイコン

公式ドラッグ

ネイティブ所有のアイコンをウィンドウ間で移動し、順序を変更します。

node packages/sfml.js-rmlui/examples/official.cjs basic-drag

アイコンを別のウィンドウや前のアイコンにドラッグします。Escape で終了します。

上流のアプリケーション

元の効果コントロールとフィルター処理された内容

公式エフェクト

元の色フィルター、ぼかし、影、変換、不透明度を調整します。

node packages/sfml.js-rmlui/examples/official.cjs effects

メニューを開き、スライダーを調整するか設定をリセットします。Escape で終了します。

上流のアプリケーション

元の正投影と透視変換

公式変換

元の文書を正投影と透視投影で回転させます。

node packages/sfml.js-rmlui/examples/official.cjs transform

Space で回転を一時停止し、Escape で終了します。

上流のアプリケーション

元の SVG 要素とデコレーター

公式 SVG

元の SVG 要素、デコレーター、インライン更新を描画します。

node packages/sfml.js-rmlui/examples/official.cjs svg

元の更新コントロールを操作します。Escape で終了します。

上流のアプリケーション

ネイティブ rlottie で描画する元の山のアニメーション

公式 Lottie

ネイティブのフレーム時刻とラスタライズで元の山のアニメーションを再生します。

node packages/sfml.js-rmlui/examples/official.cjs lottie

アニメーションは自動でループします。Escape で終了します。

上流のアプリケーション

元の多言語 HarfBuzz テキストシェーピング

公式 HarfBuzz

元のフォントで英語、アラビア語、ヒンディー語の段落をシェーピングします。

node packages/sfml.js-rmlui/examples/official.cjs harfbuzz

言語ボタンで段落を切り替えます。Escape で終了します。

上流のアプリケーション

アプリケーション独自のログインターフェイスを使う元の文書

公式カスタムログ

元のネイティブログメッセージとレベル接頭辞を指定ファイルに書き込みます。

node packages/sfml.js-rmlui/examples/official.cjs custom-log --log-file /tmp/rmlui-log.txt

既定のログはシステムの一時ディレクトリに保存します。Escape で終了します。

上流のアプリケーション

絵文字と八言語の文章を含む元の IME フォーム

公式 IME

元の十個のフォントを読み込み、ネイティブの入力欄とテキストエリアを開きます。

初回に五個の追加 Noto フォントを準備します(38 MB、SHA-256 検証):npm run download:ime-fonts --prefix packages/sfml.js-rmlui。検証済みのキャッシュは再利用されます。

node packages/sfml.js-rmlui/examples/official.cjs ime

システムの入力方式を選び、入力欄にフォーカスします。Escape で終了します。

上流のアプリケーション

元の Invaders の編隊、防壁、自機とネイティブ HUD

Invaders

元の C++ ゲーム、メニュー、デコレーターとハイスコアモデルを実行します。

node packages/sfml.js-rmlui/examples/official.cjs invaders

左右キーで移動、Space で発射、Escape で一時停止メニュー、F8 で Debugger を切り替えます。元のメニューから再開や終了を選択します。

先にパッケージをビルドしてください。ゲームモジュールは同じビルドディレクトリで生成され、読み込み時にコンパイラーは不要です。macOS は検証済み、Linux と Windows の実行は未検証です。

スコアはアプリのデータ領域に保存します。--scores-file /absolute/path/scores.txt は既存の親ディレクトリーを指定します。--frames 8 --exercise でフレーム数を制限して開始します。

ネイティブ登録 · 上流アプリ

元の Lua Invaders のネイティブ編隊とスコア表示

Lua Invaders

元の Lua 文書と Game テーブルで元のネイティブゲームを動かします。

node packages/sfml.js-rmlui/examples/official.cjs lua-invaders

左右キーで移動、Space で発射、Escape で一時停止メニュー、F8 で Debugger を切り替えます。設定はスコアファイルと同じ場所に保存します。

先にパッケージをビルドしてください。ゲームモジュールは同じビルドディレクトリで生成され、読み込み時にコンパイラーは不要です。macOS は検証済み、Linux と Windows の実行は未検証です。

--scores-file /absolute/path/scores.txt は既存の親ディレクトリーを指定します。--frames 8 --exercise でフレーム数を制限して開始します。

ネイティブ登録 · 上流アプリとスクリプト

クリップマスクの視覚テスト

VisualTests ブラウザー

上流の視覚テスト 113 ページを閲覧

node packages/sfml.js-rmlui/examples/official.cjs visual/clip_mask

操作:F6 / F7 でページを切り替え、Escape で終了します。

--frames 60 を付けると 60 フレーム後に終了します。 --frames N は正の整数を受け取り、時間を限定したスモーク実行に使えます。 上流のアサーション機構を含まないプレビューです。

上流 VisualTests · 描画対応範囲

113 ページの VisualTests アサーション、実際の IME 検証、ゲームの残りのプラットフォーム対応、プロジェクト全体の独立した受け入れ検証は未完了です。描画とモジュールの検証結果は各ガイドに記録されています。画像は実行中のネイティブアプリケーションです。

全サンプル · RmlUi クイックスタート

Icons made by Lorc, Delapouite & Skoll game-icons.net · CC BY 3.0