Khatt: 애니메이션 아랍어 서예
Khatt은 HarfBuzz로 텍스트를 정형화(문자 결합, 오른쪽에서 왼쪽, 부호 배치)하고, 배치한 후 하나의 SVG 파일 내에서 순수 CSS로 애니메이션을 만듭니다. 네트워크도 설치도 필요 없습니다. 스크립트, 폰트, 셰이핑 엔진이 모두 이 폴더에 있습니다.
그림 만들기
node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg
이 스킬 폴더에서 실행하거나 scripts/khatt.mjs의 전체 경로를 사용하세요.
출력 파일은 사용자가 원하는 위치(프로젝트 폴더, 바탕화면 등)에 저장하세요.
| 옵션 | 값 |
|---|---|
--style | ruqaa (일상적, 기울임), naskh (고전 필기체), kufi (각진), nastaliq (펄시아식 걸림), kano (두꺼운 갈대펜), blaka (굵은 기하학) |
--layout | line, arc, circle (중앙 별이 있는 고리), mirror (고전적인 대칭 무산나 양식) |
--effect | ink, gold, bleed, mosaic, sand, neon, stars, lantern, rise, stamp, reveal, wave, 또는 .mjs 효과 파일 경로 |
--palette | paper, night, neon, zellige, desert, clear (투명) |
--ink, --accent, --bg | 색상 덮어쓰기, 예: --ink "#0b3d2e" --bg none |
--still | 완성된 그림에서 멈춤 (로고 및 인쇄용에 좋음) |
-o | .svg는 파일 자체, .html은 클릭 시 재생되는 페이지 |
node scripts/khatt.mjs --list를 실행하면 모든 옵션과 짧은 설명을 볼 수 있습니다.
텍스트 안에 \n을 사용하면 두 번째 줄을 추가할 수 있습니다 (최대 4줄).
잘 선택하기
- 이름 및 영어 단어: Khatt은 아랍어 스크립트만 그립니다. 먼저 음역하세요 (Sara → سارة, Kamangir → كمنجير). 철자가 여러 방식으로 될 수 있는 경우, 렌더링 전에 사용자에게 철자를 보여주세요.
- 라마단 또는 이드:
lantern또는gold효과에night팔레트, 스타일naskh또는ruqaa를 사용하세요. - 결혼식 및 공식 카드:
gold,rise또는ink효과;--layout mirror시도. - 로고:
--still, 스타일kufi또는blaka,--palette clear. - 소셜 게시물: 애니메이션
.svg는 브라우저가 있는 곳 어디서나 재생됩니다. 동영상이 필요하면 사용자를 스튜디오(https://m-alkassem.github.io/khatt/)로 안내하세요. MP4를 내보냅니다. - 짧은 텍스트가 가장 좋습니다. 긴 문장:
line레이아웃, 2-3줄.
가능하다면 사용자에게 결과물을 열어 보여주세요 (예: macOS에서 open out.html).
새로운 효과 만들기
12가지 효과 중 어느 것도 맞지 않을 때 ("글자가 불타오르게", "흔들리는 라마단 등") 새 효과를 작성하세요.
examples/ripple.mjs에서 시작하세요. 효과는 import가 없는 일반 객체입니다:
export default {
id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
palette: "night", // 기본 팔레트 ID
loop: false, // 계속 움직이면 true
render(ctx) {
// return { css, defs?, body, duration, poster? }
},
};
render(ctx)가 받는 것:
ctx.pieces: 글리프당 하나의 항목:d(SVG 경로),order(읽기 순서, 0 = 첫 번째 문자),box{x0,y0,x1,y1},cx,cy. 대칭 복사본은 동일한 order를 공유합니다.ctx.steps,ctx.box(텍스트 상자),ctx.view(전체 캔버스),ctx.em(폰트 크기, 100),ctx.palette(bg,ink,accent),ctx.rng()(시드 기반 난수).ctx.stagger(order, spread?): 문자에 대한 지연,spread초에 걸쳐 분산.ctx.sample(piece, count): 문자 내부의 무작위 점, 입자 효과용.ctx.inside(piece, x, y),ctx.area(piece).ctx.anim(name, seconds, { ease, loop, alternate }): 클래스에 대한 애니메이션 CSS.ctx.at(seconds, extraStyle?): 요소의 지연을 설정하는 인라인 스타일.ctx.n(number): 숫자를 반올림하여 간결하게 출력.ctx.p: 고유 접두사. 모든 클래스, id 및 keyframe 이름에 사용하세요.
그림을 모든 프레임에서 일시 중지 가능하게 유지하는 규칙 (스틸 및 비디오 내보내기가 이에 의존함):
- 모든 애니메이션 요소는
class="${p}-a ..."및style="${at(seconds)}"를 받습니다. - 클래스 규칙에
ctx.anim(...)을 사용하세요. 직접animation:단축 속성이나animation-delay를 설정하지 마세요. - keyframes 이름을
${p}-something으로 지정하세요. 요소에${p}-b를 추가하여 자체 중심을 기준으로 크기 조정 또는 회전하세요. - CSS 속성만 애니메이션하세요 (
opacity,transform,stroke-dashoffset,fill-opacity, …). SMIL<animate>및 스크립트는 올바르게 정지되지 않습니다. - 가볍게 유지하세요: 최대 수천 개 요소.
그런 다음 실행하세요:
node scripts/khatt.mjs "نار" --effect ./my-effect.mjs -o fire.html
사용자가 마음에 들어하면, 풀 리퀘스트로 공유하도록 제안하세요:
https://github.com/M-Alkassem/khatt (효과는 src/effects/에 위치).