===== คำอธิบายภาพประกอบ =====

PMA.core รองรับคำอธิบายประกอบสามประเภท ได้แก่ คำอธิบายประกอบของ PMA.core, คำอธิบายประกอบดั้งเดิม, และคำอธิบายประกอบของบุคคลภายนอก

^ประเภทคำอธิบายประกอบ ^ ต้นทาง ^ รูปแบบ ^อ่าน/เขียน^
|Pathomation |PMA.studio; SDK |WKT |Read/write |
|ของพื้นเมือง | ผู้ชมเฉพาะผู้ขาย; ผู้ชม Pannoramic; ImageScope | ฝังอยู่ในรูปแบบไฟล์ผู้ขาย| อ่านอย่างเดียว |
|บุคคลที่สาม | Indica Labs HALO; Definiens; Visiopharm | .Annotation XML; .XML; .MLD (ไบนารี) | อ่านอย่างเดียว |  

==== ที่เก็บข้อมูลภายใน ====

PMA.core ใช้รูปแบบภายในของตัวเองโดยมีโครงสร้างดังต่อไปนี้:
  * เรขาคณิต: ตาม WKT [[https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry|(Well-known text)]] รองรับรูปร่างต่อไปนี้ รูปหลายเหลี่ยม, ลายเส้น, จุดและหลายจุด
  * สี: สีเค้าโครงในรูปแบบ [[https://www.w3schools.com/html/html_colors.asp|html]]
  * การเติมสี: การเติมสี (ถ้ามี) ใช้ได้เฉพาะกับรูปร่างปิด เช่น รูปหลายเหลี่ยม
  * การจัดประเภท: ข้อความระบุการจำแนกประเภทของคำอธิบายประกอบ เช่น เนื้องอก, เนื้อร้าย เป็นต้น
  * หมายเหตุ: บันทึกข้อความและข้อมูลเพิ่มเติมที่คุณต้องการฟรี เพื่อจัดเก็บทุกคำอธิบายประกอบ

PMA.core รองรับคำอธิบายประกอบจากผู้ขายภายนอกต่อไปนี้ **Visiofarm**, **Indica Labs** และ
**Aperio** แต่ละรูปได้รับการรองรับผ่านการแยกวิเคราะห์ไฟล์เฉพาะของผู้จำหน่ายที่เกี่ยวข้อง:
  * Visiopharm .mld
  * Indica Labs .annotations
  * Aperio .xml

==== การสร้างและการบันทึก ====

=== คำอธิบายภาพประกอบ PMA.core ===
 
สำหรับการอ่านคำอธิบายประกอบสไลด์ของ PMA.core คุณสามารถใช้ API ที่เรียกว่า [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotations|GetAnnotations]],
ที่จะแปลงคำอธิบายประกอบ PMA.core ทั้งหมดเป็นรูปแบบ json

ฟังก์ชันสำหรับคำอธิบายประกอบ PMA.core อื่นๆ ทั้งหมดมีให้ผ่านการคำสั่ง API [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.SaveAnnotations|SaveAnnotations]] โดยสามารถสร้างใหม่, อัปเดต, และลบคำอธิบายประกอบจำนวนมากในการเรียกใช้คำสั่ง API เพียงครั้งเดียว PMA.core ยังมีฟังก์ชันการทำงานเพื่อรับข้อมูลความยาว และ/หรือ พื้นที่พื้นผิว สำหรับคำอธิบายประกอบที่บันทึกไว้แล้วผ่านคำสั่ง [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationDistance|GetAnnotationDistance]] และ [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationSurfaceArea|GetAnnotationSurfaceArea]] 

=== คำอธิบายประกอบจากบุคคลภายนอก ===

PMA.core สามารถใช้คำอธิบายประกอบจากบุคคลภายนอก ผ่านอินเทอร์เฟซของไฟล์ภายนอก และคำสั่ง API ที่เกี่ยวข้อง API เหล่านี้เชื่อมโยงไฟล์ที่มีคำอธิบายประกอบของบุคคลภายนอกเข้ากับสไลด์ (ดูย่อหน้าก่อนหน้า) ในการเชื่อมโยงไฟล์ภายนอกกับสไลด์ คุณต้องใช้คำสั่ง API [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_SetExternalAnnotationFiles|SetExternalAnnotationFiles]] ซึ่งจะใช้แถวชุดข้อมูลที่ไม่สามารถเปลี่ยนแปลงได้ (Array of tuples) ที่มี ชื่อ และเส้นทาง สำหรับไฟล์คำอธิบายประกอบจากบุคคลภายนอกที่เกี่ยวข้องแต่ละไฟล์ 
คุณสามารถตั้งชื่อใดก็ได้ เพื่อแยกความแตกต่างจากคำอธิบายประกอบอื่นๆ และเส้นทางจะต้องเป็น เส้นทางเสมือน ไปยังไฟล์ที่มีคำอธิบายประกอบ
คุณสามารถนำไฟล์คำอธิบายประกอบภายนอกที่ตั้งค่าไว้ก่อนหน้านี้สำหรับสไลด์ ผ่านคำสั่ง API [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_GetExternalAnnotationFiles|GetExternalAnnotationFiles]] ซึ่งจะให้ชุดข้อมูล ชื่อ/เส้นทาง สำหรับแต่ละไฟล์ที่เกี่ยวข้องกับสไลด์ใดๆ

==== การนำออกและการแปลงรูปแบบ ====

PMA.core มี API ที่ทรงพลังมากในการส่งออกและแปลงรูปแบบคำอธิบายประกอบที่มีทั้งหมด ไม่ว่าจะเป็นคำอธิบายประกอบของ PMA.core, คำอธิบายประกอบของบุคคลภายนอก, หรือคำอธิบายประกอบที่มีมาแต่แรก คำสั่ง API [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.ExportAnnotations|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

เรามี [[https://realdata.pathomation.com/annotations-et-al/|บทความในบล็อกเกี่ยวกับคำอธิบายประกอบและวิธีจัดการ]] ไม่ใช่แค่ใน PMA.core เท่านั้นแต่สำหรับ [[https://www.pathomation.com/platform|แพลตฟอร์มซอฟต์แวร์ทั้งหมดของ Pathomation]]