================================================================================
          GP Math Studio Pro — संपूर्ण यूज़र गाइड एवं डॉक्यूमेंटेशन
================================================================================

GP Math Studio Pro एक ऑल-इन-वन (Unified) डेस्कटॉप टूल है जो किसी भी PDF से MCQs
को आसानी से काटने (Crop), स्प्लिट प्रश्नों को जोड़ने (Merge), और सीधे प्रैक्टिस
वर्कशीट / डिजिटल बोर्ड प्रेजेंटेशन (PDF, Word, PPTX) बनाने के लिए डिज़ाइन किया गया है।


--------------------------------------------------------------------------------
1. शुरुआत कैसे करें (Quick Start)
--------------------------------------------------------------------------------
* प्रोजेक्ट फ़ोल्डर में मौजूद "Start_GP_Math_Studio.bat" फ़ाइल पर डबल-क्लिक करें।
* यह फ़ाइल अपने आप सभी आवश्यक लाइब्रेरीज़ (PyMuPDF, opencv-python, python-docx,
  python-pptx, pywebview, Flask) चेक और इंस्टॉल करेगी।
* इसके बाद ऐप सीधे एक क्लीन डेस्कटॉप विंडो में खुल जाएगा। (100% ऑफ़लाइन, इंटरनेट की ज़रूरत नहीं)


--------------------------------------------------------------------------------
2. सम्पूर्ण सिस्टम वर्कफ़्लो (Workflow Pipeline)
--------------------------------------------------------------------------------
[Raw PDF Load] ➔ [Step 1: Cut & Merge MCQs] ➔ [Extract] ➔ [Step 2: Live Layout Preview] ➔ [PDF / Word / PPTX Export]


--------------------------------------------------------------------------------
3. STEP 1: MCQ CROPPER (काटना और एक्सट्रैक्ट करना)
--------------------------------------------------------------------------------

[1] फ़ाइल लोड और नेविगेशन:
  - "Load Raw PDF" बटन से अपनी PDF फ़ाइल चुनें।
  - ◀ / ▶ बटन से पेजों पर आगे-पीछे जाएं।
  - "Skip This Page" बटन से बिना काम के पेज (कवर पेज, इंडेक्स) स्किप करें।

[2] स्लाइसिंग टूल्स (Slicing Tools):
  - "1. Set Vertical Column (X)": डबल-कॉलम PDF के लिए बीच में वर्टिकल डिवाइडर लाइन लगाएं।
  - "2. Continuous Y-Slice": हर सवाल के नीचे हॉरिजॉन्टल कट लगाते जाएं।
  - "Undo" (या Ctrl+Z): पिछली गलती वापस लेने के लिए।

[3] स्प्लिट MCQs को जोड़ना (Merge Mode - Split Questions):
  - अगर कोई सवाल 2 पेजों में या 2 कॉलमों में आधा-आधा बंटा हुआ है:
    * "Merge Next Cut" चेकबॉक्स टिक करें या कीबोर्ड पर Shift दबाकर क्लिक करें।
    * कट लाइन गुलाबी (Pink) रंग में "MERGE" दिखाएगी।
    * बैकएंड दोनों टुकड़ों को बिना किसी गैप के जोड़कर एक पूरा सवाल बना देगा।

[4] माउस शॉर्टकट्स (Line Controls):
  - Add Line: पेज पर कहीं भी Left-Click करें।
  - Delete Line: लाइन के ठीक ऊपर ले जाकर Right-Click करें।
  - Move Line: लाइन पर क्लिक करके ऊपर या नीचे Drag करें।

[5] सेटिंग्स और आउटपुट बैकअप (Output Settings):
  - Pad (px): सवाल के चारों ओर सफेद किनारी (Padding) छोड़ने के लिए (डिफ़ॉल्ट 10px)।
  - Top Ign / Btm Ign: पेज हेडर/फुटर हटाने के लिए पिक्सल सेट करें।
  - Output Folder: Browse बटन दबाकर बैकअप फ़ोल्डर चुनें।
  - चेकबॉक्स:
    * Save Original PDF (ओरिजिनल फ़ाइल बैकअप)
    * Generate PNGs Folder (सभी अलग-अलग सवालों की PNG इमेजेस)
    * Generate JSON (सवालों के सटीक x, y कोऑर्डिनेट्स)

[6] ब्रिज बटन:
  - "Extract & Send to Builder" बटन दबाते ही सारे सवाल सीधे Step 2 में लोड हो जाते हैं।


--------------------------------------------------------------------------------
4. STEP 2: WORKSHEET BUILDER (लेआउट और मल्टी-फॉर्मेट एक्सपोर्ट)
--------------------------------------------------------------------------------

[1] पेपर साइज़ (Paper Size):
  - A-Series: A1, A2, A3, A4 (डिफ़ॉल्ट), A5
  - US & Print: Letter, Legal, Tabloid
  - Digital Board / Screens:
    * Screen 16:9 (FHD): स्मार्ट बोर्ड / इंटरएक्टिव पैनल और PPTX के लिए बेस्ट।
    * Screen 4:3: क्लासिक प्रोजेक्टर लेआउट के लिए।

[2] ओरिएंटेशन (Orientation):
  - Portrait (खड़ा पेज)
  - Landscape (आड़ा पेज)

[3] लेआउट मोड्स (Layout Mode):
  - 1 / Page: हर पेज पर एक ही सवाल (सॉल्यूशन स्पेस के लिए बेस्ट)।
  - 1 Col (Flow): स्वाभाविक वर्टिकल फ्लो।
  - 2 Cols: डबल कॉलम लेआउट (एग्ज़ाम पेपर / टेस्ट बुकलेट स्टाइल)।
  - 3 Cols: तीन कॉलम लेआउट।

[4] अलाइनमेंट और नेचुरल स्केलिंग:
  - Left / Center / Right अलाइनमेंट।
  - नेचुरल स्केलिंग: इमेजेस जबरदस्ती नहीं खिंचतीं, वे अपने असली साइज़ में क्रिस्प और शार्प दिखती हैं।

[5] ब्लैंक पेज (+ Blank Page):
  - हर सवाल या पेज के बाद अपने आप खाली पेज जुड़ेगा (रफ वर्क / नोट्स के लिए)।

[6] एक्सपोर्ट इंजन (Export to Folder):
  - Browse बटन दबाकर आउटपुट फ़ोल्डर चुनें।
  - "Export PDF": प्रिंटेबल हाई-क्वालिटी PDF फ़ाइल।
  - "Export Word (.docx)": चुने गए पेपर साइज़ के अनुसार एडिटेबल MS Word फ़ाइल।
  - "Export PPTX (.pptx)": डिजिटल बोर्ड पर पढ़ाने के लिए 16:9 स्लाइड्स वाली PowerPoint फ़ाइल।


================================================================================

--------------------------------------------------------------------------------
7. डायरेक्ट इमेजेज / फ़ोल्डर इम्पोर्ट (Direct Images Import Mode)
--------------------------------------------------------------------------------
अगर आपके पास पहले से कटी हुई MCQ इमेजेस रखी हैं:
1. ऊपर से "Step 2: Builder" टैब पर जाएं।
2. "Add Images" या "Add Folder" बटन दबाकर अपनी इमेजेज या फ़ोल्डर चुनें।
3. सिस्टम अपने आप सभी सवालों को सही क्रम (1, 2, 3... 10) में लोड करके प्रीव्यू बना देगा।
4. तुरंत PDF, Word (.docx) या PPTX एक्सपोर्ट कर लें।