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

인벤토리 창 두 개

드래그 튜토리얼

이동 및 크기 조절이 가능한 인벤토리 창

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

조작: 마우스로 두 창을 이동하고 크기를 바꿉니다. 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 및 수명 안내

네이티브 중첩 합성, 가우스 블러와 위치를 유지하는 알파 마스크

레이어 합성

균형 있는 네이티브 층, 미리 곱한 알파, 자기 합성 필터와 저장 마스크

node packages/sfml.js-rmlui/examples/render-layers.cjs

조작: Space로 도형 이동, Escape로 종료합니다.

--frames 6 --exercise --screenshot path.png로 두 위치를 확인하고 마지막 프레임을 캡처합니다.

레이어 핸들, 필터 소유권과 마스크

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 편집기로 실제 중첩 문서를 갱신

공식 컨트롤과 샌드박스

원본 여섯 탭, 데코레이터와 색상 보간, 폼 컨트롤, 4초 제출 애니메이션, 실시간 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로 종료합니다.

업스트림 애플리케이션

원본 Comfortaa 비트맵 글꼴 아틀라스

공식 비트맵 글꼴

원본 FNT 글리프 이동 폭, 커닝 및 네이티브 아틀라스 텍스처를 사용합니다.

node packages/sfml.js-rmlui/examples/official.cjs bitmap-font

원본 세 문단을 확인합니다. 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 · 렌더러 지원 범위

VisualTests 113페이지 검증, 실제 IME 확인, 게임의 나머지 플랫폼 작업 및 전체 프로젝트 독립 검증은 아직 완료되지 않았습니다. 렌더러와 모듈 검증 근거는 각 가이드에 기록되어 있습니다. 스크린샷은 실행 중인 네이티브 애플리케이션입니다.

모든 예제 · RmlUi 빠른 시작

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