Text Render
Apps SDK용 저수준 노드입니다. GUI의 노드 추가 UI에는 기본적으로 표시되지 않습니다(글로벌 설정에서 표시로 전환할 수 있습니다).
전용 오프스크린 카메라로, 문자열 하나만을 배경 투명 RenderTexture에 그립니다. 노드 UI상에는 해상도 표시와 폰트 크기 필드만 있으며, 문자열이나 색상은 SDK 쪽에서 설정합니다.
- fontSize — 기본값 96(1 미만은 1로 취급됩니다)
- colorR / colorG / colorB / colorA — 각각 0~1로 클램프. 기본값은 모두 1(불투명한 흰색)
- alignment — 0=왼쪽, 1=중앙(기본값), 2=오른쪽
- 출력 해상도는 생성 시에 고정됩니다(기본값은 글로벌 해상도)
렌더링은 매 프레임이 아니라 더티 플래그 구동입니다. text / fontSize / 색상 / alignment 중 하나라도 바뀌었을 때만 카메라를 1회 렌더링하므로, 움직이지 않으면 GPU 부하가 걸리지 않습니다.
일본어 등 CJK는 OS에 설치된 폰트로부터 실행 시 한 번만 동적 폰트를 구성하여 그립니다. 후보 폰트를 찾을 수 없는 환경에서는 TMP 표준인 LiberationSans로 폴백되며, CJK는 빈 네모(□)로 표시됩니다.
입력 포트
없음
출력 포트
| Port ID | 타입 |
|---|---|
Render Texture | RenderTexture |
스크립트에서 설정할 수 있는 멤버
| 경로 | 타입 |
|---|---|
fontSize | float |
colorR | float |
colorG | float |
colorB | float |
colorA | float |
text | string |
alignment | int |
Synapse Apps (스크립팅)
await synapse.modules.create({ type: "AppTextRender" })