Communitygithub.com

shader-art-coding

GLSL 프래그먼트 셰이더(Shadertoy mainImage, WebGL2/GLSL ES 3.00)를 작성, 디버깅 및 아트 디렉팅합니다: SDF 레이마칭, 절차적 빌딩/도시, 2D 거리 필드 그래픽, 노이즈/fBm/도메인 와핑, 지형, 해양/연안 수광학, 구름 및 기타 볼륨, PBR 조명, 색상 및 톤 매핑. 검증된 GLSL 빌딩 블록 라이브러리와 번들러 및 체커를 제공합니다. 사용자가 셰이더, Shadertoy, GLSL/.frag/.glsl 코드, 레이마처, SDF 씬, 절차적 텍스처 또는 생성적 비주얼을 요청하거나 셰이더 수정, 최적화, 포팅 또는 설명을 원할 때 사용하세요. HLSL/Unity ShaderLab 또는 비그래픽 GPU 컴퓨트에는 사용하지 않습니다.

shader-art-coding란 무엇인가요?

이 스킬은 코드형 시각 엔지니어링 접근법을 사용하여 GLSL 프래그먼트 셰이더(Shadertoy mainImage, WebGL2/GLSL ES 3.00)를 작성, 디버깅 및 아트 디렉팅하기 위한 포괄적인 도구입니다. SDF 레이마칭, 절차적 빌딩/도시, 2D 거리 필드, 노이즈/fBm/도메인 와핑, 지형, 해양 수광학, 볼류메트릭 구름, PBR 조명, 색상 및 톤 매핑을 포함한 다양한 렌더링 모델을 지원합니다. 핵심 기능에는 검증된 GLSL 함수 라이브러리(“python3 scripts/glsl_tools.py search”)를 검색하는 스크립트, 사용된 함수만 인라인하는 번들러(“bundle”), 그리고 린팅 및 컴파일을 위한 체커(“check”)가 포함되어 있습니다. 스킬은 선형 컬러 파이프라인, 디버그 모드 전환, 좌표 규칙, NaN 소스 방지 및 정수 PCG 해시 사용과 같은 엄격한 컨벤션을 적용하여 Shadertoy 및 WebGL 호환성을 보장합니다. 피험자 라우팅, SDF 라이브러리, 렌더링 파이프라인, 노이즈 사용 사례, 절차적 빌딩, 지형, 수질, 셰이더 워크플로우, 구성 및 디버깅, 레시피 포뮬러에 대한 상세 참조 문서를 포함하고 있어 복잡한 절차적 비주얼을 계획, 구현 및 최적화하는 데 이상적입니다. 또한 검증된 시작점 역할을 하는 완전한 렌더링 검증 템플릿(예: raymarch-sdf.glsl, terrain.glsl, ocean.glsl, procedural-city.glsl)을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LyalinDotCom/gemini-shader-test-carbon/tree/main/shader-skills/skills/shader-art-coding

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Shader Art Coding

셰이더 작업을 시각 엔지니어링으로 취급하세요: 의도된 이미지에서 시작하여, 그것을 생성할 수 있는 가장 작은 수학적 모델을 선택하고, 검사 가능한 단계로 구축한 후 각 단계를 디버그 뷰로 검증하세요.

워크플로우

  1. 목표. 이미지를 명시하세요: 주제, 카메라 및 프레이밍, 주요 형태, 재질, 빛, 움직임.
  2. 경로. references/subject-routing.md에서 렌더링 모델과 시작 템플릿을 선택하세요: 2D 거리 필드 (포스터, 아이콘, 패턴), SDF 레이마칭 (객체, 캐릭터), 높이필드 마칭 (풍경), 볼륨 적분 (구름, 연기, 불).
  3. 라이브러리에서 조립. python3 scripts/glsl_tools.py search <단어> 또는 references/library-index.md로 빌딩 블록을 찾고 이름으로 호출하세요. 라이브러리 코드를 붙여넣거나 재유도하지 마세요; 이미 테스트되었습니다.
  4. 빠르게 첫 이미지. 좌표, 배경, 하나의 프리미티브, 하나의 조명. 그런 다음 디버그 뷰를 추가하세요.
  5. 순서대로 정제: 비율, 구성, 재질 분리, 조명, 분위기, 색상, 안티앨리어싱, 성능.
  6. 번들링 및 검사. 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.mdPerlin/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, 루프 횟수)을 명시하세요.

관련 스킬