Shader Art Coding
셰이더 작업을 시각 엔지니어링으로 취급하세요: 의도된 이미지에서 시작하여, 그것을 생성할 수 있는 가장 작은 수학적 모델을 선택하고, 검사 가능한 단계로 구축한 후 각 단계를 디버그 뷰로 검증하세요.
워크플로우
- 목표. 이미지를 명시하세요: 주제, 카메라 및 프레이밍, 주요 형태, 재질, 빛, 움직임.
- 경로.
references/subject-routing.md에서 렌더링 모델과 시작 템플릿을 선택하세요: 2D 거리 필드 (포스터, 아이콘, 패턴), SDF 레이마칭 (객체, 캐릭터), 높이필드 마칭 (풍경), 볼륨 적분 (구름, 연기, 불). - 라이브러리에서 조립.
python3 scripts/glsl_tools.py search <단어>또는references/library-index.md로 빌딩 블록을 찾고 이름으로 호출하세요. 라이브러리 코드를 붙여넣거나 재유도하지 마세요; 이미 테스트되었습니다. - 빠르게 첫 이미지. 좌표, 배경, 하나의 프리미티브, 하나의 조명. 그런 다음 디버그 뷰를 추가하세요.
- 순서대로 정제: 비율, 구성, 재질 분리, 조명, 분위기, 색상, 안티앨리어싱, 성능.
- 번들링 및 검사.
python3 scripts/glsl_tools.py bundle shader.glsl -o out.glsl는 사용된 함수만 정확히 인라인합니다.python3 scripts/glsl_tools.py check out.glsl는 린트하고 설치된 경우 glslangValidator로 컴파일합니다. 모든 오류를 수정한 후out.glsl를 전달하세요.
이 스킬의 디렉토리에서 스크립트를 실행하세요. Python 3만 필요합니다.
컨벤션
- 좌표:
vec2 uv = (2.0 * fragCoord - iResolution.xy) / iResolution.y;, 따라서 한 픽셀은2.0 / iResolution.y입니다. - 씬 규약:
vec2 map(vec3 p)는vec2(distance, materialId)를 반환합니다.raymarch,calcNormal,softShadow,calcAO및sdfThickness모두 이를 사용합니다. - 디버그:
#define DEBUG_MODE 0(0 최종, 1 거리 필드, 2 노멀, 3 ID, 4 단계, 5 마스크, 6 조명 항목). - 컬러 파이프라인: 선형으로 조명하고 선택한 색상을
srgbToLinear로 디코딩합니다. 그런 다음 노출, 톤맵(기본적으로tonemapAgX, AA 샘플당), 평균,linearToSrgb한 번, 그 다음ditherTPDF. - 거리:
@exact/@bound/@approx태그를 존중하세요. 변형이 Lipschitz를 1 이상으로 밀어올리면 거리를 나누거나raymarch의stepScale을 낮추세요.
하드 규칙 (Shadertoy/WebGL을 깨뜨림)
#version줄 없음, 사용자 정의 유니폼 없음,gl_FragColor/texture2D/iGlobalTime없음.- 구조체에
?:없음.vec2(distance, id)또는if를 사용하세요. - float 리터럴 작성:
2.0 * PI,clamp(x, 0.0, 1.0). fract(sin(...) * 43758.5453)해시 없음.hash12/hash22/hash33(정수 PCG)를 사용하세요. "룩 유지"로 포팅할 때도 대체하세요: 사인 해시의 정확한 패턴은 이미 GPU마다 다르며, 동일한 정수 셀 ID에 대한 PCG 해시는 노이즈에 동일한 룩을 제공합니다.check는 사인 해시를 오류로 보고합니다.- NaN 소스 보호:
atan(0, 0), 음수의pow, 음수의sqrt,normalize(vec3(0)). dFdx/fwidth를 비균일 분기 및 루프 밖에 유지하거나 명시적 픽셀 크기를 사용하세요.
참조 라우팅
작업에 필요한 것만 읽으세요:
| 파일 | 읽을 때 |
|---|---|
references/subject-routing.md | 주제("해파리", "산")에서 시작할 때; 형식적 이름을 주제에 매핑 |
references/library-index.md | 함수 선택: 모든 라이브러리 함수의 시그니처, 정확성 및 용도 |
references/sdf-library-guide.md | 모델링: 정확성 계층, 블렌드, 이웃 확인 반복, 변형 제한, WebGL 함정 |
references/rendering-pipeline.md | 조명 장치, 그림자/AO, 하늘 및 안개, 볼륨, 톤매핑, AA, 성능 |
references/noise-use-cases.md | Perlin/value/simplex/cellular 노이즈 선택, fBm/ridged/billow/warp/hybrid 레시피, 게임 사용 사례 및 소스 코드 링크 |
references/procedural-buildings.md | 구획 ID, 건물 매싱, 후퇴/지붕, 파사드 필터링, 도시 반복 및 게임 통합 |
references/terrain-production.md | 지형 표현, 설계된 계곡, 경사/고도 재질, 트레이싱 제한, 청크 및 LOD |
references/water-quality.md | 고품질 해양/연안 수면, 파도 미분, 프레넬/굴절/흡수, 거품, 프리셋 및 엔진 측 업그레이드 |
references/shader-workflow.md | 복잡한 셰이더를 처음부터 끝까지 계획; 검토 체크리스트 |
references/composition-and-debugging.md | 이미지가 잘 읽히지 않거나 시각적으로 잘못된 경우 |
references/formula-cookbook.md | 다단계 레시피: 모듈식 셀 격자, 지형 합성, 유기적 구성 |
references/formula-code-couples-sdf.md | 유기적 및 모듈식 SDF 피처에 대한 방정식-코드 |
references/formula-code-couples-terrain.md | 높이필드, 밀도 필드, 축적, 분위기 |
references/formula-code-couples-materials.md | 마스크, 팔레트, 조명 항목, 폴리싱, 모션 |
templates/ 디렉토리의 템플릿은 완전하고 렌더링 검증된 시작점입니다(리포지토리 README의 갤러리):
raymarch-sdf.glsl, terrain.glsl, ocean.glsl, volumetric-clouds.glsl, sdf-2d-poster.glsl,
pattern-swatches.glsl, noise-progression.glsl, noise-terrain-map.glsl, procedural-city.glsl,
alpine-valley.glsl, coastal-water.glsl.
출력 기대사항
셰이더를 작성할 때:
- 번들링된, 붙여넣기 준비된 Shadertoy 코드를
mainImage(out vec4 fragColor, in vec2 fragCoord)와 함께 전달하세요. - 사용자가 제공하지 않는 한 텍스처를 피하세요.
DEBUG_MODE스위치를 포함하고 아트 컨트롤을 상단에 상수로 명명하세요.- 짧은 튜닝 가이드로 마무리하세요: 어떤 상수가 스케일, 부드러움, 색상, 조명 및 움직임을 제어하는지.
- 셰이더가 컴파일 검사되었는지와 방법을 명시하세요.
- 빌딩/지형/물의 경우, 구현된 피처와 엔진 측 업그레이드를 분리하세요. 높이필드를 동굴 생성기, 재질 창을 모델링된 오목부, 절차적 거품/코스틱 마스크를 유체/광 시뮬레이션이라고 부르지 마세요.
- 품질 요청의 경우, 목표와 예산을 명시하고, 프리셋/디버그 뷰를 노출하며, 렌더링된 출력을 검사하세요. 중요한 템플릿 프리셋에
// @variant QUALITY=3(또는 다른 정의된 정수 매크로) 주석을 달아 CI가 컴파일하고 렌더링하도록 하세요. 세부 사항을 추가하기 전에 수평선/해안 접촉 및 시간적 필터링을 보존하세요.
기존 셰이더를 개선할 때:
- 렌더링 모델과 병목 현상을 식별하세요.
- 의도와 인터페이스를 보존하세요.
- 먼저 정확성을 수정한 다음, 가독성, 시각적 품질 및 속도를 수정하세요.
- 위험한 변경 사항(좌표 스케일, 재질 ID, 루프 횟수)을 명시하세요.