คู่มือการใช้งาน PDF Coordinate Marker

1 ภาพรวมและวิธีเปิดใช้งาน

เครื่องมือนี้ใช้สำหรับ หาตำแหน่ง X, Y ที่แม่นยำบนเอกสาร PDF เช่น ตำแหน่งลายเซ็น ตำแหน่งตราประทับ ตำแหน่ง field ที่จะวางข้อมูล แล้วส่งออกเป็น JSON ไปใช้กับโปรแกรม/ระบบอื่นต่อได้

วิธีเปิด: คลิก PDF Coordinate Marker

2 อัปโหลด PDF

ทำได้ 2 วิธี:

• กดปุ่ม Upload PDF ที่แถบเครื่องมือบนสุด แล้วเลือกไฟล์
• ลากไฟล์ .pdf มาวาง ในพื้นที่แสดงผล (พื้นหลังสีเข้มที่มีข้อความ "ลากไฟล์ PDF มาวางที่นี่")

รองรับ PDF หลายหน้า — ทุกหน้าแสดงเรียงต่อกันให้เลื่อนดูได้ในที่เดียว และแต่ละหน้าจะมีป้ายข้อมูลแสดงเหนือหน้านั้น ๆ:

3 การปักหมุด (Markers)

3  หมุดแต่ละจุดแสดงเป็นจุดสีส้มพร้อมเลขลำดับ และมีเส้น crosshair บอกตำแหน่งจุดศูนย์กลางที่แม่นยำ

4 การตั้งค่าจุดอ้างอิง (0,0)

ปุ่ม "(0,0):" ที่แถบเครื่องมือบนสุด ใช้กำหนดว่าจุดเริ่มต้น (0,0) ของแต่ละหน้าอยู่ที่มุมไหน เลือกได้ 2 แบบ:

• มุมบนซ้าย (ค่าเริ่มต้น) — แกน Y วัดจากบนลงล่าง (ตามแนวจอภาพทั่วไป)
• มุมล่างซ้าย — แกน Y วัดจากล่างขึ้นบน (ตามระบบพิกัดมาตรฐานของไฟล์ PDF)

เมื่อสลับปุ่มนี้:

• ค่า Y ในตารางหมุดและใน JSON จะคำนวณใหม่ทันที ตามมุมที่เลือก
• จะมีป้าย (0,0) พร้อมลูกศรแกน X→ และ ↓Y (ถ้าเลือกมุมบนซ้าย) หรือ ↑Y (ถ้าเลือกมุมล่างซ้าย) ปรากฏอยู่ที่มุมจริงของทุกหน้า ให้เห็นภาพชัดว่าแกนวิ่งไปทางไหน

5 การซูม (Zoom)

แถบควบคุมลอยอยู่มุมขวาบนของพื้นที่แสดง PDF (ติดอยู่กับที่แม้เลื่อนสกอลล์ลง):

ทำไมต้องซูม: เมื่อซูมเข้า พื้นที่หน้าจอต่อ 1 จุดบน PDF จะใหญ่ขึ้น ทำให้คลิก/ลากหมุดได้แม่นยำขึ้นมาก โดยเฉพาะเอกสารที่มีรายละเอียดเล็ก ๆ

ตำแหน่งหมุดที่ปักไว้แล้วไม่ได้รับผลกระทบจากการซูมเลย เพราะระบบเก็บพิกัดเป็นเปอร์เซ็นต์เทียบกับหน้าอยู่แล้ว

6 รายการหมุดและข้อมูลหน้ากระดาษ (Sidebar)

การ์ด "หมุดพิกัด (Markers)"

แสดงจำนวนหมุดทั้งหมด และตารางที่มีคอลัมน์: ลำดับ, หน้า, X (pt), Y (pt), ป้ายชื่อ (แก้ไขได้), ปุ่มลบ — ค่า X/Y ที่แสดงจะอัปเดตทันทีตามจุดอ้างอิง (0,0) ที่เลือกไว้

การ์ด "ขนาดอ้างอิง A4"

แสดงค่ามาตรฐาน A4 (595.28 × 841.89 pt หรือ 210 × 297 mm) เกณฑ์การตรวจสอบ (±2pt) และจำนวนหน้าในไฟล์ปัจจุบันที่ตรงกับ A4

7 JSON Output: เลือกฟิลด์ / Copy / Export

เลือกฟิลด์ที่จะ Export

กดหัวข้อ "ฟิลด์ที่จะ Export ▾" เพื่อเปิดแผงเลือกฟิลด์ ภายในมี:

• Checkbox ของแต่ละฟิลด์ — ติ๊ก/ปลดติ๊กได้อิสระ
• ปุ่ม "เลือกทั้งหมด" / "ไม่เลือกเลย" — กดทีเดียวจัดการได้ครบ
• Checkbox แยก "รวมข้อมูลขนาดหน้า/A4 (pages, a4Reference)" — ถ้าไม่ต้องการ metadata ส่วนนี้ปิดได้
• ตัวเลขข้างหัวข้อ (เช่น (5/11)) บอกจำนวนฟิลด์ที่เลือกอยู่ในขณะนั้น

ค่าเริ่มต้นที่ติ๊กไว้ให้: order, page, label, x, y
ฟิลด์เสริม (ปลดติ๊กไว้ก่อน): origin, xPercent, yPercent, xPt, yPtFromTop, yPtFromBottom

ปรับ checkbox เมื่อไหร่ ช่อง JSON preview ด้านล่างจะอัปเดตให้ดูทันที

Copy JSON

กดปุ่ม Copy JSON (มีทั้งที่แถบเครื่องมือบนสุด และในการ์ด JSON Output) เพื่อคัดลอกผลลัพธ์ JSON ทั้งหมดเข้า clipboard ทันที พร้อมแจ้งเตือนเมื่อสำเร็จ

Export JSON

กดปุ่ม Export JSON เพื่อดาวน์โหลดไฟล์ .json — ชื่อไฟล์จะตั้งตามชื่อ PDF อัตโนมัติ เช่น เอกสาร-markers.json

8 Import JSON

ใช้สำหรับนำหมุดที่เคย Export ไว้ (หรือไฟล์ JSON ที่สร้างตามโครงสร้างเดียวกัน) กลับเข้ามาวางบน PDF เดิมอีกครั้ง

ขั้นตอน:

1. อัปโหลด PDF ที่ตรงกับไฟล์ JSON นั้นไว้ก่อน (ต้องมี PDF เปิดอยู่ก่อนถึงจะ Import ได้)
2. กดปุ่ม Import JSON แล้วเลือกไฟล์ .json
3. หมุดทั้งหมดในไฟล์จะถูกวางกลับเข้าไปบนหน้าที่ตรงกัน พร้อมป้ายชื่อเดิม

ระบบรองรับการอ่านค่าพิกัดได้หลายรูปแบบ (x/y, xPercent/yPercent, xPt, yPtFromTop, yPtFromBottom) — แม้ไฟล์ที่ Import มาจะถูกเลือก Export เฉพาะบางฟิลด์ไว้ก็ยังนำเข้าได้ตามปกติ

9 อ้างอิงโครงสร้างไฟล์ JSON

ฟิลด์ระดับเอกสาร (เสมอ)

ฟิลด์ระดับเอกสาร (เปิด/ปิดได้ผ่าน checkbox "รวมข้อมูลขนาดหน้า/A4")

ฟิลด์ของแต่ละหมุด (markers[]) — เลือกรวม/ไม่รวมได้ทีละฟิลด์

ตัวอย่าง JSON (เลือกฟิลด์ default)

{
  "fileName": "เอกสาร.pdf",
  "pageCount": 2,
  "exportedAt": "2026-06-27T03:40:00.000Z",
  "originMode": "top-left",
  "originNote": "(0,0) อยู่ที่มุมบนซ้ายของแต่ละหน้า — ...",
  "a4Reference": { "widthPt": 595.28, "heightPt": 841.89, "widthMm": 210, "heightMm": 297 },
  "pages": [
    { "page": 1, "widthPt": 595.28, "heightPt": 841.89, "widthMm": 210, "heightMm": 297, "isA4": true }
  ],
  "markers": [
    { "order": 1, "page": 1, "label": "ลายเซ็น", "x": 120.5, "y": 700.25 }
  ]
}

10 เคล็ดลับและข้อสังเกต

• ทุกอย่างประมวลผลในเบราว์เซอร์ของคุณเอง ไม่มีการส่งไฟล์ PDF หรือหมุดที่ปักไว้ขึ้นเซิร์ฟเวอร์ใด ๆ
• อัปโหลด PDF ใหม่ทับ จะล้างหมุดเดิมทั้งหมดทันที — ถ้ายังไม่ได้ Export ควร Export ก่อนเปลี่ยนไฟล์
• เอกสารที่มีหน้าหลายขนาด/หลายแนวปนกัน (เช่น A4 ปนกับหน้าแนวนอน) แสดงผลได้ถูกต้องตามสัดส่วนจริง ไม่ต้องตั้งค่าอะไรเพิ่ม
• ใช้ปุ่ม "มุมมองปกติ" เพื่อกลับไปดูภาพรวมขนาดจริงทุกครั้งหลังซูมเข้าไปดูรายละเอียด
• ค่าพิกัดที่ Export ออกมาจะปัดทศนิยม 2 ตำแหน่ง เสมอ เพื่อความกระชับและอ่านง่าย

11 แก้ปัญหาที่พบบ่อย