Text 3D

문자열을 서체의 벡터 아웃라인 그대로 윤곽으로 삼아 Z 방향으로 돌출시켜 Mesh로 출력합니다. Image Extrude의 형제이지만 이미지를 거치지 않으므로 해상도 설정이 없으며, 곡선의 세밀함은 Detail로 정합니다. Mesh는 Mesh Renderer나 CopyToPoints에 연결하여 그립니다. 메시는 문자열 전체의 바운딩 박스 중심이 원점이며, 앞면(기본 카메라 쪽)이 z의 마이너스 쪽입니다.

계산은 프레임을 멈추지 않고 백그라운드에서 이루어지며, 본문·폰트·파라미터 중 어느 하나가 바뀌었을 때만 다시 베이크합니다(Live/Bake 전환은 없습니다). 본문은 Text 포트 외에, 노드 위의 텍스트 입력란에 직접 입력할 수도 있습니다. 입력란 안에서 Enter를 누르면 줄바꿈이 되어 행마다 배치됩니다. 겹쳐진 문자(이탤릭이나 자간을 좁힌 경우)는 하나의 채우기 영역으로 결합됩니다.

노드 위의 설정

• 텍스트 입력란 — 본문입니다. Text 포트에 연결하면 그쪽의 값이 본문이 됩니다
• Font — 서체 드롭다운입니다. Auto(기본값)는 일본어가 표시되는 서체를 OS에서 자동으로 선택합니다. Refresh Fonts로 실행 후에 설치한 서체를 다시 읽어 들입니다. Font 포트에 서체 이름 문자열을 보내서 선택할 수도 있습니다
• Left / Center(기본값) / Right — 행의 정렬입니다. 메시 전체는 항상 중앙에 놓이므로, 실제로 효과가 있는 것은 여러 행일 때 각 행의 위치입니다

포트 보충 설명

• FontSize — 한 글자(1 em)의 월드 단위 크기(기본값 5, 하한 0.01)
• Depth — 돌출의 두께(기본값 1)
• Bevel — 앞뒤 가장자리의 베벨 폭(월드 단위, 기본값 0 = 베벨 없음). 가는 부분에서 베벨이 깨지는 문자는 폭이 자동으로 줄어들며, 상태 표시에 “面取りを縮めた輪郭N本”(베벨을 줄인 윤곽 N개)라고 나옵니다
• Bevel Segments(노드 위의 표시는 Segments) — 베벨의 분할 수. 1~8로 클램프(기본값 1). 1은 45°의 평평한 베벨, 2 이상은 둥근 베벨이 됩니다
• LineSpacing — 행간의 배율(기본값 1 = 서체의 줄 간격 그대로)
• LetterSpacing — 자간입니다. 1 em에 대한 배율로, 0.1이면 문자와 문자 사이가 한 글자 폭의 10%만큼 벌어집니다(기본값 0, 음수면 좁아집니다)
• Detail — 0~1로 클램프(기본값 0.5). 곡선 1개당 분할 수(0이면 2분할, 1이면 16분할)
• FrontFace / BackFace(표시는 Front Face / Back Face) — 앞면·뒷면의 뚜껑을 덮을지 여부(기본값 둘 다 ON). 둘 다 OFF로 하면 문자의 윤곽만 있는 통이 됩니다

윤곽의 점 개수는 합계 16384점까지이며, 초과분은 균등하게 솎아집니다.

상태 표시줄에는 “Baking…”, “N polys / M verts” 외에, 본문이 비어 있으면 “Text が空”(Text가 비어 있음), 서체를 찾지 못하면 “フォント無し”(폰트 없음)이 표시됩니다. 하나의 서체에 없는 문자는 두부(네모)가 됩니다. 세로쓰기·합자는 지원하지 않습니다.

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