omd-shader-hero — 하나의 장면, 두 가지 브랜드 잉크
런칭 히어로는 당신에게 아무것도 빚지지 않은 누군가의 시선을 한 번에 사로잡아야 합니다. 메시 그래디언트는 웹에서 가장 평범한 셰이더 외형이며, 두 가지 보색 브랜드 색상을 혼합하면 갈색으로 변합니다. 이 스킬은 정반대 방식을 사용합니다: 두 가지 평평한 잉크, 즉 기본 색상과 하나의 브랜드 색상을, 스크린 인쇄를 통과하는 빛처럼 천천히 접히는 정렬된 디더 필드로 인쇄합니다. 모든 픽셀은 하나의 잉크이거나 다른 잉크이므로 혼합되지 않고 진흙탕이 되지 않습니다. 카피는 리소 포스터의 컷아웃 패널처럼 기본 잉크로 단단히 녹아웃된 영역 위에 배치됩니다.
스크립트는 두 잉크, 텍스트 색상 및 명암비를 DESIGN.md에서 모두 추출합니다. 취향에 따라 색상이 선택되지 않습니다.
작동 예제: examples/hero.html, 가상의 examples/DESIGN.example.md로 채워짐. 스크립트: scripts/tokens.mjs (잉크 + 명암비), scripts/verify.mjs (실제 렌더링 증명).
1. 사용 시기 / 사용하지 말아야 할 때
다음과 같은 경우 사용하세요:
- 런칭, 제품, 대기자 명단, 이벤트 또는 리브랜딩 페이지에 모션이 있는 첫 화면이 필요할 때;
- 프로젝트에 브랜드 색상과 어두운(또는 밝은) 베이스를 포함한
DESIGN.md가 있을 때 (Core v2 Foundations 토큰, Foundations prose 쌍, 또는 Google 호환colors:frontmatter); - 그래픽적이고, 인쇄된 듯하며, 자신감 있는 느낌이 브랜드에 맞을 때.
사용하지 마세요:
- DESIGN.md나 브랜드 색상이 없을 때.
tokens.mjs가 3번 코드로 종료되며 중단합니다.omd-init을 실행하거나 질문하세요. 빈 공간을 채우기 위해 "멋진" 색상을 절대 선택하지 마세요 (알 수 없음은 부재를 의미함); - 브랜드가 부드럽거나, 사실적이거나, 럭셔리하게 조용한 경우. 디더 필드는 시끄럽습니다. 대신 브리프의 사진을 사용하세요 (tf-shaders "photo first");
- 페이지에 여러 셰이더 장면이 필요한 경우. 하나의 장면과 최대 하나의 작은 악센트만 사용하세요 (tf-shaders 규칙). 전체 스크롤 스토리가 필요하면
omd-landing을 사용하세요.
2. 절차
- 토큰을 읽고, 선택하지 마세요.
스크립트는 다음 세 가지 형식을 이 순서대로 읽습니다:node <skill>/scripts/tokens.mjs DESIGN.md # 결정 사항을 JSON으로 출력 node <skill>/scripts/tokens.mjs DESIGN.md --scheme light # 어두운 대신 밝은 베이스 사용- **color.<role>**: \#hex`토큰, Foundations 섹션 내의Name (`#hex`)쌍, 그다음 frontmattercolors:`. 그런 다음:- 상태 및 유틸리티 역할(danger, error, warning, success, info, border, divider, focus, disabled, overlay, shadow, hover, pressed, active)을 제거합니다;
- 가장 어두운 토큰을 베이스 잉크로 사용합니다 (
light의 경우 가장 밝은 것); - 하나의 브랜드 잉크를 사용합니다: primary/brand라는 이름의 역할이 있으면 그것을, 그렇지 않으면 베이스에 너무 가깝지 않은 가장 채도가 높은 브랜드 색상을 사용합니다.
- 텍스트 색상은 계산됩니다. 스크립트는 텍스트 후보(스킴의 반대쪽 끝에 있는 ink/neutral 토큰)를 두 잉크 및 그 중간점과 비교하여 최적의 것을 선택합니다. 그런 다음 카피는 불투명한 베이스 잉크 녹아웃 위에 배치되므로, 통과해야 하는 기준은 베이스 잉크 위의 텍스트 토큰입니다. 표준 픽스처를 사용하면 18.8:1입니다. 이것조차 4.5:1 미만이면 스크립트가 경고합니다: 다른 텍스트 토큰을 선택하세요.
- 히어로를 작성하세요.
examples/hero.html을 복사(또는 포팅, §6 참조)하고 채우세요:
이 명령은node <skill>/scripts/tokens.mjs DESIGN.md --write path/to/hero.html#hero-varsCSS 블록(--hero-c0베이스,--hero-c1브랜드,--hero-text,--hero-scrim,--hero-scrim-a)과#hero-tokensJSON을 다시 작성합니다. - 카피는 실제입니다. 헤드라인 + 한 문장 + 하나의 CTA. 사용자의 실제 제품 라인을 사용하세요. 메트릭, 고객 또는 투자자를 절대 지어내지 마세요 (tf-shaders §0).
- 실제 GPU에서 검증 (§5)하고 전체 크기로 프레임을 확인하세요.
3. 장면 및 두 가지 매개변수
Paper의 ditheringFragmentShader: type = 4x4 (ordered Bayer), colorBack = 베이스 잉크, colorFront = 브랜드 잉크, 그리고 .hero-scene의 data-shape으로 선택된 두 가지 필드 형태 중 하나:
data-shape | 필드 | 느낌 |
|---|---|---|
warp (기본값) | 브랜드 빛의 느린 대각선 주름, scale 1 | 리소 포스터, 두 모서리에 에너지 |
ripple | 카피 뒤 히어로를 중심으로 한 동심원, scale 0.5 | 중심점이 있는 인쇄물: 카피가 시선의 중심에 위치 |
형태는 구성의 선택이지 세 번째 매개변수가 아닙니다: 각 형태의 scale은 고정되어 있어 셀이 px 2–6에서 읽히며, 알 수 없는 값은 warp으로 대체됩니다. 두 형태 모두 두 가지 평평한 잉크를 유지합니다 (픽셀 수로 검증, §5). Paper의 다른 디더링 형태 및 기타 셰이더는 제외되었습니다: 대부분 가장자리에서 두 색상을 혼합하여 이 스킬이 존재하는 규칙을 위반합니다.
| 매개변수 | 범위 | 기본값 | 설명 |
|---|---|---|---|
speed (data-speed) | 0–1 | 0.3 | 주름의 이동 속도. 약 0.6 이상이면 화면 보호기처럼 보입니다. 0이면 필드가 멈춥니다. |
px (data-px) | 2–6 CSS px | 3 | 디더 셀 크기. 2 = 미세 스크린, 3 = 리소, 5–6 = 거친 인쇄물. |
레이아웃 규칙:
- 녹아웃, 스크림이 아님. 카피 상자는 단단한 가장자리를 가진 불투명한 베이스 잉크 패널 위에 위치합니다 (카피 주위 2rem × 2.5rem 여백). 반투명 스크림이나 부드러운 가장자리는 베이스를 브랜드 도트 위에 덧칠하여 번짐을 만듭니다. 작은 텍스트(푸터 레이블)도 자체 녹아웃을 받습니다.
- 명암비: 헤드라인과 서브 카피에 대해 4.5:1. 헤드라인은 WCAG에서 3:1을 허용할 만큼 크지만, 이 스킬은 이에 의존하지 않습니다.
verify.mjs는 둘 중 하나라도 4.5:1 미만이면 실패합니다. - 히어로 카피는 첫 프레임에 그려집니다:
opacity: 0이나 캔버스를 기다리지 않습니다. 캔버스는 이미 완성된 CSS 포스터 위에 600ms에 걸쳐 페이드 인됩니다. - 포스터도 두 가지 잉크입니다. 형태를 따르며 (
warp의 경우 모서리,ripple의 경우 링, 정지 프레임 이후 배치됨), 두 개의 단단한 가장자리 밴드(코어에서는 4×4 정사각형, 어깨 부분에서는 2×2)의 도트 크기로 톤을 얻으며, 절대 알파를 사용하지 않습니다: 희미해진 마스크는 베이스 위에 브랜드를 혼합합니다. Bayer 셀처럼 전체 픽셀의 정사각형 도트. - 한국어 디스플레이 타입은
/hangul을 따릅니다:keep-all+overflow-wrap: anywhere, 줄 높이 1.3, 자간 -0.02em (절대 -0.03em 미만),text-wrap: balance,font-synthesis: none. - 배경은
body가 아닌html에 설정합니다 (body배경은 음수 z-index 장면 위에 칠해짐; tf-shaders 함정). - 모서리 반경, 타입 스케일 및 간격도 DESIGN.md에서 가져옵니다. 표준 픽스처는 반경을 정의하지 않으므로 CTA는 정사각형입니다.
4. 라이브러리, 라이선스, 예산, 폴백
라이브러리: @paper-design/shaders 0.0.82 (vanilla ShaderMount + ditheringFragmentShader), WebGL2. 0.0.82 (2026-10-21)는 shader-mount.js만 변경합니다: dispose()가 이제 WebGL 컨텍스트를 해제합니다. 라이선스는 2026-10-13에 npm tarball의 LICENSE 파일, npm 메타데이터 및 GitHub 라이선스 API에서 확인됨:
@paper-design/shaders 0.0.81 | shaders 4.0.4 (shaders.com) | |
|---|---|---|
| 라이선스 | Apache-2.0 (+ NOTICE "Paper Shaders, Copyright 2026 Paper") | MIT (© 2026 Shader Effects Inc.); 의존성 typegpu 0.12.3 MIT |
| 런타임 | WebGL2, 거의 보편적 | WebGPU 전용; 지원되지 않을 때 투명 캔버스 및 로그 없음 |
| 이 장면의 JS | 23.7 KiB min / 7.0 KiB gzip (esbuild); CDN 파일별 +esm 5.0 + 2.9 KiB gzip | 2,535 KiB min / 710 KiB gzip (Shader + MeshGradient) |
| 텔레메트리 | 없음 | 기본적으로 켜짐 (5% 샘플링으로 shaders.com/api/telemetry 전송); 반드시 사용해야 한다면 disableTelemetry 전달 |
| npm 주간 다운로드 (2026-10-05..11) | 1,104,377 (-react) | 287,493 |
Paper는 도달 범위, 가벼움 및 텔레메트리 측면에서 우수합니다. shaders는 이미 WebGPU 장면을 제공하는 프로젝트를 위한 업그레이드 경로일 뿐입니다. 그곳에서는 이 토큰 파이프라인, 녹아웃 및 폴백을 유지하고 disableTelemetry를 전달하세요. 두 라이선스 모두 스킬 및 템플릿에서 사용을 허용합니다. 예제는 고정된 CDN URL에서 Paper를 가져오며 벤더링하지 않습니다. Paper의 파일을 벤더링하는 경우 해당 NOTICE도 함께 복사하세요.
예산:
- JS: 7.0 KiB gzip 라이브러리 + 1.1 KiB gzip 장면 코드.
- GPU: 하나의 전체 뷰포트 쿼드, 두 가지 색상, ordered dither. 셀 크기가 해상도이므로
minPixelRatio: 1및maxPixelCount1920×1080. Paper는 화면 밖 및 숨겨진 탭에서 일시 중지됩니다. - 이미지, 비디오, UI 페이스 외 추가 글꼴 없음.
폴백 (설계의 일부, 사후 고려 사항이 아님):
- 캔버스 아래 CSS 하프톤 포스터: 베이스 잉크 위 브랜드 잉크의 도트(
radial-gradient6px 셀), 두 모서리 쪽으로 마스킹됨. 이것은 첫 번째 페인트이며, no-WebGL2 경로(ShaderMount가 컨텍스트 없이 예외를 발생시킴; 페이지가 먼저getContext('webgl2')를 탐색함), 그리고 CDN에 연결할 수 없는 경우의 상태입니다.verify.mjs는 이 경로를 강제합니다. prefers-reduced-motion: reduce: 고정 프레임(STILL_FRAME, 8000ms)에서 속도 0. rAF 루프가 없는 하나의 정지된 구성입니다.
5. 실제 GPU에서 검증
npm i -D playwright-core && npx playwright-core install chromium # 새로운 Playwright Chromium, 사용자의 Chrome이 아님
node <skill>/scripts/verify.mjs path/to/hero.html ./hero-verify --frames 48 --seconds 12 --shape all
--shape warp|ripple|all은 페이지의 모듈이 실행되기 전에 data-shape을 설정합니다. 각 형태에 대해 네 가지 패스(1440px GPU, 390px 모바일, reduced-motion, no-WebGL)를 --enable-gpu --ignore-gpu-blocklist --use-angle=metal (macOS)로 실행하며, 각 패스에 대해:
- WebGL 렌더러를 기록하여 실제 GPU 또는 SwiftShader가 프레임을 그렸는지 알 수 있습니다;
- 12초 동안 셰이더 클록을 결정론적으로 진행하고 프레임을 저장합니다 (ffmpeg → 데모 GIF/MP4);
- 명암비 측정: 카피를 숨기고, 모든 프레임에서 헤드라인 및 서브 카피 뒤의 장면을 샘플링하고, 텍스트 색상에 대한 최악의 비율을 취합니다. 둘 중 하나라도 4.5:1 미만이면 실패합니다;
- 잉크 수 계산: 녹아웃 외부에서 캔버스 및 CSS 포스터의 모든 픽셀은 베이스 잉크 또는 브랜드 잉크여야 합니다 (
twoInksScene,twoInksPoster); - 포스터가 캔버스보다 먼저: 페이지 자체 클록에서: 초기화 스크립트가 각 렌더링된 프레임을 샘플링하고 포스터가 화면에 나타나는 첫 번째 프레임과 캔버스가 그려지고 투명하지 않은 첫 번째 프레임, 그리고 페인트 타이밍 및 LCP를 기록합니다;
- GPU 패스의 프레임 시간: 필드가 실행되는 동안 3초간의 rAF 간격, 중앙값 및 p95;
- 캔버스(포스터가 아님)가 화면에 있는지, 필드가 움직이는지, 헤드라인이 로드 시 완전한 불투명도인지, reduced motion이 정지 상태인지, no-WebGL이 캔버스 없이 포스터를 표시하는지 확인합니다.
2026-11-06에 표준 픽스처(headless Chromium, ANGLE Metal Renderer: Apple M5 Pro)로 측정된 결과, 모든 검사가 두 형태 모두 통과했습니다:
| 형태 | 최악 헤드라인 / 서브 카피 | 다른 잉크 픽셀 (장면 / 포스터) | 포스터 프레임 → 캔버스 프레임 (GPU 패스) | 프레임 ms (중앙값 / p95) |
|---|---|---|---|---|
| warp | 모든 네 패스에서 18.81 / 18.81 | 0 / 0 | 62 → 112 ms | 8.3 / 9.2 |
| ripple | 모든 네 패스에서 18.81 / 18.81 | 0 / 0 | 44 → 127 ms | 8.3 / 9.2 |
6. Next.js / React 포팅
섹션, 카피, 녹아웃 및 포스터를 일반 HTML/CSS로 서버 렌더링합니다 (포스터는 JS가 필요 없음). 빌드 시 tokens.mjs --json에서 CSS 변수를 생성하고, 런타임에는 생성하지 마세요. 장면을 'use client' 리프에 마운트하세요:
useEffect(() => {
if (!probeWebGL2() || !ref.current) return; // 포스터 유지; 정리할 것 없음
let m: { dispose(): void } | undefined;
(async () => {
const { ShaderMount, ditheringFragmentShader } = await import('@paper-design/shaders');
try { m = new ShaderMount(ref.current!, ditheringFragmentShader, uniforms, undefined, reduce ? 0 : speed, 8000, 1, 1920 * 1080); }
catch { /* 포스터 유지 */ }
})();
return () => m?.dispose();
}, []);
7. 기여
소유자의 tf-shaders 실험(skill/shader-landing/SKILL.md, RESEARCH.md, scripts/shoot.mjs, 2026-10)에서 가져옴: 하나의 장면과 최대 하나의 악센트, 명시된 JS 예산, 모든 캔버스 아래 CSS 포스터, html의 배경, 타입 뒤의 조용한 상태, 최악의 프레임에서 확인된 명암비, 첫 프레임 히어로 카피, 상태 변경으로서의 reduced motion, 실제 GPU 스크린샷 루프. 이 스킬은 토큰 파이프라인, 두 잉크 디더, 녹아웃, 측정된 명암비 및 WebGL2 런타임 선택을 추가합니다.
금지 사항
- 세 번째 색상을 추가하거나 두 잉크를 혼합하지 마세요 (그래디언트, 반투명 오버레이, 부드러운 패널). 두 가지 평평한 잉크가 핵심입니다; 보색 간의 혼합은 진흙입니다.
- DESIGN.md 토큰이 아닌 색상을 사용하지 마세요, 특히 상태 색상(위험 빨간색을 브랜드 잉크로)을 사용하지 마세요.
- 텍스트를 디더 필드 위에 직접 배치하지 마세요. 카피는 녹아웃 위에; 작은 텍스트는 자체 녹아웃을 받습니다.
- 반응형 중단점마다 셰이더를 바꾸거나 컴파일 타임 프로퍼티를 애니메이션하지 마세요. 잉크 값이나
px를 변경하는 것은 균일한 쓰기이며 괜찮습니다. - 히어로를
body배경 위에 쌓지 말고, 헤드라인을 페이드 인하지 마세요. - 같은 페이지에 Paper와
shaders를 모두 로드하지 마세요.