Filament 1.80.0, 안개 옵션 변경으로 재질 재컴파일 필요

안개 변형의 표현 방식이 바뀝니다

Filament 1.80.0은 한국시간 2026년 11월 3일 공개됐습니다. FOG 셰이더 변형을 특수화 상수로 옮기며, 릴리스 노트는 재질을 다시 컴파일하라고 명시합니다. 안개의 시각적 효과를 새로 추가한 발표가 아니라 재질을 구성하는 내부 방식과 산출물 갱신에 관한 변화입니다.

공식 재질 가이드는 정의 파일을 matc로 컴파일한 패키지를 런타임에서 읽는 구조를 설명합니다. 그러므로 실행 라이브러리를 올리는 작업과 재질 패키지를 새로 만드는 작업은 구분해야 합니다. 예전 빌드에서 만든 파일이 배포 패키지에 남아 있으면 새 코드만으로 확인한 상태가 아닙니다.

모션 벡터도 선택적으로 사용할 수 있습니다

같은 버전에는 움직이는 물체의 모션 벡터를 렌더링하는 View::setMotionVectorsOptions가 추가됩니다. TAA가 이를 재투영에 사용해 잔상을 줄이도록 하며, 기본값은 비활성화입니다. 업데이트만 하면 모든 기존 장면에서 자동으로 켜지는 효과로 설명해서는 안 됩니다.

새 motionVectors 변형 필터와 ALL 비트 값의 변경에도 재질 재컴파일 경고가 붙어 있습니다. 안개만 쓰는지, 모션 벡터를 추가할 것인지에 따라 확인할 설정은 달라집니다. 재질 산출물을 갱신하는 작업은 공통이지만 기능 활성화와 시각 검증은 따로 판단해야 합니다.

비동기 작업의 예산도 바뀌었습니다

AMORTIZATION 비동기 모드에서는 대기 작업을 프레임 종료와 skipFrame에서 시간 예산 안에 처리하도록 변경합니다. 새 asynchronousFrameBudget의 기본값은 2ms이며, 이전의 백엔드 틱당 다섯 작업 방식과 다릅니다. Java와 Web에도 관련 설정이 추가되지만 단위가 각각 나노초와 밀리초라는 점을 구분해야 합니다.

이 수치는 전체 프레임 시간이 2ms가 된다는 보장이 아닙니다. 비동기 작업 처리에 배정하는 설정값입니다. 로딩 중 끊김을 검토한다면 작업 수와 처리 시점을 기록하고 렌더링 시간과 함께 보되, 같은 숫자로 합쳐 설명하지 않는 편이 좋습니다.

배포 파일까지 확인하는 이전 절차

검토용 빌드에서는 도구와 라이브러리 버전을 맞추고 재질을 다시 만든 뒤, 앱이 실제로 읽는 경로를 확인해 보세요. 캐시가 없는 빌드뿐 아니라 기존 캐시가 있는 상태에서도 새 파일이 선택되는지 살펴볼 만합니다. 이후 안개가 있는 대표 장면과 모션 벡터를 사용할 장면을 구분해 비교하면 됩니다.

이 절차는 릴리스의 요구사항을 프로젝트에 적용하기 위한 제안입니다. 실제 안개 품질이나 TAA 잔상 감소를 이 글에서 직접 측정하지 않았습니다. 일반 재질 가이드에 남은 예전 필터 설명보다 해당 버전 릴리스의 재컴파일 안내를 우선해 읽으시는 것이 안전합니다.

출처

• Filament 1.80.0 · 재컴파일과 API 안내
• 공식 재질 가이드 · 정의·패키지 구조