Sidebar
nonapi
This is an old revision of the document!
Image Endpoints
The following endpoints are available in PMA.core to view WSI and its associated labels, thumbnails and macro's. In the following list you can see the endpoint URL, a brief description and the available parameters for each one.
Tile
/tile Renders a square tile of a specified WSI
| Parameter | Description |
| sessionID | The session id to authenticate with |
| pathOrUid | The path or unique identifier of the image to render or a valid collection config JSON |
| timeframe | The index of the time frame to render |
| layer | The index of the layer to render |
| channels | The channels to render |
| channelClipping | Min and max limits to clip and scale pixel values. Two values required per channel |
| gamma | Gamma values for each channgel. One value required per channel |
| x | The x index of the tile |
| y | The y index of the tile |
| z | The z index of the tile |
| cache | Optional parameter that tells the renderer whether or not to use the cache to fetch the tile |
| format | Optional parameter representing the resulting image format. Valid values are JPG, JPEG and PNG |
| quality | Optional quality parameter used only for the jpeg format |
| postGamma | Optional gamma value to apply as post processing |
| brightness | Optional brightness value to apply as post processing |
| contrast | Optional constast value to apply as post processing |
Returns A file stream that contains the rendered region
Region
/region Renders a region of the specified WSI
| Parameter | Description |
| sessionID | The session id to authenticate with |
| pathOrUid | The path or unique identifier of the image to render |
| timeframe | The index of the time frame to render |
| layer | The index of the layer to render |
| channels | The channels to render |
| x | The x coordinate of the image to render |
| y | The y coordinate of the image to render |
| width | The width of the region to render |
| height | The height of the region to render |
| 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. |
| gamma | Gamma values for each channgel. One value required per channel |
| drawScaleBar | Draw an accurate scale bar? |
| downloadInsteadOfDisplay | download Instead Of Display |
| drawFilename | 0 do not draw , 1 draw filename on top, 2 draw on bottom |
| format | Optional parameter representing the resulting image format. Valid values are JPG, JPEG and PNG |
| quality | Optional quality parameter used only for the jpeg format |
| annotationsLayerType | A comma seperated list of extra annotations layer to render |
| rotation | Rotation angle in degrees |
| flipHorizontal | Whether to flip region horizontaly |
| flipVertical | Whether to flip the region verticaly |
| dpi | Optional dpi to resolution for the exported image |
| postGamma | Optional gamma value to apply as post processing |
| brightness | Optional brightness value to apply as post processing |
| contrast | Optional constast value to apply as post processing |
Returns A file stream that contains the rendered region
Thumbnail
/thumbnail Renders the associated thumbnail of a WSI
| Parameter | Description |
| sessionID | The session id to authenticate with |
| pathOrUid | The path or unique identifier of the image to render |
| orientation | The orientation of the thumbnail (0 = auto; 1 = vertical; 2 = horizontal) |
| w | Expected output width of the thumbnail |
| h | Expected output height of the thumbnail |
Returns An image
Macro
/macro Renders the associated macro of a WSI
| Parameter | Description |
| sessionID | The session id to authenticate with |
| pathOrUid | The path or unique identifier of the image to render |
| orientation | The orientation of the macro(0 = auto; 1 = vertical; 2 = horizontal) |
| w | Expected output width of the macro |
| h | Expected output height of the macro |
Returns An image
Barcode
/barcode Renders the associated barcode of a WSI
| Parameter | Description |
| sessionID | The session id to authenticate with |
| pathOrUid | The path or unique identifier of the image to render |
| orientation | The orientation of the barcode(0 = auto; 1 = vertical; 2 = horizontal) |
| w | Expected output width of the barcode |
| h | Expected output height of the barcode |
Returns An image
nonapi.1658998328.txt.gz · Last modified: 2022/07/28 11:52 by antreas
