App Fx Chain

AI와 함께 읽기
전체 문서 한 파일로 (llms-full.txt)
AppFxChain #Fx #Node
App Fx Chain

Render API가 소유하는 체인의 호스트 노드입니다. 새로운 렌더러가 아니라, 기존 이펙트 노드(FxShader 등 IFxChainStepProvider를 구현한 모듈)를 앱 쪽에서 생성・연결하고, 그 순서가 있는 목록을 이 노드에 전달합니다. 이 노드가 가지고 있는 것은 Source → 이펙트 목록 → 출력의 Blit와 출력 RT뿐이며, 셰이더 처리 자체는 각 이펙트 노드가 가지고 있습니다. 파라미터도 이펙트 노드 쪽에 있습니다.

노드 에디터상에서 수동으로 이펙트를 삽입해 체인을 구성하고 싶은 경우에는 Fx Apply를 사용하세요.

  • Source — 입력 텍스처
  • Render Texture — 체인의 출력. 다른 노드와 마찬가지로 합성・출력・서페이스 할당이 가능한 실제 RT입니다

출력 RT는 모듈이 존재하는 동안 계속 동일한 참조를 유지하며, 해상도는 글로벌 해상도로 고정입니다(입력을 따라가지 않습니다).

이펙트가 0개일 때는 그대로 통과합니다. 그릴 수 없는 이펙트나 Enable이 OFF인 ShaderFx는 스텝이 null이 되므로 스킵되며, 하나의 불량 이펙트 때문에 체인 전체가 검게 되는 일은 없습니다.

Source가 미연결(또는 도중에 연결 해제)이 되면, 출력 버퍼는 한 번만 투명하게 클리어됩니다. 마지막 화면이 계속 남아 있는 일은 없습니다.

입력 포트

Port ID타입
SourceRenderTexture

출력 포트

Port ID타입
Render TextureRenderTexture

Synapse Apps (스크립팅)

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