===== Arbeiten mit Kommentaren =====

PMA.core unterstützt drei Arten von Annotationen: PMA.core Annotationen, native Annotationen und Annotationen von Drittanbietern.

^Art der Anmerkung ^Herkunft^ Format ^ Read/Write ^
|Pathomation |PMA.studio; SDK |WKT |Read/write |
|Einheimische |	Herstellerspezifischer Viewer; Pannoramic-Viewer; ImageScope |	Eingebettet in das Dateiformat des Anbieters |Schreibgeschützt |
|Drittanbieter|Indica Labs HALO; Definiens; Visiopharm |.Annotation XML; .XML; .MLD (binär)| Schreibgeschützt|

==== Interner Speicher ====

PMA.core verwendet ein eigenes internes Format mit der folgenden Struktur:
  * Geometrie: basiert auf WKT ([[https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry|Well-known text]]). Unterstützt die folgenden Formen Polygon, Linestring, Punkt und Multipunkt
  * Farbe: die Farbe des Umrisses im [[https://www.w3schools.com/html/html_colors.asp|html-Format]]
  * Füllfarbe: die Füllfarbe (falls vorhanden), nur gültig für geschlossene Formen wie Polygone
  * Klassifizierung: Ein Text, der die Klassifizierung einer Anmerkung wie Tumor, Nekrose usw. angibt.
  * Notizen: Freitextnotizen und zusätzliche Informationen, die Sie für jede Anmerkung speichern möchten

PMA.core unterstützt Anmerkungen von Drittanbietern der folgenden Hersteller: **Visiopharm**, **Indica Labs** und **Aperio**. Jedes dieser Formate wird durch Parsen der jeweiligen herstellerspezifischen Datei unterstützt:
  * Visiopharm //.mld//
  * Indica Labs //. Anmerkungen//
  * Aperio //.xml//

==== Erstellen und Speichern ====

=== PMA.core-Anmerkungen ===

Um die PMA.core-Anmerkungen für eine Folie zu lesen, können Sie den API-Aufruf [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotations|GetAnnotationsverwenden]], der alle PMA.core-Anmerkungen im json-Format zurückgibt.

Alle anderen Funktionen von PMA.core annotations werden über den [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.SaveAnnotations|SaveAnnotations]] API-Aufruf bereitgestellt. Mit diesem Aufruf können viele Anmerkungen in einem einzigen API-Aufruf erstellt, aktualisiert und gelöscht werden. PMA.core bietet auch die Möglichkeit, die Länge und/oder die Fläche für bereits gespeicherte Anmerkungen über die API-Aufrufe [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationDistance|GetAnnotationDistance]] und [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationSurfaceArea|GetAnnotationSurfaceArea]] zu ermitteln.

==== Anmerkungen von Drittanbietern ====

PMA.core kann über die Schnittstelle "Externe Dateien" und die damit verbundenen API-Aufrufe die Verwendung von Drittanbieter-Anmerkungen nutzen. Diese API assoziiert eine Reihe von Dateien, die alle bekannten Anmerkungen von Drittanbietern enthalten, mit einer Folie (siehe vorheriger Absatz). Um externe Dateien mit einer Folie zu verknüpfen, müssen Sie den API-Aufruf [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_SetExternalAnnotationFiles|SetExternalAnnotationFiles]]. Dieser nimmt ein Array von Tupeln auf, das den Namen und den Pfad für jede verknüpfte Datei mit Drittanbieter-Anmerkungen enthält. Für Name können Sie einen beliebigen Text verwenden, um sich von anderen Anmerkungen zu unterscheiden, und der Pfad muss ein virtueller Pfad zu der Datei sein, die die Anmerkungen enthält. Sie können die zuvor festgelegten externen Anmerkungsdateien für eine Folie über den [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_GetExternalAnnotationFiles|GetExternalAnnotationFiles]] API-Aufruf abrufen, der das Array von Name/Pfad-Tupeln für jede mit einer Folie verbundene Datei zurückgibt

==== Exportieren und Formatkonvertierung ====

PMA.core bietet eine sehr leistungsfähige API zum Exportieren und Konvertieren aller bekannten Annotationsformate, egal ob es sich um PMA.core Annotations, 3rd Party Annotations oder native Annotations handelt. Der API-Aufruf [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.ExportAnnotations|ExportAnnotations]] kann jede bekannte Quelle von Annotationen (//PMA.core annotations, Native annotations , Visiopharm , Indica Labs , Aperio//) in jedes der Formate von Drittanbietern (Visiopharm Indica Labs Aperio) konvertieren. Dieser Aufruf unterstützt auch zwei weitere sehr nützliche Formate für die Verwendung außerhalb von PMA.core, nämlich die Formate CSV und WKT (Well-Known text). PMA.core versucht, jedes Format so fehlerfrei wie möglich zu konvertieren, aber einige Shapes sind nicht mit Shapes in anderen Formaten kompatibel. Wenn Quell- und Zielformat identisch sind, führt PMA.core keine Konvertierung durch, sondern gibt die Originaldatei aus.

==== Mehr Hintergrund ====

Wussten Sie, dass PMA.core ein großartiges Werkzeug ist, um verschiedene Annotationen aus unterschiedlichen Quellen zu integrieren? Für mehr Hintergrundinformationen, schauen Sie sich die [[de:pmann|Pathomation ANNotation]] subset of functionality in der API. 

Wir haben einen [[https://realdata.pathomation.com/annotations-et-al/|Blog-Artikel]] über Annotationen und deren Handhabung, nicht nur innerhalb von PMA.core, sondern in der [[https://www.pathomation.com/platform|gesamten Pathomation Software-Plattform]].