LoadAsync(流,对象)的方法

总结

使用默认选项异步加载指定的图像流。

语法

objective - c

c++

Java

公共RasterImageLoadAsync (流流，对象userState）

公共过载函数LoadAsync (_按值传递流作为流,_按值传递userState作为对象＿）作为RasterImage

- (无效) loadStreamAsync: (LTLeadStream *)流完成:无效(^)(LTRasterImage * __nullable image, NSError * __nullable error))完成

公共对象loadAsync (ILeadStream流、对象userState）

公共：RasterImage ^LoadAsync (流^流，对象^userState）

参数

流
包含要加载的图像数据的流。

userState
一个用户定义的对象，在异步操作完成时传递给调用的方法。

返回值

的RasterImage此方法加载的对象。该对象的用法见备注。

讲话

请注意:本课题是RasterCodecs使用.NET提供异步支持System.ComponentMode.AsyncOperation模型。为。net异步/等待,使用任务 LoadAsync(ILeadStream stream)．

流可以指向任何支持的图像文件格式和每像素位，无论是压缩还是未压缩。

此方法将加载多页文件中的所有页。生成的图像将具有与流中存储的图像相同的位/像素和颜色顺序值。

LEADTOOLS将尝试加载损坏的文件，以便您至少可以看到图像的一部分。对于这些图像，加载方法成功，但是LoadStatus将返回错误代码。

使用CodecsLoadOptions类在调用此方法之前设置其他加载选项参数。

对12位和16位灰度图像的支持仅在文档/医学影像版本。

有关支持的格式，请参见所有支持的文件格式摘要．

LEADTOOLS将所有PDF文件加载为未压缩的光栅PDFRasterImageFormat。RasPdf，而不考虑保存文件时使用的压缩和颜色空间。

的RasterCodecs类支持异步加载图像文件LoadAsync方法。调用这些方法时，调用方线程将不会被阻塞，并且该方法将立即返回RasterImage处于加载状态(RasterImage。IsLoading设置为真正的)．当对象处于加载状态时，不应使用此对象的其他属性。

当RasterCodecs对象加载完成后，图像的各种属性RasterImage将填充图像信息和数据和RasterImage。IsLoading属性将设置为假．

不要投票RasterImage。IsLoading属性确定图像是否已完成加载。相反，请订阅LoadAsyncCompleted事件时获取通知LoadAsync操作是否完成以及是否发生错误。

的LoadAsyncCompleted事件数据也将包含返回的相同对象LoadAsync因此，您不必在应用程序中保留原始对象。

的CodecsLoadOptions。AllPages属性控制是否RasterCodecs将尝试加载所有页面，如果图像数据包含多个页面，则仅加载第一页。要加载单个页面，请使用LoadAsync(流，int pageNumber，对象userState)．

例子

使用Leadtools;使用Leadtools.Codecs;使用Leadtools.ImageProcessing;使用Leadtools.ImageProcessing.Color;使用Leadtools.Svg;公共无效LoadAsyncStream1Example ()｛字符串srcFileName = Path.Combine(LEAD_VARS.ImagesDir，“Image1.cmp”）;RasterCodecs codecs =新RasterCodecs ();//现在异步加载图像编解码器。LoadAsyncCompleted + =新EventHandler < CodecsLoadAsyncCompletedEventArgs > (LoadAsyncStream1Example_LoadAsyncCompleted);Stream = File.OpenRead(srcFileName);对象rasterImageObject =编解码器。LoadAsync(流,零）;//注意返回的rasterImageObject是一个IsLoading设置为true的RasterImage//当loadasynccompleted完成时，IsLoading将为false(因此，对象将可用)/ /火灾。｝私人无效LoadAsyncStream1Example_LoadAsyncCompleted (对象发件人，CodecsLoadAsyncCompletedEventArgs｛如果(e.Cancelled)｛控制台。WriteLine (“用户取消了”）;｝其他的如果(e.Error ! =零）｛控制台。WriteLine (错误:“+ e.Error.Message);｝其他的｛//一切正常，获取图像RasterImage image = e.Image;控制台。WriteLine ("图像已加载，大小:{0}by {1}",形象。宽度,image.Height);image.Dispose ();｝//我们应该在这里关闭流e.Stream.Dispose ();//取消订阅事件并释放RasterCodecs对象RasterCodecs codecs =发送者作为RasterCodecs;编解码器。LoadAsyncCompleted - =新EventHandler < CodecsLoadAsyncCompletedEventArgs > (LoadAsyncStream1Example_LoadAsyncCompleted);codecs.Dispose ();｝静态类LEAD_VARS｛公共常量字符串ImagesDir =@“C: \ LEADTOOLS21 \ Resources \图片”；｝

需求

目标平台

另请参阅

参考

加载和保存大TIFF / BigTIFF文件

加速1位文档

快速文件信息

下载我们的免费评估

帮助版本21.0.2021.7.2