Text Render

AI와 함께 읽기
전체 문서 한 파일로 (llms-full.txt)
AppTextRender #Generator #Node
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 TextureRenderTexture

스크립트에서 설정할 수 있는 멤버

경로타입
fontSizefloat
colorRfloat
colorGfloat
colorBfloat
colorAfloat
textstring
alignmentint

Synapse Apps (스크립팅)

await synapse.modules.create({ type: "AppTextRender" })