ImageLoaders 加载图像

ImageLoader是一个Javascript插件,它负责获取图像的ImageId并将相应的图像像素数据返回给cornerstone。由于加载图像通常需要调用服务器,因此加载图像的API必须是异步的。Javascript处理异步操作的趋势是通过由许多库实现的 Promises/A+ 规范 。有关promise /A+库的信息,请参阅本页。因此,Cornerstone将假定,图像加载程序返回一个承诺,Cornerstone将使用该承诺异步接收像素数据,如果出现错误,则返回一个错误。Cornerstone不需要任何特定的promise库,它应该与任何符合Promises/A+ 规范的库(以及不能100%兼容的jQuery)一起工作。下面是一个图像加载器的例子,它使用XMLHttpRequest获取像素数据,并使用jQuery向cornerstone:

function loadImage(imageId) { // create a deferred object var deferred = $.Deferred(); // Make the request for the DICOM data var oReq = new XMLHttpRequest(); oReq.open("get", imageId, true); oReq.responseType = "arraybuffer"; oReq.onreadystatechange = function(oEvent) { if (oReq.readyState === 4) { if (oReq.status == 200) { // request succeeded, create an image object and resolve the deferred // Code to parse the response and return an image object omitted..... var image = createImageObject(oReq.response); // return the image object by resolving the deferred deferred.resolve(image); } else { // an error occurred, return an object describing the error by rejecting // the deferred deferred.reject({error: oReq.statusText}); } } }; oReq.send(); // return the pending deferred object to cornerstone so it can setup callbacks to be // invoked asynchronously for the success/resolve and failure/reject scenarios. return deferred; }

图像加载器负责在解析承诺时将与ImageId基石传递相对应的Image object 图像对象返回给它的loadImage函数。图像加载器使用registerImageLoader() API为给定的URL方案注册自己:
// 用我们的loadImage函数注册url模式“myCustomLoader” cornerstone.registerImageLoader('myCustomLoader', loadImage);

一般流程:
  • ImageLoaders通过cornerstone注册自己来加载特定的ImageId URL方案
  • 应用程序请求使用loadImage() api加载图像。Cornerstone把ImageLoader注册的imageId传送给loadImage()
  • ImageLoader将返回一个承诺,一旦获得像素数据,它将与相应的图像对象解析该承诺。获取像素数据可能需要使用XMLHTTPRequest调用远程服务器,对像素数据进行解压缩(例如jpeg 2000),并将像素数据转换为cornerstone能够理解的格式(例如RGB vs YBR)。
    虽然像素数据通常是从服务器获得的,但事实并非总是如此。实际的例子实际上使用了ImageLoader插件来提供图片,而根本不需要服务器。在本例中,图像是base64编码并存储在ImageLoader插件本身中。这个插件只是把base64像素的数据转换成一个像素数组。或者,可以编写一个映像加载器,在客户端生成派生的映像。例如,您可以通过这种方式实现MPR功能。
【ImageLoaders 加载图像】可用考虑使用 cornerstone WADO 图像加载器或 cornerstone Web图像加载器。在不久的将来也有望提供一个WADO-RS图像加载器。

    推荐阅读