nonapi
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
nonapi [2022/09/20 17:18] antreas |
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 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.1663683519.txt.gz ยท Last modified: 2022/09/20 17:18 by antreas
