Communitygithub.com

Weft

이미지, 비디오, 웹캠 또는 캔버스를 직물의 스캔라인 바 모자이크(베틀의 실이나 리소그래프 인쇄물 같은 짧은 컬러 막대의 행)로 재구성합니다. 움직일 때는 거친 블록으로 분해되고 정지할 때는 미세한 디테일로 돌아오며, 잘라낸 피사체는 깊이 시차에 의해 커서 방향으로 3D 회전합니다. 막대 모자이크, 스캔라인/줄무늬/선 디더링 초상화, 리소그래프 또는 하프톤 바 효과, 글리치에서 디테일로의 전환, 이 스타일의 커서 추적 초상화 또는 아바타를 요청할 때 사용하세요. TypeScript + WebGL2, 모든 웹 페이지 또는 프레임워크에서 작동합니다.

Weft란 무엇인가요?

Weft는 이미지, 비디오, 웹캠 또는 캔버스를 종이 질감 위에 짧은 컬러 막대 행(스캔라인 바 모자이크)으로 다시 그리는 TypeScript + WebGL2 엔진입니다. 각 행은 지터된 셀로 나뉘며, 각 셀은 해당 위치의 그림에서 가장 가까운 팔레트 색상을 선택합니다(때로는 2순위로 디더링). 움직임이 있을 때 행은 큰 블록으로 확대되고 셀은 초당 여러 번 재분할되어 거친 모자이크에서 세밀한 디테일로 전환되는 독특한 효과를 만듭니다. 투명 또는 단색 배경에서 잘라낸 피사체는 실루엣 기반의 부드러운 깊이 돔을 얻어 커서 방향으로 회전(요 및 피치)할 수 있으며, 전체 프레임 이미지는 중앙에 완만한 돔이 적용됩니다. 이 스킬은 Vite 데모, 포괄적인 옵션 참조, React 통합 레시피, 그리고 원본 소스 이미지의 미세한 디테일을 유지하면서 독특한 예술적 스타일을 구현하기 위한 모범 사례를 포함한 완전한 구현을 제공합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/JDhruv14/weft/tree/HEAD

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

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

문서

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이 기능을 구축하면서 잘못된 점과 이를 피하는 방법.

워크플로우

  1. 소스와 작업을 확정하세요. 정지 이미지, 비디오, 웹캠 또는 페이지에서 이미 그리고 있는 캔버스입니까? 히어로, 카드, 전체 페이지 중 어디에 위치합니까? 원하는 모션은 무엇입니까: 커서 조종, 유휴 드리프트, 리빌 또는 이미지 간 전환?
  2. src/weft.ts를 프로젝트에 복사하고 파일을 그대로 유지하세요. 번들러나 tsc만 필요하며, 모든 TS 프로젝트에는 이미 있습니다. 일반 JS 페이지의 경우 npx tsc 또는 esbuild로 한 번 컴파일하세요.
  3. demo/main.ts에서 시작하여 아래 결정 사항을 사용하여 옵션을 설정하세요.
  4. 먼저 정지 이미지 하나를 보여주세요. ?freeze=0&yaw=-20&pitch=8&break=0으로 포즈를 고정하고 더 많은 기능을 추가하기 전에 살펴보세요. 정면, 양쪽 회전, 기울기 및 분할 프레임(break=1)을 확인하세요. 사용자가 참조를 제공한 경우 정지 이미지를 참조 프레임 옆에 놓고 팔레트, 행 높이 및 종이 색상을 비교하세요.
  5. 그런 다음 모션을 확인하세요. 실시간으로 전환을 확인하세요. 분할은 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

관련 스킬