This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
working_with_annotations [2022/03/08 15:57] antreas [Annotation types] |
working_with_annotations [2022/03/08 16:00] antreas [Creating and saving] |
||
---|---|---|---|
Line 21: | Line 21: | ||
For reading the PMA.core annotations for a slide you can use the API call [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotations|GetAnnotations]], that returns all PMA.core annotation in json format. | For reading the PMA.core annotations for a slide you can use the API call [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotations|GetAnnotations]], that returns all PMA.core annotation in json format. | ||
- | All other PMA.core annotations functionality is provided via the [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.SaveAnnotations|SaveAnnotations]] API call. This call can create new, update and delete many annotations in one API call. PMA.core also provided the functionality to get the length and/or the surface area for already saved annotations via the [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationDistance|GetAnnotationDistance]] and [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationSurfaceArea|GetAnnotationSurfaceArea]] API calls. | + | All other PMA.core annotations functionality is provided via the [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.SaveAnnotations|SaveAnnotations]] API call. This call can create new, update and delete many annotations in one API call. PMA.core also provides the functionality to get the length and/or the surface area for already saved annotations via the [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationDistance|GetAnnotationDistance]] and [[https://docs.pathomation.com/pma.core.api/#/Api/PMA.Services.Api.HistoScope.GetAnnotationSurfaceArea|GetAnnotationSurfaceArea]] API calls. |
== 3rd Party annotations == | == 3rd Party annotations == | ||
- | PMA.core can leverage the use of 3rd party annotations via the External Files interface and the appropriate API calls. | + | PMA.core can leverage the use of 3rd party annotations via the External Files interface and the associated API calls. |
- | This calls associates a number of files containing any known 3rd party annotations with a slide (for known formats and extensions see the previous paragraph). To associate external files with a slide you have to use the API call [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_SetExternalAnnotationFiles|SetExternalAnnotationFiles]]. This takes an array of tuples containing the //Name// and //Path// for each associated 3rd party annotations file. For //Name// you can use any text to differentiate from other annotations an the //Path// needs to be a //virtual path// to the file containing the annotations. | + | These API associates a number of files containing any known 3rd party annotations with a slide (see previous paragraph). To associate external files with a slide you have to use the API call [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_SetExternalAnnotationFiles|SetExternalAnnotationFiles]]. This takes an array of tuples containing the //Name// and //Path// for each associated 3rd party annotations file. For //Name// you can use any text to differentiate from other annotations an the //Path// needs to be a //virtual path// to the file containing the annotations. |
- | You can get the previously set external annotations files for a slide via the [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_GetExternalAnnotationFiles|GetExternalAnnotationFiles]] API call, which returns the array of //Name/Path////Italic Text// tuples for each file associated with any slide | + | You can get the previously set external annotations files for a slide via the [[https://docs.pathomation.com/pma.core.api/#/Api/Slide_GetExternalAnnotationFiles|GetExternalAnnotationFiles]] API call, which returns the array of //Name/Path// tuples for each file associated with any slide |
==== Exporting and format conversion ==== | ==== Exporting and format conversion ==== |