User Tools

Site Tools


nonapi

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
nonapi [2023/01/13 13:00]
yves [Barcode]
nonapi [2023/11/27 18:35] (current)
chris
Line 1: Line 1:
 ===== Image Endpoints ===== ===== Image Endpoints =====
  
-The following endpoints are available in PMA.core to view Whole Slide Images and its associated labels, thumbnails and macro images. The following list contains the endpoint URL, a brief description and the available parameters for each one.+The following endpoints are available in PMA.core to view Whole Slide Images and their associated labels, thumbnails and macro images. The following list contains the endpoint URL, a brief description and the available parameters for each one.
  
 ==== Tile ==== ==== Tile ====
Line 12: Line 12:
 |**channels**|Comma separated channel indexes to render| |**channels**|Comma separated channel indexes to render|
 |**channelClipping**|Min and max limits to clip and scale pixel values. Two values required per channel| |**channelClipping**|Min and max limits to clip and scale pixel values. Two values required per channel|
 +|**channelColor**|Comma separated hex AARRGGBB color per fluorescent channel|
 |**gamma**|Gamma values for each channel. One value required per channel| |**gamma**|Gamma values for each channel. One value required per channel|
 |**x**|The x index of the tile| |**x**|The x index of the tile|
Line 29: Line 30:
 **/region** Renders a region of a slide **/region** Renders a region of a slide
 ^Parameter ^Description^ ^Parameter ^Description^
-|**sessionID**|The session ​id to authenticate with|+|**sessionID**|The session ​ID to authenticate with|
 |**pathOrUid**|The path or unique identifier of the image to render| |**pathOrUid**|The path or unique identifier of the image to render|
 |**timeframe**|The index of the time frame to render| |**timeframe**|The index of the time frame to render|
Line 40: Line 41:
 |**scale**|The factor to scale the rendered region by| |**scale**|The factor to scale the rendered region by|
 |**channelClipping**|Min and max limits to clip and scale pixel values. Two values required per channel.| |**channelClipping**|Min and max limits to clip and scale pixel values. Two values required per channel.|
 +|**channelColor**|Comma separated hex AARRGGBB color per fluorescent channel|
 |**gamma**|Gamma values for each channel. One value required per channel | |**gamma**|Gamma values for each channel. One value required per channel |
 |drawScaleBar|//​Optional//​ Draw an accurate scale bar| |drawScaleBar|//​Optional//​ Draw an accurate scale bar|
Line 56: Line 58:
 **Returns** A file stream that contains the rendered region **Returns** A file stream that contains the rendered region
  
-**Example** ///​region?​sessionId=%%sessionId%%&​pathOrUid=%%path%%&​timeframe=0&​layer=0&​channels=0&​channelClipping=0,​0&​gamma=1&​x=0&​y=0&​width=1000&​height=1000//​+**Example** ///​region?​sessionId=%%sessionId%%&​pathOrUid=%%path%%&​timeframe=0&​layer=0&​channels=0&​channelClipping=0,​0&​channelColor=ffffffff&​gamma=1&​x=0&​y=0&​width=1000&​height=1000&​scale=0.1//
  
 +In the example request above, the system will render a 1000x1000 pixel portion of the full resolution image and scale it to 100x100 pixels before it returns it to the client.
 ==== Thumbnail ==== ==== Thumbnail ====
 **/​thumbnail** Renders the associated thumbnail of slide **/​thumbnail** Renders the associated thumbnail of slide
 ^Parameter ^Description^ ^Parameter ^Description^
-|**sessionID**|The session ​id to authenticate with|+|**sessionID**|The session ​ID to authenticate with|
 |**pathOrUid**|The path or unique identifier of the image to render| |**pathOrUid**|The path or unique identifier of the image to render|
 |orientation|//​Optional//​ The orientation of the thumbnail (0 = auto; 1 = vertical; 2 = horizontal)| |orientation|//​Optional//​ The orientation of the thumbnail (0 = auto; 1 = vertical; 2 = horizontal)|
Line 75: Line 78:
  
 ^Parameter ^Description^ ^Parameter ^Description^
-|**sessionID**|The session ​id to authenticate with|+|**sessionID**|The session ​ID to authenticate with|
 |**pathOrUid**|The path or unique identifier of the image to render| |**pathOrUid**|The path or unique identifier of the image to render|
 |orientation|//​Optional//​ The orientation of the macro (0 = auto; 1 = vertical; 2 = horizontal)| |orientation|//​Optional//​ The orientation of the macro (0 = auto; 1 = vertical; 2 = horizontal)|
Line 85: Line 88:
  
 ==== Barcode ==== ==== Barcode ====
-**/​barcode** Renders the associated [[barcodes|barcode]] of a slide+**/​barcode** Renders the associated [[barcode|barcode]] of a slide
 ^Parameter ^Description^ ^Parameter ^Description^
-|**sessionID**|The session ​id to authenticate with|+|**sessionID**|The session ​ID to authenticate with|
 |**pathOrUid**|The path or unique identifier of the image to render| |**pathOrUid**|The path or unique identifier of the image to render|
 |orientation|//​Optional//​ The orientation of the barcode (0 = auto; 1 = vertical; 2 = horizontal)| |orientation|//​Optional//​ The orientation of the barcode (0 = auto; 1 = vertical; 2 = horizontal)|
nonapi.1673604019.txt.gz ยท Last modified: 2023/01/13 13:00 by yves