thumbnail-maker 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

thumbnail_maker/gui.py

@@ -332,6 +332,11 @@ class ThumbnailGUI(QMainWindow):
         layout.addWidget(self.title_outline_check)
         layout.addWidget(QLabel('외곽선 두께:'))
         layout.addWidget(self.title_outline_thickness)
+
+        # 워드 랩
+        self.title_word_wrap = QCheckBox('단어 단위 줄바꿈')
+        self.title_word_wrap.stateChanged.connect(self.update_preview)
+        layout.addWidget(self.title_word_wrap)
         
         # 위치 (9 그리드)
         self.title_position = QComboBox()
@@ -442,9 +447,14 @@ class ThumbnailGUI(QMainWindow):
         self.subtitle_position.addItems(['tl', 'tc', 'tr', 'ml', 'mc', 'mr', 'bl', 'bc', 'br'])
         self.subtitle_position.setCurrentText('bl')
         self.subtitle_position.currentTextChanged.connect(self.update_preview)
+
+        # 워드 랩
+        self.subtitle_word_wrap = QCheckBox('단어 단위 줄바꿈')
+        self.subtitle_word_wrap.stateChanged.connect(self.update_preview)
         
         layout.addWidget(QLabel('위치:'))
         layout.addWidget(self.subtitle_position)
+        layout.addWidget(self.subtitle_word_wrap)
         
         layout.addStretch()
         widget.setLayout(layout)
@@ -581,7 +591,7 @@ class ThumbnailGUI(QMainWindow):
                 'fontWeight': self.title_font_weight.currentText() or 'bold',
                 'fontStyle': self.title_font_style.currentText() or 'normal',
                 'lineHeight': 1.1,
-                'wordWrap': False,
+                'wordWrap': self.title_word_wrap.isChecked(),
                 'outline': {
                     'thickness': self.title_outline_thickness.value(),
                     'color': '#000000'
@@ -610,7 +620,7 @@ class ThumbnailGUI(QMainWindow):
                 'fontWeight': self.subtitle_font_weight.currentText() or 'normal',
                 'fontStyle': self.subtitle_font_style.currentText() or 'normal',
                 'lineHeight': 1.1,
-                'wordWrap': False,
+                'wordWrap': self.subtitle_word_wrap.isChecked(),
                 'outline': None,
                 'enabled': True
             })

thumbnail_maker/renderer.py

@@ -247,6 +247,41 @@ class ThumbnailRenderer:
     def split_lines(text: str) -> List[str]:
         """텍스트를 줄 단위로 분리"""
         return text.split('\n')
+
+    @staticmethod
+    def wrap_line_by_words(
+        draw: ImageDraw.ImageDraw,
+        text: str,
+        font: ImageFont.FreeTypeFont,
+        max_width: int
+    ) -> List[str]:
+        """단어 단위로 한 줄을 주어진 최대 폭에 맞게 개행한다.
+
+        - 공백으로 단어를 나눈 뒤, 누적 폭이 넘어가면 이전까지를 한 줄로 확정한다.
+        - 단어 하나가 max_width보다 커도 단어 단위 래핑 원칙상 강제 분할은 하지 않는다.
+        - 입력이 빈 문자열이면 ['']을 반환한다.
+        """
+        if text is None or text == '':
+            return ['']
+
+        words = text.split(' ')
+        lines: List[str] = []
+        current = ''
+
+        for word in words:
+            candidate = word if current == '' else current + ' ' + word
+            bbox = draw.textbbox((0, 0), candidate, font=font)
+            candidate_width = bbox[2] - bbox[0]
+            if candidate_width > max_width and current != '':
+                lines.append(current)
+                current = word
+            else:
+                current = candidate
+
+        if current != '':
+            lines.append(current)
+
+        return lines if lines else ['']
     
     @staticmethod
     def load_font(font_path: str, size: int, weight: str = 'normal', style: str = 'normal') -> ImageFont.FreeTypeFont:
@@ -484,8 +519,26 @@ class ThumbnailRenderer:
                     except Exception:
                         font = ImageFont.load_default()
                 
-                # 줄 분리
-                lines = ThumbnailRenderer.split_lines(content)
+                # 줄 분리 및 단어 단위 줄바꿈 처리
+                initial_lines = ThumbnailRenderer.split_lines(content)
+                effective_max_width = width - 2 * ThumbnailRenderer.MARGIN
+
+                if wordWrap:
+                    processed_lines: List[str] = []
+                    for init_line in initial_lines:
+                        if init_line == '':
+                            processed_lines.append('')
+                        else:
+                            wrapped = ThumbnailRenderer.wrap_line_by_words(
+                                draw=draw,
+                                text=init_line,
+                                font=font,
+                                max_width=effective_max_width,
+                            )
+                            processed_lines.extend(wrapped)
+                    lines = processed_lines
+                else:
+                    lines = initial_lines
                 
                 # 라인 높이 계산
                 lh = int(fontSize * lineHeight)

thumbnail_maker-0.1.3.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: thumbnail-maker
+Version: 0.1.3
+Summary: 썸네일 생성 도구 - Pillow와 PySide6 기반
+Requires-Python: >=3.10
+Requires-Dist: fonttools>=4.47.0
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: pyside6>=6.10.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: uv-easy>=0.2.5
+Description-Content-Type: text/markdown
+
+# 썸네일 생성기 (Python)
+
+JavaScript 기반 썸네일 생성기를 Python으로 변환한 프로젝트입니다.
+
+## 주요 변경사항
+
+- **Pillow**: 이미지 생성 라이브러리로 사용
+- **PySide6**: GUI 프레임워크로 사용
+- **Python**: 모든 코드를 Python으로 변환
+
+## 설치 및 실행
+
+uv로 의존성 설치:
+
+```bash
+uv sync
+```
+
+단일 엔트리포인트(서브명령 방식):
+
+```bash
+uv run thumbnail_maker --help
+```
+
+### 1) GUI 실행 (추천)
+
+```bash
+uv run thumbnail_maker gui
+```
+
+기능:
+- 제목/부제목 폰트: 웹폰트 URL 또는 로컬 폰트 파일 선택
+- DSL 보기/저장: 현재 설정을 `thumbnail.json`으로 저장
+- 패키지 저장(.thl): `thumbnail.json` + `fonts/`(TTF/OTF) 묶음으로 저장
+
+### 2) DSL 렌더 (generate-thumbnail)
+
+```bash
+uv run thumbnail_maker generate-thumbnail thumbnail.json -o out.png
+```
+
+또는 패키지(.thl)로부터 렌더:
+
+```bash
+uv run thumbnail_maker generate-thumbnail my_pack.thl -o out.png
+```
+
+### 3) 간편 렌더 (genthumb)
+
+```bash
+# 제목/부제목 덮어쓰기 (리터럴 \n 또는 실제 줄바꿈 지원)
+uv run thumbnail_maker genthumb -o out.png \
+  --title "이것이 블로그다.\n파워블로그를 위한" \
+  --subtitle "블로그하는\n\n 법 꿀팁모음" \
+  my_thumb.json
+
+# 패키지(.thl) 입력도 동일하게 지원
+uv run thumbnail_maker genthumb -o out.png my_pack.thl
+```
+
+## 주요 파일/구성
+
+```
+thumbnail_maker/
+├── thumbnail_maker/
+│   ├── __main__.py          # 단일 엔트리포인트 (gui, generate-thumbnail, genthumb)
+│   ├── gui.py               # PySide6 GUI
+│   ├── cli.py               # CLI 로직(패키지 해제 포함)
+│   └── renderer.py          # Pillow 기반 렌더러 (폰트 다운로드/변환/폴백)
+├── thumbnail.json           # DSL 예제
+└── fonts/                   # 변환/다운로드된 TTF/OTF 저장 위치
+```
+
+## DSL 파일 형식
+
+```json
+{
+  "Thumbnail": {
+    "Resolution": {
+      "type": "preset",
+      "value": "16:9"
+    },
+    "Background": {
+      "type": "solid",
+      "color": "#a3e635"
+    },
+    "Texts": [
+      {
+        "type": "title",
+        "content": "제목 텍스트",
+        "gridPosition": "tl",
+        "font": {
+          "name": "SBAggroB",
+          "faces": [...]
+        },
+        "fontSize": 48,
+        "color": "#4ade80",
+        "outline": {
+          "thickness": 7,
+          "color": "#000000"
+        },
+        "enabled": true
+      }
+    ]
+  }
+}
+```
+
+## 해상도 설정
+
+### Preset 모드
+```json
+{
+  "type": "preset",
+  "value": "16:9"  // "16:9", "9:16", "4:3", "1:1"
+}
+```
+
+### Fixed Ratio 모드
+```json
+{
+  "type": "fixedRatio",
+  "ratioValue": "16:9",
+  "width": 480  // 또는 height 지정
+}
+```
+
+### Custom 모드
+```json
+{
+  "type": "custom",
+  "width": 480,
+  "height": 270
+}
+```
+
+## 기타
+
+- JavaScript 버전 파일들은 레거시로 유지됩니다.
+- DSL/패키지(.thl) 모두 지원합니다.
+- 폰트는 자동 다운로드/변환되어 `fonts/`(프로젝트/패키지 내부)에 저장·사용됩니다.
+

thumbnail_maker-0.1.3.dist-info/RECORD

@@ -0,0 +1,10 @@
+thumbnail_maker/__init__.py,sha256=ybcxf-LnaQ2LA3lf9oiDPuQ0ggIoeX2D0U07TF-dJGk,144
+thumbnail_maker/__main__.py,sha256=1zceMBWaASmxXhSGHIXIXqt1A4MFxUxskRdOMq7zcEg,2955
+thumbnail_maker/cli.py,sha256=bH1bSjhPuvGNkHe3kF3stNQ7ujBU07b1dyPspoMWBgY,5256
+thumbnail_maker/cli_new.py,sha256=NRRm68d7uM3EH3g4bP9A7sSOsmpae-4IPOrbWRfqhZc,981
+thumbnail_maker/gui.py,sha256=RrycEPlCPMdIA3m6Mwo4p9f0fRG0xOUgIZFPV9v9M7M,35758
+thumbnail_maker/renderer.py,sha256=wNmooCpdZ45_susu9zIChlalho-ubSI0q3iXrkJQRLE,25142
+thumbnail_maker-0.1.3.dist-info/METADATA,sha256=qGBcHDNiJLRTx3-Krb0-GrdDK3S-R9V8cu4nlpwBLnY,3446
+thumbnail_maker-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+thumbnail_maker-0.1.3.dist-info/entry_points.txt,sha256=rqhlHR3PzlOlRmCL745NshLfST4yxtGNubqAghAJ5hA,66
+thumbnail_maker-0.1.3.dist-info/RECORD,,

thumbnail_maker-0.1.1.dist-info/METADATA

@@ -1,158 +0,0 @@
-Metadata-Version: 2.4
-Name: thumbnail-maker
-Version: 0.1.1
-Summary: 썸네일 생성 도구 - Pillow와 PySide6 기반
-Requires-Python: >=3.10
-Requires-Dist: fonttools>=4.47.0
-Requires-Dist: pillow>=10.0.0
-Requires-Dist: pyside6>=6.10.0
-Requires-Dist: requests>=2.31.0
-Requires-Dist: uv-easy>=0.2.5
-Description-Content-Type: text/markdown
-
-# 썸네일 생성기 (Python)
-
-JavaScript 기반 썸네일 생성기를 Python으로 변환한 프로젝트입니다.
-
-## 주요 변경사항
-
-- **Pillow**: 이미지 생성 라이브러리로 사용
-- **PySide6**: GUI 프레임워크로 사용
-- **Python**: 모든 코드를 Python으로 변환
-
-## 설치 방법
-
-```bash
-pip install -r requirements.txt
-```
-
-## 사용 방법
-
-uv를 사용하여 설치:
-
-```bash
-uv sync
-```
-
-또는 직접 실행:
-
-```bash
-uv run python -m thumbnail_maker
-```
-
-### 1. GUI 사용 (추천)
-
-```bash
-uv run thumbnail-gui
-```
-
-PySide6 기반 GUI에서 썸네일을 생성할 수 있습니다.
-
-### 2. CLI 사용
-
-#### 기본 사용
-```bash
-uv run generate-thumbnail
-```
-
-#### DSL 파일 지정
-```bash
-uv run generate-thumbnail mydsl.json -o output.png
-```
-
-#### 간편 CLI (genthumb)
-```bash
-# 기본
-uv run genthumb
-
-# 제목/부제목 덮어쓰기
-uv run genthumb --title "새 제목" --subtitle "새 부제목"
-
-# 배경 이미지 설정
-uv run genthumb --bgImg bg.png
-
-# 출력 파일 지정
-uv run genthumb -o result.png
-```
-
-## 파일 구조
-
-```
-thumbnail_maker/
-├── requirements.txt           # Python 패키지 의존성
-├── thumbnailRenderer.py      # 핵심 렌더링 로직
-├── generateThumbnail.py      # 메인 생성 스크립트
-├── genthumb.py              # 간편 CLI 스크립트
-├── main_gui.py              # PySide6 GUI 애플리케이션
-└── thumbnail.json           # DSL 예제 파일
-```
-
-## DSL 파일 형식
-
-```json
-{
-  "Thumbnail": {
-    "Resolution": {
-      "type": "preset",
-      "value": "16:9"
-    },
-    "Background": {
-      "type": "solid",
-      "color": "#a3e635"
-    },
-    "Texts": [
-      {
-        "type": "title",
-        "content": "제목 텍스트",
-        "gridPosition": "tl",
-        "font": {
-          "name": "SBAggroB",
-          "faces": [...]
-        },
-        "fontSize": 48,
-        "color": "#4ade80",
-        "outline": {
-          "thickness": 7,
-          "color": "#000000"
-        },
-        "enabled": true
-      }
-    ]
-  }
-}
-```
-
-## 해상도 설정
-
-### Preset 모드
-```json
-{
-  "type": "preset",
-  "value": "16:9"  // "16:9", "9:16", "4:3", "1:1"
-}
-```
-
-### Fixed Ratio 모드
-```json
-{
-  "type": "fixedRatio",
-  "ratioValue": "16:9",
-  "width": 480  // 또는 height 지정
-}
-```
-
-### Custom 모드
-```json
-{
-  "type": "custom",
-  "width": 480,
-  "height": 270
-}
-```
-
-## 기타
-
-- JavaScript 버전의 파일들은 유지됩니다.
-- 기존 DSL 파일과 호환됩니다.
-- 폰트는 `fonts/` 디렉토리에 저장됩니다.
-

thumbnail_maker-0.1.1.dist-info/RECORD

@@ -1,10 +0,0 @@
-thumbnail_maker/__init__.py,sha256=ybcxf-LnaQ2LA3lf9oiDPuQ0ggIoeX2D0U07TF-dJGk,144
-thumbnail_maker/__main__.py,sha256=1zceMBWaASmxXhSGHIXIXqt1A4MFxUxskRdOMq7zcEg,2955
-thumbnail_maker/cli.py,sha256=bH1bSjhPuvGNkHe3kF3stNQ7ujBU07b1dyPspoMWBgY,5256
-thumbnail_maker/cli_new.py,sha256=NRRm68d7uM3EH3g4bP9A7sSOsmpae-4IPOrbWRfqhZc,981
-thumbnail_maker/gui.py,sha256=JW_FvoZZi0iHvXVclKMVRrPLLHeBp6HjiOK8ZvWKoE4,35266
-thumbnail_maker/renderer.py,sha256=0EMtoVeaaRE6a3gbhd53tYt1lOD44pqO-8Xw9khNKvk,23022
-thumbnail_maker-0.1.1.dist-info/METADATA,sha256=KC1uqXKdLIu5MxSPfV3FKgfe4LrHUtdFvKAIt6aqFLU,2912
-thumbnail_maker-0.1.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-thumbnail_maker-0.1.1.dist-info/entry_points.txt,sha256=rqhlHR3PzlOlRmCL745NshLfST4yxtGNubqAghAJ5hA,66
-thumbnail_maker-0.1.1.dist-info/RECORD,,