Skip to content

roi_rect — ตัดภาพพื้นที่สนใจตามพิกัด Fixture ​

โมดูล roi_rect ใช้สำหรับตัดกรอบสี่เหลี่ยม (Region of Interest: ROI) ออกจากภาพ โดยอ้างอิงตำแหน่งและมุมเอียงจากระบบพิกัดของชิ้นงาน (Fixture Space) ทำให้กรอบ ROI ขยับและหมุนตามชิ้นงานได้โดยอัตโนมัติ แม้ชิ้นงานจะวางเยื้องหรือเอียงจากตำแหน่งเดิม

1. การใช้งานใน Recipe ​

  • Inputs:
    • image (จำเป็น): ภาพ Grayscale CV_8UC1
    • pose (จำเป็น): ชื่อ stepId ของโมดูลที่ส่งออก Pose2D (เช่น fixture_ncc)
  • Parameters:
    • x, y (double, ค่าเริ่มต้น 0.0): พิกัดมุมซ้ายบนของ ROI ในพิกัด Fixture (หน่วย px เทียบกับจุดกึ่งกลางของ Template)
    • w, h (double, ค่าเริ่มต้น 100.0, ขั้นต่ำ 1.0): ความกว้างและความสูงของ ROI (หน่วย px)
    • angleDeg (double, ค่าเริ่มต้น 0.0): มุมหมุนเพิ่มเติมของ ROI ในพิกัด Fixture (หน่วยองศา)
    • space (string, ค่าเริ่มต้น "fixture"): ระบบพิกัดอ้างอิง (ใน Phase 1 รองรับเฉพาะ "fixture")
  • Outputs / Metrics:
    • image: ภาพที่ถูกตัดและหมุนให้ตั้งตรงแล้ว ขนาด (round(w)×round(h))
    • centerX, centerY (double): พิกัดจุดกึ่งกลาง ROI ในพิกัดภาพจริง
    • width, height (double): ขนาด ROI
    • angleDeg (double): มุมรวมของ ROI ในพิกัดภาพจริง (องศา)
json
{
  "id": "ring_roi",
  "type": "roi_rect",
  "enabled": true,
  "params": {
    "x": -60.0,
    "y": -60.0,
    "w": 120.0,
    "h": 120.0,
    "angleDeg": 0.0,
    "space": "fixture"
  },
  "inputs": {
    "image": "gray",
    "pose": "fix"
  }
}

2. หลักการทำงานภายในซอฟต์แวร์ ​

อ้างอิงจาก src/tools/roi_rect.cpp:

  1. ตรวจสอบว่า pose จากขั้นตอน Fixture มีค่าอยู่จริง หาก Fixture หาชิ้นงานไม่พบ (!pose.has_value()) โมดูลนี้จะคืนค่า Status::Error เพื่อหยุด Cycle ทันที
  2. คำนวณจุดกึ่งกลางและมุมทั้ง 4 ของกรอบ ROI จากพิกัด Fixture ไปยังพิกัดภาพจริง
  3. ตรวจสอบขอบเขตอย่างเข้มงวด (Explicit Bounds Check): หากมุมใดมุมหนึ่งของ ROI ออกนอกช่วง [0,cols)×[0,rows) ระบบจะปฏิเสธและคืนค่า Status::Error ทันที (ไม่มีการตัดขอบแบบเงียบๆ)
  4. ใช้ cv::warpAffine ดึงพิกเซลจากกรอบที่เอียงให้กลับมาเป็นภาพสี่เหลี่ยมตั้งตรงขนาด (outW, outH)

3. ทฤษฎีเบื้องหลัง (OpenCV & Machine Vision) ​

การแปลงพิกัด 2 มิติ (Rigid Body Transform) ​

การย้ายจุด p=(px,py) จากระบบพิกัด Fixture ไปยังระบบพิกัดภาพ (Image Coordinates) ใช้การหมุนรอบจุดกำเนิดแล้วบวกด้วยตำแหน่งของ Fixture f=(fx,fy,θ):

rot(θ,p)=[cos⁡θsin⁡θ−sin⁡θcos⁡θ][pxpy]toImage(f,p)=[fxfy]+rot(fangleRad,p)

การตัดภาพด้วย Inverse Affine Mapping ​

แทนที่จะหมุนภาพทั้งเฟรมก่อนแล้วค่อย Crop (ซึ่งช้าและกินหน่วยความจำ) roi_rect สร้างเมทริกซ์ Affine ขนาด 2×3 โดยตรงแล้วเรียก cv::warpAffine พร้อมธง cv::WARP_INVERSE_MAP | cv::INTER_NEAREST:

  • WARP_INVERSE_MAP: บอก OpenCV ว่าเมทริกซ์ M เป็นการแปลงจากพิกัดภาพผลลัพธ์ (Destination) กลับไปหาพิกัดภาพต้นฉบับ (Source) ทำให้ดึงเฉพาะพิกเซลที่อยู่ใน ROI เท่านั้น
  • INTER_NEAREST: ใช้การประมาณค่าพิกเซลที่ใกล้ที่สุด เพื่อให้ได้ความเร็วสูงสุดและรักษาค่าพิกเซลต้นฉบับไม่ให้เกิดการเบลอจากการ Interpolate

การหาค่า x, y ในพิกัด Fixture

เนื่องจากจุดกำเนิด (0,0) ของ Fixture อยู่ที่จุดกึ่งกลางของ Template หากต้องการสร้าง ROI ขนาด 120×120 ที่ครอบรอบจุดกึ่งกลางพอดี ให้ตั้ง x: -60, y: -60, w: 120, h: 120 ครับ