Weft은(는) 무엇을 하나요?
모든 그림은 종이 바탕 위에 짧은 컬러 막대 행으로 다시 그려집니다. 각 행은 지터된 셀로 나뉩니다. 셀은 그 지점의 그림과 가장 가까운 팔레트 색상을 취하며, 때로는 2순위 색상으로 디더링됩니다. 막대는 강한 영역에서는 전체 너비로, 희미한 영역에서는 좁게 나타나며, 가장자리가 통과하는 셀은 얇은 줄무늬로 분할됩니다. 무언가 움직일 때 행은 큰 블록으로 올라가고 셀은 초당 여러 번 재절단됩니다. 정지하면 다시 미세한 디테일로 내려옵니다. 그 전환이 이 룩의 핵심이므로 보호하세요.
평범하거나 투명한 배경에서 잘라낸 피사체는 실루엣에서 부드러운 깊이 돔을 얻어 늘어짐 없이 회전(요) 및 기울기(피치)할 수 있습니다. 점은 깊이에 따라 옆으로 미끄러지고 빛은 돔 위를 굴러갑니다. 전체 프레임 그림은 대신 부드러운 중앙 돔을 얻습니다. 피사체는 자동으로 프레임 중앙에 유지됩니다.
파일
| 경로 | 내용 |
|---|---|
src/weft.ts | 엔진. 하나의 엄격한 타입스크립트 모듈로 런타임 의존성 없음: createWeft(canvas, options), enableDrop, PALETTES, 그리고 타입 WeftOptions, WeftConfig, Weft. |
demo/ | 커서를 따라 회전하는 초상화, 팔레트 및 막대 방향 전환, 웹캠, 드래그 앤 드롭, URL 매개변수(Vite). |
references/options.md | 모든 옵션, 기능 및 유용한 범위. |
references/recipes.md | 통합: React, 히어로, 호버 카드, 스크롤, 슬라이드쇼, 리빌, 웹캠, 참조 일치. |
references/pitfalls.md | 이 기능을 구축하면서 잘못된 점과 이를 피하는 방법. |
워크플로우
- 소스와 작업을 확정하세요. 정지 이미지, 비디오, 웹캠 또는 페이지에서 이미 그리고 있는 캔버스입니까? 히어로, 카드, 전체 페이지 중 어디에 위치합니까? 원하는 모션은 무엇입니까: 커서 조종, 유휴 드리프트, 리빌 또는 이미지 간 전환?
src/weft.ts를 프로젝트에 복사하고 파일을 그대로 유지하세요. 번들러나tsc만 필요하며, 모든 TS 프로젝트에는 이미 있습니다. 일반 JS 페이지의 경우npx tsc또는esbuild로 한 번 컴파일하세요.demo/main.ts에서 시작하여 아래 결정 사항을 사용하여 옵션을 설정하세요.- 먼저 정지 이미지 하나를 보여주세요.
?freeze=0&yaw=-20&pitch=8&break=0으로 포즈를 고정하고 더 많은 기능을 추가하기 전에 살펴보세요. 정면, 양쪽 회전, 기울기 및 분할 프레임(break=1)을 확인하세요. 사용자가 참조를 제공한 경우 정지 이미지를 참조 프레임 옆에 놓고 팔레트, 행 높이 및 종이 색상을 비교하세요. - 그런 다음 모션을 확인하세요. 실시간으로 전환을 확인하세요. 분할은 1초 미만으로 지속되므로 한 번 보는 것보다 화면 녹화를 프레임 단위로 단계별로 확인하세요. 세 가지를 확인하세요: 움직일 때 분할이 명확하고, 모든 정지 상태에서 완전히 선명하게 해결되며, 회전 한계에서 늘어짐이 없어야 합니다.
결정 사항
피사체 (subject.mode):
'auto'(기본값)를 사용하세요. 투명 PNG는'alpha'를 사용합니다. 테두리가 대부분 한 가지 색상인 프레임은'backdrop'을 사용하며, 테두리에서 배경을 플러드 필(flood-fill)하고 그라데이션을 따라가며 떨어진 반점을 제거합니다. 그 외의 경우'none'을 사용합니다.- 풍경, 아트워크 및 스크린샷의 경우
'none'을 강제하여 크림색 하늘이나 종이 테두리가 잘리지 않도록 합니다. - 복잡한 배경이 피사체로 새어 들어오는 경우
subject.tolerance(기본값 0.16)를 조정하거나 잘라낸 PNG를 전달하는 것이 좋습니다.
팔레트 (palette):
- 프리셋을 선택하세요:
ember(따뜻한 리소, 피부에 최적),graphite,riso,tide,candy,night(어두운 바탕에 밝은 막대),phosphor또는source(그림 자체의 색상, 포스터라이즈됨). - 자신의 16진수 색상(최대 16개)을 전달하고
paper를 설정할 수도 있습니다. - 색상은 가장 가까운 순서로 일치됩니다. 그림에 필요한 각 색조 계열에 어두운 색, 중간 색, 밝은 색을 포함하세요. 그렇지 않으면 얼굴이 평평하거나 탁해집니다.
- 어두운
paper에서는 밝은 영역의 막대가 자동으로 넓어집니다.
방향: 'rows'(가로, 클래식 룩) 또는 'columns'를 사용하세요.
프레이밍: focus: 'subject'(기본값)는 잘라낸 피사체의 경계 상자를 중앙에 맞춥니다. 피사체가 프레임에 의해 잘리지 않는 축에서만 이동합니다. 'frame'을 사용하면 그림이 구성된 대로 유지됩니다.
모션 (motion, turn):
pointer: true는 커서가 조종하도록 합니다: x는 회전, y는 기울기입니다. 모서리는 타원 위에 고정되므로 대각선 방향에서는 전체 요와 전체 피치가 동시에 쌓이지 않습니다.idle은 포인터가 정지했을 때의 동작을 결정합니다.'poses'는motion.poses를 통해 드리프트하고,'center'는 정면으로 부드럽게 돌아가며,'hold'는 그 자리에 유지됩니다.- 평평한 그림의 경우
turn.yaw를 34° 이하,turn.pitch를 20° 이하로 유지하세요. 전체 프레임 그림은 약 10~15°의 요를 원합니다. - 전환만 필요한 평평한 모자이크의 경우
turn.enabled: false를 사용하세요.
전환:
- 회전하면 막대가 자동으로 분할됩니다. 클릭, 스크롤 속도, 슬라이드 변경 또는 비트와 같은 다른 모든 경우
weft.kick(amount)를 호출하세요. transition.intro는 로드 시 거친 상태에서 해결되며,transition.onSource는 소스가 변경될 때 동일한 작업을 수행합니다.rows.coarse / rows.fine을 약 4~6배로 유지하세요.
API 개요
import { createWeft, enableDrop, type WeftOptions } from './weft';
const weft = createWeft(canvas, {
source: 'portrait.png', // URL, <img>, <video>, <canvas>, File/Blob 또는 'camera'
palette: 'ember', // 또는 ['#1c1a27', ...], 또는 'source'
direction: 'rows',
turn: { yaw: 30, pitch: 18 },
motion: { pointer: true, idle: 'poses' },
onSource: (w, h) => { stage.style.aspectRatio = `${w} / ${h}`; },
});
await weft.loaded;
weft.kick(0.8); // 지금 분할
weft.set({ palette: 'night' }); // 실시간 옵션 변경, 깊은 병합
weft.pose(-20, 6); // 코드로 조종; pose(null)은 제어권 반환
weft.setSource('camera');
enableDrop(weft); // 이미지/비디오 파일을 아무 곳에나 드롭
weft.destroy();
캔버스는 CSS 상자를 채우며, 페이지가 레이아웃을 소유합니다. data-weft-ui로 표시된 요소는 고정된 정지 이미지에서 숨겨집니다. weft.advance(dt, x, y)는 시뮬레이션된 시계를 진행시켜 프레임 정확한 렌더링을 제공합니다.
품질 유지 규칙
- 실제 픽셀을 사용하세요. 사람의 사진이나 아바타를 다시 그리거나, 추적하거나 "정리"하여 입력으로 제공하지 마세요. 효과 자체가 스타일화입니다.
- 종이를 차분하게 유지하세요. 밝은 팔레트에는 크림색, 본색 또는 오프화이트; 어두운 팔레트에는 약간의 색조가 있는 거의 검은색을 사용하세요. 순수한 #fff와 #000은 피하세요.
- 전환에는 시간 대비가 필요합니다. 움직임은 거친 끝까지 도달할 수 있을 만큼 빠르고, 정지는 완전히 해결될 수 있을 만큼(약 1초 이상) 길어야 합니다.
- UI는 아이콘 전용이며 조용해야 합니다: 모서리에 낮은 불투명도로,
data-weft-ui로 표시하세요. prefers-reduced-motion을 존중하세요. 엔진은 이미 정지 상태의 미세한 모자이크를 보여줍니다.- 모서리와 가장자리를 확인하세요: 왼쪽 끝, 오른쪽 끝, 위, 아래 및 대각선을 완료하기 전에 확인하세요.
데모 실행
npm install
npm run dev # Vite, 데모 열기
npm run typecheck # 엄격한 tsc