PMA.core รองรับคำอธิบายประกอบสามประเภท ได้แก่ คำอธิบายประกอบของ PMA.core, คำอธิบายประกอบดั้งเดิม, และคำอธิบายประกอบของบุคคลภายนอก
| ประเภทคำอธิบายประกอบ | ต้นทาง | รูปแบบ | อ่าน/เขียน |
|---|---|---|---|
| Pathomation | PMA.studio; SDK | WKT | Read/write |
| ของพื้นเมือง | ผู้ชมเฉพาะผู้ขาย; ผู้ชม Pannoramic; ImageScope | ฝังอยู่ในรูปแบบไฟล์ผู้ขาย | อ่านอย่างเดียว |
| บุคคลที่สาม | Indica Labs HALO; Definiens; Visiopharm | .Annotation XML; .XML; .MLD (ไบนารี) | อ่านอย่างเดียว |
PMA.core ใช้รูปแบบภายในของตัวเองโดยมีโครงสร้างดังต่อไปนี้:
PMA.core รองรับคำอธิบายประกอบจากผู้ขายภายนอกต่อไปนี้ Visiofarm, Indica Labs และ Aperio แต่ละรูปได้รับการรองรับผ่านการแยกวิเคราะห์ไฟล์เฉพาะของผู้จำหน่ายที่เกี่ยวข้อง:
สำหรับการอ่านคำอธิบายประกอบสไลด์ของ PMA.core คุณสามารถใช้ API ที่เรียกว่า GetAnnotations, ที่จะแปลงคำอธิบายประกอบ PMA.core ทั้งหมดเป็นรูปแบบ json
ฟังก์ชันสำหรับคำอธิบายประกอบ PMA.core อื่นๆ ทั้งหมดมีให้ผ่านการคำสั่ง API SaveAnnotations โดยสามารถสร้างใหม่, อัปเดต, และลบคำอธิบายประกอบจำนวนมากในการเรียกใช้คำสั่ง API เพียงครั้งเดียว PMA.core ยังมีฟังก์ชันการทำงานเพื่อรับข้อมูลความยาว และ/หรือ พื้นที่พื้นผิว สำหรับคำอธิบายประกอบที่บันทึกไว้แล้วผ่านคำสั่ง GetAnnotationDistance และ GetAnnotationSurfaceArea
PMA.core สามารถใช้คำอธิบายประกอบจากบุคคลภายนอก ผ่านอินเทอร์เฟซของไฟล์ภายนอก และคำสั่ง API ที่เกี่ยวข้อง API เหล่านี้เชื่อมโยงไฟล์ที่มีคำอธิบายประกอบของบุคคลภายนอกเข้ากับสไลด์ (ดูย่อหน้าก่อนหน้า) ในการเชื่อมโยงไฟล์ภายนอกกับสไลด์ คุณต้องใช้คำสั่ง API SetExternalAnnotationFiles ซึ่งจะใช้แถวชุดข้อมูลที่ไม่สามารถเปลี่ยนแปลงได้ (Array of tuples) ที่มี ชื่อ และเส้นทาง สำหรับไฟล์คำอธิบายประกอบจากบุคคลภายนอกที่เกี่ยวข้องแต่ละไฟล์ คุณสามารถตั้งชื่อใดก็ได้ เพื่อแยกความแตกต่างจากคำอธิบายประกอบอื่นๆ และเส้นทางจะต้องเป็น เส้นทางเสมือน ไปยังไฟล์ที่มีคำอธิบายประกอบ คุณสามารถนำไฟล์คำอธิบายประกอบภายนอกที่ตั้งค่าไว้ก่อนหน้านี้สำหรับสไลด์ ผ่านคำสั่ง API GetExternalAnnotationFiles ซึ่งจะให้ชุดข้อมูล ชื่อ/เส้นทาง สำหรับแต่ละไฟล์ที่เกี่ยวข้องกับสไลด์ใดๆ
PMA.core มี API ที่ทรงพลังมากในการส่งออกและแปลงรูปแบบคำอธิบายประกอบที่มีทั้งหมด ไม่ว่าจะเป็นคำอธิบายประกอบของ PMA.core, คำอธิบายประกอบของบุคคลภายนอก, หรือคำอธิบายประกอบที่มีมาแต่แรก คำสั่ง API ExportAnnotations สามารถแปลงคำอธิบายประกอบจากทุกแหล่งที่มาที่เรารู้จัก (คำอธิบายประกอบของ PMA.core, คำอธิบายประกอบของบุคคลภายนอก, หรือคำอธิบายประกอบที่มีมาแต่แรก, Visiopharm, Indica Labs, Aperio) ไปเป็นรูปแบบ (Visiofarm, Indica Labs, Aperio) คำสั่งนี้ยังรับรองรูปแบบสำหรับการใช้งานนอก PMA.core ที่มีประโยชน์อย่างมาก นั่นคือ รูปแบบ CSV และ WKT (Well-Known text) PMA.core จะพยายามพัฒนาความสามารถในการแปลงรูปแบบอย่างไม่มีข้อผิดพลาดเท่าที่เป็นไปได้ แต่รูปร่างบางรูปร่างอาจใช้ไม่ได้กับบางรูปแบบ และหากรูปแบบต้นทางและปลายทางเหมือนกัน PMA.core จะไม่ทำการแปลงใดๆ และส่งออกเป็นไฟล์ต้นฉบับ
คุณรู้หรือไม่ว่า PMA.core เป็นเครื่องมือที่ทรงพลังในการผสานรวมคำอธิบายประกอบต่าง ๆ ที่มีต้นกำเนิดแตกต่างกัน สำหรับแบ็กกราวด์เพิ่มเติม กรุณาดูที่ ชุดฟังก์ชันย่อยของ Pathomation ANNotation ใน API
เรามี บทความในบล็อกเกี่ยวกับคำอธิบายประกอบและวิธีจัดการ ไม่ใช่แค่ใน PMA.core เท่านั้นแต่สำหรับ แพลตฟอร์มซอฟต์แวร์ทั้งหมดของ Pathomation