================================================================================
  한픽스 (HanPix) — 한국 크리에이터를 위한 무료 AI 이미지 편집기
  개발: 영삼넷  |  블로그: https://youngsam.net
================================================================================

1. 한픽스는 어떤 프로그램인가요?
--------------------------------------------------------------------------------
한픽스는 사진 편집과 디자인을 위한 무료 이미지 편집기입니다. 레이어, 마스크,
조정 레이어, 필터, 문자, 벡터, 브러시 같은 전문 편집 기능을 갖추고 있고,
PSD·PSB 파일을 열고 저장할 수 있어 기존 작업 파일을 그대로 이어서
쓸 수 있습니다.

여기에 한국 사용자가 매일 하는 작업을 빠르게 끝낼 수 있도록 AI 기능을
더했습니다. 쇼핑몰 상품 누끼, 사진 속 사람·전선·글자 지우기, 배경 확장,
하늘 바꾸기, 저해상도 이미지 확대를 클릭 몇 번으로 처리합니다.

  - 완전 무료, 광고 없음, 계정 필요 없음
  - AI는 모두 내 PC에서 실행 (사진이 외부 서버로 전송되지 않음)
  - 메뉴·대화상자·오류 메시지까지 한국어, Pretendard 글꼴 내장
  - Windows 데스크톱 버전 + 브라우저에서 쓰는 웹 버전


2. AI 기능 (메뉴 막대의 [AI] 메뉴)
--------------------------------------------------------------------------------
■ 배경 제거 (자동 누끼)
  레이어를 고르고 [AI > 배경 제거] 또는 캔버스 아래 작업 막대의 [배경 제거]를
  누르면 피사체만 남습니다. 결과는 레이어 마스크로 만들어지므로 원본 픽셀은
  그대로 남고, 브러시로 마스크를 고쳐 다듬을 수 있습니다.
  품질은 환경설정 > AI 에서 고릅니다.
    - 빠름 (5 MB)  : 가장 빠름, 가장자리가 거침
    - 표준 (179 MB): 대부분의 사진에 적합 (기본값)
    - 최고 (224 MB): 머리카락·털까지 정밀, 그래픽카드가 있으면 권장

■ 피사체 선택
  [선택 > 피사체] 또는 [AI > 피사체 선택]. 사람·상품·동물을 자동으로 선택합니다.

■ 개체 클릭 선택 (특정 부위 빼기 포함)
  개체 선택 도구(W)로 선택하고 싶은 물체를 클릭하면 그 물체만 선택됩니다.
    - 클릭          : 새로 선택
    - Shift + 클릭  : 다른 물체를 선택에 추가
    - Alt + 클릭    : 클릭한 부위를 선택에서 빼기 (예: 사람에서 가방·손만 빼기)
    - 드래그 사각형 : 사각형 안의 물체를 선택

■ 텍스트로 선택
  [AI > 텍스트로 선택…]에 "강아지", "하늘", "빨간 자동차", "사람" 처럼 입력하면
  해당 대상을 찾아 선택합니다. 자주 쓰는 한국어 단어 100여 개를 알아듣고,
  목록에 없는 단어는 영어(예: bicycle)로 입력하면 됩니다.

■ 인물 부위 선택
  [AI > 인물 부위 선택…]에서 머리카락·얼굴·피부·옷·눈·입술을 골라 선택합니다.
  머리 색 바꾸기, 피부 보정, 옷 색 바꾸기에 편리합니다.

■ 배경을 살리며 지우기 (AI 지우개)
  ① 제거 도구(J)로 지우고 싶은 사람·전선·글자·티끌을 칠하면 주변 배경으로
     자연스럽게 채워집니다.
  ② 올가미나 개체 선택으로 영역을 잡고 [AI > 선택 영역 AI 지우기]를 누르면
     그 부분이 지워진 결과가 새 레이어로 만들어집니다 (원본 보존).

■ AI 캔버스 확장
  [AI > AI 캔버스 확장…]에서 늘릴 방향(좌·우·위·아래)과 비율을 고르면
  캔버스를 넓히고 새로 생긴 부분을 사진과 어울리게 채웁니다.
  가로 사진을 세로 썸네일로 바꿀 때 유용합니다.

■ 하늘 바꾸기
  [AI > 하늘 바꾸기…]에서 맑음·노을·해 질 녘·밤·구름 중 하나를 고르면
  하늘을 찾아 새 하늘 레이어(마스크 포함)를 만들어 줍니다.

■ AI 업스케일 (확대)
  [AI > AI 업스케일…]에서 2배 또는 4배를 고르면 선명하게 확대한 결과를
  새 문서로 엽니다. 작은 상품 이미지, 오래된 사진 복원에 좋습니다.

■ 일괄 배경 제거 (폴더 단위 누끼)
  [AI > 일괄 배경 제거…]에 입력 폴더를 넣으면 폴더 안의 모든 사진(JPG, PNG,
  WebP, BMP, TIFF)의 배경을 지워 출력 폴더에 저장합니다.
    - 배경: 투명 / 흰색 / 검정
    - 형식: PNG / JPG
    - 여백: 피사체 주위 여백(%)을 두고 자동 자르기
  출력 폴더를 비워 두면 입력 폴더 안의 cutout 폴더에 저장됩니다.

■ AI 모델 관리
  [AI > AI 모델 관리…]에서 모델을 미리 내려받거나 삭제할 수 있습니다.
  모델은 기능을 처음 쓸 때 자동으로 내려받습니다 (인터넷 필요, 한 번만).
  저장 위치: %LOCALAPPDATA%\HanPix\models
  [환경설정 > AI]에서 AI 사용, 그래픽카드(GPU) 사용, 누끼 품질, 자동 다운로드를
  설정합니다. AI를 끄거나 모델을 받을 수 없을 때는 기존 알고리즘으로 자동
  전환되므로 기능이 멈추지 않습니다.


3. 편집 기능
--------------------------------------------------------------------------------
  - 레이어: 그룹, 클리핑 마스크, 혼합 모드 27종, 불투명도, 잠금, 레이어 스타일
  - 마스크: 레이어 마스크, 벡터 마스크, 빠른 마스크, 선택 및 마스크(가장자리 다듬기)
  - 조정: 레벨, 곡선, 색조/채도, 색상 균형, 흑백, 포토 필터 등 16종 (조정 레이어)
  - 필터: 흐림·선명·왜곡·노이즈·픽셀화·렌더·스타일화 등 70여 종, 고급 필터
  - 선택: 사각형/원형 선택, 올가미, 자석 올가미, 자동 선택, 빠른 선택, 색상 범위
  - 리터칭: 스팟 복구, 복구 브러시, 패치, 내용 인식 이동, 복제 도장, 적목 현상
  - 페인팅: 브러시, 연필, 혼합 브러시, 지우개, 그레이디언트, 페인트 통
  - 문자: 가로/세로 문자, 한글 입력, 단락, 커닝, 가변 글꼴
  - 벡터: 펜, 패스, 모양 도구
  - 색상: 8/16/32비트, RGB·CMYK·Lab·회색 음영, ICC 색상 관리, 교정 보기
  - 파일: PSD/PSB 열기·저장, PNG, JPG, WebP, TIFF, GIF, BMP, TGA, HEIC(읽기),
          카메라 RAW 일부, 웹용 내보내기
  - 자동화: 액션, 일괄 처리, 명령줄(CLI), 단축키 사용자 지정
  - 단축키: 전문가용 편집기 표준 단축키 체계 (V 이동, M 선택, L 올가미, W 개체 선택,
            J 제거·복구, B 브러시, E 지우개, T 문자, Ctrl+T 자유 변형 등)


4. 한국 사용자를 위한 편의 기능
--------------------------------------------------------------------------------
  - 새 문서 > [한국 웹·SNS] 프리셋
      쇼핑몰 상세페이지 860px, 상품 대표이미지 1000, 블로그 이미지 966px,
      카드뉴스 1080x1350, 인스타그램 게시물/스토리, 유튜브 썸네일, 이벤트 배너
  - 캔버스 아래 작업 막대: 지금 할 만한 작업(배경 제거, 피사체 선택, 하늘 바꾸기,
    선택 영역 지우기, 마스크 추가 등)을 버튼 하나로
  - 한국어 메뉴·대화상자·오류 메시지·작업 진행 문구
  - Pretendard 글꼴 내장 (시스템 글꼴이 없어도 한글이 깔끔하게 표시)
  - 메뉴 검색: Ctrl+F 로 기능 이름을 한글로 검색


5. 이전 버전(원본) 대비 개선된 점
--------------------------------------------------------------------------------
  - [신규] AI 메뉴와 내 PC에서 실행되는 AI 엔진 (ONNX Runtime, Windows는 그래픽카드
    가속 DirectML 지원, 그래픽카드에서 실패하면 자동으로 CPU로 다시 실행)
  - [개선] 배경 제거·피사체 선택: 고전 알고리즘 → AI 모델 (머리카락·털 정밀)
  - [개선] 개체 선택 도구: 클릭 한 번으로 선택, Alt+클릭으로 부위 빼기
  - [개선] 제거 도구: AI 인페인팅으로 배경을 자연스럽게 복원
  - [신규] 텍스트로 선택, 인물 부위 선택, 선택 영역 AI 지우기, AI 캔버스 확장,
           하늘 바꾸기, AI 업스케일, 폴더 일괄 누끼, AI 모델 관리
  - [신규] 캔버스 아래 작업 막대 (자주 쓰는 다음 작업을 바로 실행)
  - [개선] 한국어: 엔진 오류 메시지·작업 진행 문구 한국어화, 새 메뉴 전부 번역,
           Pretendard 글꼴 내장, 웹 버전 기본 언어 한국어
  - [신규] 한국형 새 문서 프리셋 (상세페이지, 썸네일, 카드뉴스 등)
  - [변경] 새 이름·아이콘(한픽스), 정보 창에 개발자(영삼넷) 정보


6. 설치와 실행 (Windows 10/11, 64비트)
--------------------------------------------------------------------------------
  1) HanPix-windows-x64 폴더를 원하는 위치(예: C:\Program Files\HanPix)에 복사
  2) hanpix.exe 실행 (바탕화면 바로가기를 만들어 두면 편리합니다)
  3) 처음 AI 기능을 쓸 때 모델을 내려받습니다 (기능별 5~224 MB, 한 번만)

  주의: onnxruntime.dll, onnxruntime_providers_shared.dll, DirectML.dll 은
        반드시 hanpix.exe 와 같은 폴더에 있어야 AI 기능이 동작합니다.

  권장 사양: 4코어 이상 CPU, 메모리 8GB 이상, DirectX 12 그래픽카드
            (그래픽카드가 없어도 동작하지만 AI 처리가 느려집니다)


7. 웹 버전 우분투 서버 배포
--------------------------------------------------------------------------------
웹 버전은 서버 프로그램이 필요 없는 정적 파일(HTML + WebAssembly)입니다.
dist/web 폴더의 내용을 웹 서버에 올리기만 하면 됩니다.
(웹 버전은 AI 모델 대신 기존 알고리즘으로 피사체 선택·제거 도구가 동작합니다.)

[방법 A] 이미 빌드된 dist/web 을 Nginx 로 서비스 (가장 간단)

  # 1) 서버에 Nginx 설치
  sudo apt update && sudo apt install -y nginx

  # 2) 내 PC에서 dist/web 폴더를 서버로 복사
  scp -r dist/web/* 사용자@서버주소:/tmp/hanpix/
  # 서버에서:
  sudo mkdir -p /var/www/hanpix
  sudo cp -r /tmp/hanpix/* /var/www/hanpix/

  # 3) Nginx 설정 (/etc/nginx/sites-available/hanpix)
  server {
      listen 80;
      server_name hanpix.내도메인.com;      # 도메인 또는 서버 IP
      root /var/www/hanpix;
      index index.html;
      types { application/wasm wasm; }
      include /etc/nginx/mime.types;
      gzip on;
      gzip_types application/wasm application/javascript text/css;
      location ~* \.(wasm|js)$ { add_header Cache-Control "public, max-age=31536000, immutable"; }
      location = /index.html  { add_header Cache-Control "no-cache"; }
  }

  sudo ln -s /etc/nginx/sites-available/hanpix /etc/nginx/sites-enabled/
  sudo nginx -t && sudo systemctl reload nginx

  # 4) HTTPS (권장: 무료 인증서)
  sudo apt install -y certbot python3-certbot-nginx
  sudo certbot --nginx -d hanpix.내도메인.com

[방법 B] 서버에서 직접 빌드 (Docker)

  sudo apt install -y docker.io git
  git clone <내 저장소 주소> hanpix && cd hanpix
  sudo docker build -t hanpix-web .
  sudo docker run -d --name hanpix-web --restart unless-stopped -p 8080:8080 hanpix-web
  # http://서버주소:8080 으로 접속 (앞단에 Nginx 리버스 프록시 + HTTPS 권장)

[방법 C] 서버에서 직접 빌드 (Rust)

  curl https://sh.rustup.rs -sSf | sh -s -- -y && source ~/.cargo/env
  rustup target add wasm32-unknown-unknown
  cargo install trunk --locked
  cd apps/photocraft-web && trunk build --release     # 결과: dist/web

  참고: 웹 파일(wasm)은 약 20MB(압축 시 6~8MB)입니다. gzip 또는 brotli 압축을
        켜 두면 첫 접속이 빨라집니다.


8. 개인정보
--------------------------------------------------------------------------------
  - 한픽스는 사진이나 작업 내용을 어디에도 전송하지 않습니다.
  - 인터넷 연결은 AI 모델을 처음 내려받을 때와 블로그 링크를 열 때만 사용합니다.
  - 웹 버전도 모든 처리를 브라우저 안에서 합니다 (서버에 파일 업로드 없음).


9. 개발자 / 문의
--------------------------------------------------------------------------------
  개발: 영삼넷
  블로그: https://youngsam.net
  프로그램 안: [도움말 > 개발자 블로그 (영삼넷)…], [도움말 > 한픽스 정보]


10. 라이선스
--------------------------------------------------------------------------------
  한픽스는 MIT 또는 Apache-2.0 라이선스의 무료 소프트웨어입니다. 포함된 오픈소스
  구성 요소, 글꼴(Pretendard, Inter: SIL OFL), ONNX Runtime(MIT)과 AI 모델
  (BiRefNet MIT, IS-Net·U²-Net·MobileSAM·SAM·LaMa·CLIPSeg Apache-2.0,
  Real-ESRGAN BSD-3)의 고지는 프로그램 폴더의 NOTICE, LICENSE-MIT,
  LICENSE-APACHE 파일에 있습니다.
================================================================================
