액체 로고 리빌
WebGL (Three.js) 기반의 유리 구슬이 물리적 투과, 노이즈로 변위된 표면, 분산 효과를 가지며 로고 앞에 위치합니다. 로고는 심하게 굴절되어 읽을 수 없습니다. 압력이 쌓이고, 모든 것이 잠시 멈춘 후 구슬이 터지며 15개의 물방울이 튀어 나가고, 마크는 왼쪽으로 슬라이드하며 워드마크가 그 뒤에서 나타납니다. 모든 프레임은 탐색 시간(seek time)의 순수 함수이므로 렌더링이 결정론적입니다.
입력
| 입력 | 참고 사항 |
|---|---|
| 로고 마크 | SVG 또는 PNG. 마크(심볼)만, 정사각형에 가까움, 투명 배경. |
| 워드마크 | 기본적으로 Inter 폰트로 조판된 텍스트 문자열. 브랜드에 실제 워드마크 그래픽이 있는 경우 "워드마크를 아트워크로"를 참고하세요. |
| 팔레트 | 세 가지 색상: 강한 악센트, 부드러운 틴트, 차분한 중성색. 이것들은 유리 뒤의 흐릿한 색상 필드가 됩니다. 유리는 무색이며 뒤에 있는 것만 보여줍니다. 워드마크의 잉크 색상. |
| 지속 시간 | 기본 7초. 락업이 안착된 후의 멈춤 구간만 늘려야 합니다. |
사용자가 제공했거나 브랜드 키트에 있는 자산만 사용하세요. 웹에서 로고를 가져오지 마세요.
래스터 전용 로고
- 템플릿은 알파 채널이 있는 PNG를 필요로 합니다. 로고에 불투명 배경(JPG, 흰색 박스)이 있는 경우 먼저 제거하세요 (
npx hyperframes remove-background, 또는 사용자에게 투명 파일을 요청하세요). 흰색 사각형이 구슬 안에서 굴절되는 결과물을 제공하지 마세요. - 작은 PNG(~600px 미만)도 괜찮습니다. 마크가 정지 상태에서 약 250px로 표시되지만 구슬 안에서는 약 360px로 확대되기 때문입니다. 원본의 긴 변이 최소 512px 이상인지 확인하세요.
- 투명 패딩을 잘라내어 보이는 마크가 이미지를 채우도록 하세요. 코드는 이미지 박스의 크기를 조정하며, 잉크 자체의 크기를 조정하지 않습니다.
- SVG: 긴 변이 약 1720px인 PNG로 래스터화하고(Headless Chrome 스크린샷, 또는
rsvg-convert -w 1720), 알파 채널을 유지한 후data-logo-src가 이를 가리키도록 하세요. 로고를 다시 그리거나 색상을 변경하지 마세요. - 브랜드 로고가 결합된 락업 이미지(마크와 텍스트가 결합)인 경우 깔끔하게 분할할 수 없습니다. 전체 락업을 마크로 사용하고,
data-wordmark=""로 설정한 후 워드마크 와이프를 건너뛰세요(워드마크 클립을 항상 숨김으로 설정). 그러면 마크가 왼쪽이 아닌 중앙에 도킹됩니다.
빌드 워크플로우
- 스캐폴드:
npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills를 실행한 후, 해당 디렉토리의index.html을 이 스킬의template/index.html로 교체하고template/js/,template/assets/logo.png를 복사하세요(브랜드 마크로 덮어씁니다). - 런타임을 벤더링하여 렌더링이 네트워크에 접근하지 않도록 합니다. 임시 디렉토리(다른 프로젝트 내부가 아닌,
npm i가 가장 가까운 package.json까지 올라가므로)에서npm i [email protected] [email protected] @fontsource-variable/inter를 실행한 후, 다음 파일들을 프로젝트로 복사하세요:gsap/dist/gsap.min.js를vendor/gsap.min.js로three/build/three.module.js와three/build/three.core.js를vendor/three/build/로three/examples/jsm/environments/RoomEnvironment.js를vendor/three/examples/jsm/environments/로@fontsource-variable/inter/files/inter-latin-wght-normal.woff2를assets/fonts/로
index.html의#root에 데이터 속성을 사용하여 브랜딩합니다:data-logo-src,data-wordmark,data-ink,data-fields(세 개의 16진수 색상). 필드는 악센트에서 채도를 유지하고 다른 곳에서는 부드럽게 유지하세요. 구슬 중심 뒤의 필드를 어둡고 평평하게 만들지 마세요.- 린트 및 확인:
npx --yes hyperframes lint후npx --yes hyperframes check를 실행합니다. 둘 다 깨끗해야 합니다. - 프레임 검토(아래 참조). 조정. 반복.
- 렌더링:
npx --yes hyperframes render --workers 2 --output final.mp4. 프로브:ffprobe가 h264, 1920x1080, 30fps, 예상 지속 시간을 보고해야 합니다.
모션 규칙 (형식을 작동하게 만드는 요소)
- 읽을 수 없지만 보이지 않지는 않음. 팝 전까지 시청자는 마크의 색상과 왜곡된 형태를 보아야 하며, 결코 읽을 수 없어야 합니다. 프레임에서 로고가 식별 가능하게 보이면
thickness/ 변위 진폭 / 회전을 높이세요. 구슬이 마크의 흔적 없이 평평한 덩어리라면 낮추세요. - 마크는 유리 뒤, 불투명 패스에 위치. 팝 전 평면은
alphaTest(불투명 큐)를 사용하여 Three.js의 투과 패스가 이를 굴절시킬 수 있도록 합니다. 일반적인transparent: true평면은 굴절되지 않습니다. "공개된" 복사본은 투명하며 쉘이 붕괴된 후에만 교체됩니다. - 단계 순서 (
js/liquid-reveal.js상단의 모든 상수T): 설정(근접 크롭에서 전체 구슬, 0.7초) 후 액체 퍼포먼스, 압력 축적(구슬이 더 넓고 납작해지며, 마크가 1.00에서 1.06으로 팽창), 쉼표(총 0.4초 정지: 카메라, 마크, 구슬 및 셰이더 클록이 멈춤), 파열(쉘이 0.2초 동안 power-4 이즈인으로 붕괴, 물방울이 방사형으로 발사), 도킹(마크가 반동한 후 잠금 위치로 슬라이드하는 동안 워드마크가 뒤에서 나타남), 정지. - 정지가 핵심입니다. 팝 전 0.4초 정지가 파열을 실감나게 만듭니다. 어디에도 유휴 호흡, 부동 또는 루핑 글로우가 없어야 합니다.
- 셰이더 클록은 제한됨. 노이즈 시간은 지정된 창에서만 진행되며 쉼표와 도킹 후에는 멈춥니다.
- 워드마크는 마크에서 나타나며, 절대 갑자기 나타나지 않음. 클립 왼쪽 가장자리는 마크의 오른쪽 가장자리를 추적하므로 텍스트가 도킹 중간에 마크에 의해 겹쳐지지 않습니다.
- 물방울: 황금각 고정 레이아웃(
Math.random없음), 방사형 발사, 하나의 중력 항, 그 후 최종 프레임을 깨끗하게 유지하기 위해 축소되어 사라짐. - 정지된 락업으로 종료. 마크와 워드마크가 똑바로 서서 쌍으로 중앙에 위치하며, 페이드 아웃 없음. 더 긴 비디오에 삽입될 인트로인 경우 페이드 대신 정지 시간을 줄이세요.
- 결정론: 모든 것은
hf-seek시간으로부터 계산됩니다.requestAnimationFrame,Date.now,Math.random없음. 유일한 DOM 측정은 워드마크 너비로, 로드 시 한 번만 수행됩니다(제공된 폰트로 canvasmeasureText사용).
조정 노브
| 원하는 것 | 변경 사항 |
|---|---|
| 더 길거나 짧게 | T 상수와 #root의 data-duration, 두 .clip 요소의 data-duration (동일하게 유지) |
| 더 추상적인 구슬 | thickness (3.2) 또는 변위 진폭 (0.15) 증가; 가독성을 위해 감소 |
| 젤리 vs. 물방울 모양 | liquidMaterial()의 dispersion, attenuationColor |
| 더 크거나 작은 락업 | L.markPx, L.fontPx, L.gap |
| 더 차분한 배경 | 배경 셰이더에서 세 개의 * 0.50 / 0.80 / 0.35 필드 가중치 낮춤 |
워드마크를 아트워크로
브랜드가 워드마크 SVG/PNG를 제공하는 경우, #wordmark 텍스트를 동일한 위치 및 너비 로직을 가진 <img>로 교체하세요: 종횡비를 측정하고 높이를 L.fontPx * 0.8로 설정한 후 동일한 clip-path 로직을 유지하세요. 양식화된 워드마크를 대체 폰트로 다시 입력하지 마세요.
검증
lint와check가 깨끗해야 함(린트 오류는 레이아웃 감사를 자동으로 비활성화함).- 프레임을 추출하여 확인:
npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5를 실행하고snapshots/contact-sheet.jpg를 열거나, 렌더링에서ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png를 실행하세요. 확인 사항: (1) 초기 프레임에서 마크를 읽을 수 없는 구슬이 보여야 함, (2) 팝 직후 프레임에 마크와 겹치는 워드마크 텍스트가 없어야 함, (3) 도킹 중간 텍스트가 마크 가장자리로 잘려야 함, (4) 최종 프레임에 선명한 마크와 워드마크가 중앙에 있고, 물방울이나 잘린 글리프가 없어야 함. - 일반적인 실패: 빈 캔버스(importmap 경로가 잘못되었거나 WebGL
three.core.js가 복사되지 않음), 워드마크가 중앙에서 벗어남(측정 전에 폰트가 로드되지 않음), 흰색 박스가 있는 로고(불투명 PNG).
전달
final.mp4와 프로젝트 폴더(index.html, js/, assets/, vendor/)를 전달하여 data-* 속성 편집을 통해 리브랜딩할 수 있도록 합니다. 오디오는 선택 사항입니다. 파열 시간 T.pop에 짧은 팝 SFX가 필요한 유일한 사운드입니다. media-use 스킬을 통해 상업적으로 라이선스된 결과물로 사운드를 확보하거나, 그렇지 않으면 무음으로 전달하세요.