User Tools

Site Tools


nonapi

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.

Tile

/tile Renders a square tile of a slide

Parameter Description
sessionIDThe session id to authenticate with
pathOrUidThe path or unique identifier of the image to render or a valid collection config JSON
timeframeThe index of the time frame to render
layerThe index of the layer to render
channelsComma separated channel indexes to render
channelClippingMin and max limits to clip and scale pixel values. Two values required per channel
gammaGamma values for each channel. One value required per channel
xThe x index of the tile
yThe y index of the tile
zThe z index of the tile
cacheOptional parameter that tells the renderer whether or not to use the cache to fetch the tile
formatOptional resulting image format. Valid values are JPG, JPEG and PNG
qualityOptional quality parameter used only for the jpeg format
postGammaOptional gamma value to apply as post processing
brightnessOptional brightness value to apply as post processing
contrastOptional contrast value to apply as post processing

Returns A file stream that contains the rendered region

Region

/region Renders a region of a slide

Parameter Description
sessionIDThe session id to authenticate with
pathOrUidThe path or unique identifier of the image to render
timeframeThe index of the time frame to render
layerThe index of the layer to render
channelsComma separated channel indexes to render
xThe x coordinate of the image to render
yThe y coordinate of the image to render
widthThe width of the region to render
heightThe height of the region to render
scaleThe factor to scale the rendered region by
channelClippingMin and max limits to clip and scale pixel values. Two values required per channel.
gammaGamma values for each channel. One value required per channel
drawScaleBarDraw an accurate scale bar
downloadInsteadOfDisplayWhether or not to download the image or display it in the browser
drawFilename0 do not draw, 1 draw filename on top, 2 draw on bottom
formatOptional parameter representing the resulting image format. Valid values are JPG, JPEG and PNG
qualityOptional quality parameter used only for the jpeg format
annotationsLayerTypeA comma separated list of extra annotations layer to render
rotationRotation angle in degrees
flipHorizontalWhether to flip region horizontally
flipVerticalWhether to flip the region vertically
dpiOptional dpi to resolution for the exported image
postGammaOptional gamma value to apply as post processing
brightnessOptional brightness value to apply as post processing
contrastOptional contrast value to apply as post processing

Returns A file stream that contains the rendered region

Thumbnail

/thumbnail Renders the associated thumbnail of slide

Parameter Description
sessionIDThe session id to authenticate with
pathOrUidThe path or unique identifier of the image to render
orientationThe orientation of the thumbnail (0 = auto; 1 = vertical; 2 = horizontal)
wExpected output width of the thumbnail
hExpected output height of the thumbnail

Returns An image

Macro

/macro Renders the associated macro of a slide

Parameter Description
sessionIDThe session id to authenticate with
pathOrUidThe path or unique identifier of the image to render
orientationThe orientation of the macro (0 = auto; 1 = vertical; 2 = horizontal)
wExpected output width of the macro
hExpected output height of the macro

Returns An image

Barcode

/barcode Renders the associated barcode of a slide

Parameter Description
sessionIDThe session id to authenticate with
pathOrUidThe path or unique identifier of the image to render
orientationThe orientation of the barcode (0 = auto; 1 = vertical; 2 = horizontal)
wExpected output width of the barcode
hExpected output height of the barcode

Returns An image

nonapi.txt · Last modified: 2022/07/28 13:00 by yves