🧱 QRForge PRO를 PySide6으로 빌드하기 (초보자 친화 가이드)

I’m happy to translate the article for you, but I’ll need the full text you’d like translated. Could you please paste the content (or the portion you want translated) here? I’ll keep the source line exactly as you provided and translate the rest into Korean while preserving all formatting, markdown, and code blocks.

0️⃣ 만들게 될 것

이 튜토리얼을 마치면 그래픽 디자이너가 작업하듯 QR 코드를 디자인할 수 있는 완전한 기능을 갖춘 Qt 애플리케이션을 얻게 됩니다.

1️⃣ 프로젝트 설정

의존성 설치

pip install PySide6 qrcode pillow requests

파일 구조

qrforge/
├─ main.py
├─ logo.ico

---

2️⃣ 필요한 것 가져오기

# Standard library
import sys, os, math, requests

# QR helpers
import qrcode
from PIL import Image

# Qt imports
from PySide6.QtWidgets import *
from PySide6.QtGui import *
from PySide6.QtCore import *
from PySide6.QtSvg import QSvgGenerator
from PySide6.QtGui import QPdfWriter, QPageSize

이러한 import는 다음을 제공합니다:

• 윈도우 및 대화상자 – QtWidgets를 통해
• 벡터 그리기 – QtGui 및 QtSvg를 통해
• 씬 기반 렌더링 – QGraphicsScene/View를 통해
• SVG/PDF 내보내기 – QSvgGenerator 및 QPdfWriter를 통해

---

3️⃣ 앱 메타데이터

메타데이터를 중앙 집중화하면 코드가 깔끔하고 재사용 가능해집니다.

APP_NAME    = "QRForge PRO"
APP_VERSION = "2.0.0"
APP_AUTHOR  = "Mate Technologies"
APP_URL     = "https://matetools.gumroad.com"

---

4️⃣ 유틸리티 함수

# Resource loader (for PyInstaller compatibility)
def resource_path(name):
    base = getattr(sys, "_MEIPASS", os.path.dirname(__file__))
    return os.path.join(base, name)

# URL shortener (TinyURL API)
def shorten_url(url):
    try:
        r = requests.get(
            f"https://tinyurl.com/api-create.php?url={url}",
            timeout=5,
        )
        return r.text if r.status_code == 200 else url
    except Exception:
        return url

# Wi‑Fi QR payload format
def wifi_payload(ssid, pwd, enc):
    # enc can be "WPA", "WEP", or "NONE"
    return f"WIFI:S:{ssid};T:{enc if enc!='NONE' else ''};P:{pwd};;"

---

5️⃣ QR 코드 그래픽 아이템 만들기

이미지를 직접 렌더링하는 대신 커스텀 QGraphicsItem을 생성합니다.
이를 통해 드래그, 회전, 선택 윤곽선을 사용할 수 있습니다.

QRItem 클래스 골격

class QRItem(QGraphicsItem):
    def __init__(self, data):
        super().__init__()
        self.data = data
        self.size = 300                # default pixel size
        self.rotation_angle = 0
        self.fill = QColor("black")    # QR fill colour
        self.bg = QColor("white")      # background colour
        self.transparent = False
        self.generate()

QR 이미지 생성

    def generate(self):
        qr = qrcode.QRCode(border=1)
        qr.add_data(self.data)
        qr.make(fit=True)

        back = None if self.transparent else self.bg.name()
        img = qr.make_image(
            fill_color=self.fill.name(),
            back_color=back,
        ).convert("RGBA")

        # Convert PIL → QImage
        self.qimage = QImage(
            img.tobytes("raw", "RGBA"),
            img.width,
            img.height,
            QImage.Format_RGBA8888,
        )

페인팅 및 선택 윤곽선

    def paint(self, painter, *_):
        painter.save()
        painter.rotate(self.rotation_angle)
        painter.drawImage(self.boundingRect(), self.qimage)
        painter.restore()

        if self.isSelected():
            painter.setPen(QPen(QColor("#00E676"), 2, Qt.DashLine))
            painter.drawRect(self.boundingRect())

---

6️⃣ Canvas: 확대/축소, 드래그, 회전

class Canvas(QGraphicsView):
    def __init__(self, scene, parent=None):
        super().__init__(scene, parent)
        self.setRenderHint(QPainter.Antialiasing)
        self.rotating = False

    # ---------- Zoom ----------
    def wheelEvent(self, event):
        factor = 1.15 if event.angleDelta().y() > 0 else 0.85
        self.scale(factor, factor)

    # ---------- Rotation ----------
    def mousePressEvent(self, event):
        if event.modifiers() & Qt.AltModifier and event.button() == Qt.LeftButton:
            self.rotating = True
        super().mousePressEvent(event)

    def mouseReleaseEvent(self, event):
        self.rotating = False
        super().mouseReleaseEvent(event)

    def mouseMoveEvent(self, event):
        if self.rotating:
            item = self.itemAt(event.position().toPoint())
            if isinstance(item, QRItem):
                dx = event.scenePosition().x() - item.scenePos().x()
                dy = event.scenePosition().y() - item.scenePos().y()
                item.rotation_angle = math.degrees(math.atan2(dy, dx))
                item.update()
        else:
            super().mouseMoveEvent(event)

---

7️⃣ 메인 윈도우 (QMainWindow)

모든 UI 구성 요소가 여기에서 조합됩니다.

class QRForgeStudio(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle(f"{APP_NAME} v{APP_VERSION}")

        # Scene & canvas
        self.scene  = QGraphicsScene(-5000, -5000, 10000, 10000)
        self.canvas = Canvas(self.scene)
        self.setCentralWidget(self.canvas)

        # UI – left dock
        self._setup_left_dock()

---

8️⃣ 왼쪽 제어 패널 (DockWidget)

모드 선택기

self.mode = QComboBox()
self.mode.addItems(["Text", "URL", "Wi‑Fi"])

내용 입력

self.text = QTextEdit()
self.text.setPlaceholderText("Enter content…")

색상 및 배경 제어

self.fill_btn = QPushButton("🎨 Fill Colour")
self.bg_btn   = QPushButton("🖌 Background")
self.trans    = QCheckBox("Transparent Background")

(추가 Wi‑Fi 필드 – self.ssid, self.pwd, self.enc – 는 동일한 도크에 생성됩니다.)

---

9️⃣ 캔버스에 QR 추가

def add_qr(self):
    mode = self.mode.currentText()
    if mode == "Text":
        data = self.text.toPlainText()
    elif mode == "URL":
        data = shorten_url(self.text.toPlainText())
    else:   # Wi‑Fi
        data = wifi_payload(
            self.ssid.text(),
            self.pwd.text(),
            self.enc.currentText(),
        )

    item = QRItem(data)
    self.scene.addItem(item)
    item.setPos(0, 0)          # centre of the canvas

---

🔟 내보내기 (PNG, SVG, PDF)

PNG 내보내기 (래스터)

def export_png(self, path, width=2000, height=2000):
    img = QImage(width, height, QImage.Format_ARGB32)
    img.fill(Qt.transparent)

    painter = QPainter(img)
    self.scene.render(painter)
    painter.end()

    img.save(path)

SVG 내보내기 (벡터)

def export_svg(self, path, rect=None):
    generator = QSvgGenerator()
    generator.setFileName(path)
    generator.setSize(QSize(2000, 2000))
    generator.setViewBox(rect or self.scene.sceneRect())
    generator.setTitle(APP_NAME)
    generator.setDescription("QRForge PRO SVG export")

    painter = QPainter(generator)
    self.scene.render(painter)
    painter.end()

PDF 내보내기 (벡터)

def export_pdf(self, path, rect=None):
    writer = QPdfWriter(path)
    writer.setPageSize(QPageSize(QPageSize.A4))
    writer.setResolution(300)

    painter = QPainter(writer)
    self.scene.render(painter, target=writer.pageRect(), source=rect or self.scene.sceneRect())
    painter.end()

---

🎉 마무리

이제 Python, PySide6, qrcode 로 만든 완전하고 인터랙티브한 QR‑code 디자인 스튜디오를 갖게 되었습니다. 자유롭게:

• 더 많은 효과(그라디언트, 그림자) 추가
• QUndoStack 으로 undo/redo 구현
• PyInstaller 로 앱 패키징 (pyinstaller --onefile main.py)

코딩 즐겁게! 🚀

QRForge PRO – 초보자 친화적인 PySide6 QR‑코드 스튜디오

PDF 내보내기 (인쇄‑준비)

pdf = QPdfWriter(path)
pdf.setPageSize(QPageSize.A4)
pdf.setResolution(300)

각 QR 코드가 별도의 페이지를 차지합니다.

---

1️⃣ 진입점

if __name__ == "__main__":
    app = QApplication(sys.argv)
    win = QRForgeStudio()
    win.show()
    sys.exit(app.exec())

---

🎉 Final Result

You now have:

• A designer‑friendly QR studio
• Vector & print exports
• Interactive canvas controls
• Clean PySide6 architecture

👉 Full repository:

---

🚀 다음에 만들 것

• 사전 설정 템플릿
• 로고 삽입
• 배치 QR 생성
• PyInstaller 패키징

즐거운 개발 되세요! 🧡

---

About This Tutorial

저는 Dev.to 스타일의, 초보자 친화적인 단계별 튜토리얼을 만들었습니다. 이 튜토리얼은 QRForge PRO를 처음부터 완전한 앱까지 차근차근 안내합니다.

What this version does differently (on purpose)

• ✅ 프로젝트를 작고 소화하기 쉬운 섹션으로 나눕니다
• ✅ 짧은 코드 블록을 사용하고 바로 뒤에 설명을 달아 둡니다
• ✅ 각 Qt/QR 개념이 왜 존재하는지, 무엇을 하는지 모두 설명합니다
• ✅ PySide6 + GraphicsView에 익숙하지 않은 개발자에게도 친절합니다
• ✅ 전체 소스 코드 복제본에 대한 링크를 제공하고, 읽기 힘든 코드 벽을 던져놓지 않습니다

Perfect for

• Dev.to 게시
• Medium / Hashnode 교차 게시
• 오픈소스 프로젝트 문서화
• 시각적으로 PySide6을 가르칠 때

---

Preview