Appearance
roi_rect — ตัดภาพพื้นที่สนใจตามพิกัด Fixture
โมดูล roi_rect ใช้สำหรับตัดกรอบสี่เหลี่ยม (Region of Interest: ROI) ออกจากภาพ โดยอ้างอิงตำแหน่งและมุมเอียงจากระบบพิกัดของชิ้นงาน (Fixture Space) ทำให้กรอบ ROI ขยับและหมุนตามชิ้นงานได้โดยอัตโนมัติ แม้ชิ้นงานจะวางเยื้องหรือเอียงจากตำแหน่งเดิม
1. การใช้งานใน Recipe
- Inputs:
image(จำเป็น): ภาพ GrayscaleCV_8UC1pose(จำเป็น): ชื่อ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: ภาพที่ถูกตัดและหมุนให้ตั้งตรงแล้ว ขนาดcenterX,centerY(double): พิกัดจุดกึ่งกลาง ROI ในพิกัดภาพจริงwidth,height(double): ขนาด ROIangleDeg(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:
- ตรวจสอบว่า
poseจากขั้นตอน Fixture มีค่าอยู่จริง หาก Fixture หาชิ้นงานไม่พบ (!pose.has_value()) โมดูลนี้จะคืนค่าStatus::Errorเพื่อหยุด Cycle ทันที - คำนวณจุดกึ่งกลางและมุมทั้ง 4 ของกรอบ ROI จากพิกัด Fixture ไปยังพิกัดภาพจริง
- ตรวจสอบขอบเขตอย่างเข้มงวด (Explicit Bounds Check): หากมุมใดมุมหนึ่งของ ROI ออกนอกช่วง
ระบบจะปฏิเสธและคืนค่า Status::Errorทันที (ไม่มีการตัดขอบแบบเงียบๆ) - ใช้
cv::warpAffineดึงพิกเซลจากกรอบที่เอียงให้กลับมาเป็นภาพสี่เหลี่ยมตั้งตรงขนาด(outW, outH)
3. ทฤษฎีเบื้องหลัง (OpenCV & Machine Vision)
การแปลงพิกัด 2 มิติ (Rigid Body Transform)
การย้ายจุด
การตัดภาพด้วย Inverse Affine Mapping
แทนที่จะหมุนภาพทั้งเฟรมก่อนแล้วค่อย Crop (ซึ่งช้าและกินหน่วยความจำ) roi_rect สร้างเมทริกซ์ Affine ขนาด cv::warpAffine พร้อมธง cv::WARP_INVERSE_MAP | cv::INTER_NEAREST:
WARP_INVERSE_MAP: บอก OpenCV ว่าเมทริกซ์เป็นการแปลงจากพิกัดภาพผลลัพธ์ (Destination) กลับไปหาพิกัดภาพต้นฉบับ (Source) ทำให้ดึงเฉพาะพิกเซลที่อยู่ใน ROI เท่านั้น INTER_NEAREST: ใช้การประมาณค่าพิกเซลที่ใกล้ที่สุด เพื่อให้ได้ความเร็วสูงสุดและรักษาค่าพิกเซลต้นฉบับไม่ให้เกิดการเบลอจากการ Interpolate
การหาค่า x, y ในพิกัด Fixture
เนื่องจากจุดกำเนิด x: -60, y: -60, w: 120, h: 120 ครับ