Community이미지github.com

dnlgalleguillos/gauge-reference

Blender에서 참조 이미지나 노드 에디터 스크린샷의 룩을 재현하고, 팔레트, 노출(스톱), 대비, 색조, 초점, 구조 등의 일치도를 측정하여 수치 기반 수정을 제공합니다. 안전한 작업공간 시작/종료 및 헤드리스 노드 트리 읽기를 포함합니다. 이미지, 셰이더 또는 지오메트리 노드 스크린샷을 복사, 일치 또는 재현하라는 요청이 있을 때 사용하세요.

gauge-reference란 무엇인가요?

이 스킬은 Blender 사용자가 참조 이미지나 노드 에디터 스크린샷을 정량적으로 분석하고 재현할 수 있도록 설계된 도구입니다. 사용자가 '이렇게 보이게 해줘'라고 요청하면, 단순히 시각적으로 유사하게 만드는 것이 아니라 노출(스톱), 대비 비율, 색조 채널, 구조적 오차 등 수치적 측정값을 기준으로 일치도를 판단합니다. 스킬은 먼저 안전한 격리 작업공간을 생성하고(workspace.py), 참조 이미지의 평균 휘도, 대비, 클리핑, 채도, 팔레트, 선명도 맵 등을 측정합니다(ref_report.py). 또한 노드 스크린샷을 분석하여 연결 및 설정을 텍스트로 추출하고, 사용자가 직접 노드를 구축한 후 다시 읽어 비교합니다. 마지막으로 렌더링 결과물과 참조를 비교하여 각 항목별 수정값을 제시하고, 지정된 임계값(예: 노출 0.35스톱 이내)을 통과할 때까지 반복합니다. Claude Code, Cursor, Codex 등 Blender 스크립트를 실행할 수 있는 모든 AI 에이전트 플랫폼에서 사용 가능하며, 작업 완료 후 workspace.py로 안전하게 원래 상태를 복원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dnlgalleguillos/blender-gauge/tree/HEAD/skills/gauge-reference

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

게이지 참조 (Gauge reference)

'이렇게 보이게 해줘'는 숫자가 증명할 때 비로소 완료됩니다. 이 스킬은 참조를 측정값으로 변환하고, 격리된 컬렉션에 구축한 후 모든 렌더를 대상과 비교합니다.

권한 순서

  1. 사용자가 작성한 내용 (명시적인 값과 규칙).
  2. 노드 스크린샷: 연결과 설정을 결정합니다.
  3. 참조 렌더: 외형을 결정합니다.

직접 읽지 않고 추측한 내용은 모두 가정입니다: 답변에 나열하고 사용자에게 확인을 받으세요.

워크플로우

  1. 격리된 작업공간 시작: scripts/workspace.py action=begin name=match1 (카메라, 월드, 엔진, 뷰 설정을 저장하고 컬렉션을 생성합니다).
  2. 스크린샷 읽기: references/reading-node-screenshots.md 참조: 그래프를 텍스트(노드, 주요 값, 연결)로 작성한 후 구축하세요. 스크린샷의 작은 숫자는 잘못 읽기 쉽습니다; 불확실한 것은 표시하세요.
  3. 참조 측정: scripts/ref_report.py image=ref.png는 평균 휘도, 대비, 클리핑, 채도, sRGB 16진수 팔레트(점유율 포함) 및 4x4 선명도 맵(초점 위치)을 제공합니다. scripts/ref_colors.py는 특정 지점의 정확한 색상을 읽습니다; 16진수는 보이는 색상이고, linear는 셰이더에 입력되는 값입니다.
  4. 노드 구축: gauge.node_build / gauge.gn_make 사용 (gauge-materials, gauge-geonodes 참조). 그런 다음 구축한 내용을 scripts/node_text.py로 다시 읽고 기록한 내용과 비교하세요.
  5. 작게 렌더링한 후 scripts/ref_match.py image=mine.png reference=ref.png 실행. 각 실패한 검사는 하나의 수정값과 숫자를 제공합니다: 노출(스톱, 광원에 2^-stops 곱하기), 대비 비율, 채널별 색조, 구조적 오차.
  6. 한 가지를 변경하고, 렌더링한 후 다시 측정하세요. 게이트 통과 시 중단합니다 (기본값: 노출 0.35스톱 이내, 대비 비율 0.85-1.15, 색조 0.04 이내, 오차 <= 0.08).
  7. 종료: workspace.py action=end는 장면을 복원하고 삭제할 항목을 나열합니다; 사용자가 동의할 때만 confirm=true를 전달하세요.

도구

스크립트답변하는 질문
ref_report.py이 이미지에 무엇이 있는가 (다른 이미지와 얼마나 다른가)
ref_colors.py특정 지점의 정확한 색상
ref_match.py내 렌더가 충분히 가까운가, 무엇을 변경해야 하는가
node_text.py이 머티리얼 / 그룹 / 월드 / 컴포지터 트리에 무엇이 있는가
workspace.py흔적 없이 시작 / 종료

규칙

  • 구조 먼저 일치 (프레이밍, 형태, 광원 방향), 색상 그 다음, 세부 사항 마지막.
  • 색상보다 노출을 먼저 수정하세요: 1스톱 오차는 모든 색상 측정을 왜곡합니다.
  • 50% 크기, 24 샘플의 렌더면 위 모든 항목을 판단하기에 충분합니다.
  • 압축되거나 다른 감마가 적용된 참조 이미지는 정확하지 않습니다: 단일 픽셀이 아닌 팔레트와 비율을 신뢰하세요.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬