LEADTOOLS画像ファイルサポート(Leadtools.Codecsアセンブリ)

フレームを表示

LoadAsync(ウーリ、Object)メソッド








入力イメージデータを格納しているウーリ
非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義オブジェクト。
非同期で省略時のオプションを用いて指定されたimage URLをロードします。
構文
public RasterImage LoadAsync( 
   Uri uri,
   object userState
)
'Declaration
 
Public Overloads Function LoadAsync( _
   ByVal uri As Uri, _
   ByVal userState As Object _
) As RasterImage
'Usage
 
Dim instance As RasterCodecs
Dim uri As Uri
Dim userState As Object
Dim value As RasterImage
 
value = instance.LoadAsync(uri, userState)
public RasterImage LoadAsync( 
   Uri uri,
   object userState
)
 function Leadtools.Codecs.RasterCodecs.LoadAsync(Uri,Object)( 
   uri ,
   userState 
)
public:
RasterImage^ LoadAsync( 
   Uri^ uri,
   Object^ userState
) 

パラメーター

uri
入力イメージデータを格納しているウーリ
userState
非同期操作の完了時に呼び出されるメソッドに渡されるユーザー定義オブジェクト。

戻り値

このメソッドがロードするRasterImageオブジェクト。これの使用法オブジェクトを意見を参照します。
解説

ファイルは、圧縮または未圧縮の、サポートされている任意の画像形式とビット数です。

このメソッドは、マルチページファイルにおけるすべてのページをロードします。それがファイルで保存されたので、結果として生じるimageはimageの同じビット/ピクセルとカラーオーダー値を持っています。

LEADTOOLSは破損したファイルをロードしようとするので、少なくとも一部のimageを参照することができます。こうした画像の場合、ロードメソッドは成功しますが、LoadStatusはエラーコードを返します。

このメソッドを呼び出す前にそのほかのロードオプションパラメーターをセットアップするにはCodecsLoadOptionsクラスを使用します。

12と16ビットグレースケールイメージのサポートは、Document/Medicalイメージングエディションのみで利用できます。

サポートされている形式については、「利用可能な画像ファイル形式一連」を参照してください。

ファイルの保存時に使用した圧縮やカラースペースとは関係なく、すべてのPDFファイルをラスターPDFの未圧縮RasterImageFormat.RasPdfとしてロードします。

LEADTOOLSは、以下のURI計画をサポートします:
仕組み 説明
UriSchemeFile URIがローカルマシンまたは一般的な命名規約(UNC)パスのディスクファイルであることを示しています。
UriSchemeHttp URIがハイパーテキストトランスファープロトコル(HTTP)を通してアクセスされることを示しています。
UriSchemeHttps URIがセキュアなハイパーテキストトランスファープロトコル(HTTPS)を通してアクセスされることを示しています。
UriSchemeFtp URIがファイル転送プロトコル(FTP)を通してアクセスされることを示しています。

uriUriSchemeHttpUriSchemeHttpsまたはUriSchemeFtpで資源をポイントするならば、このRasterCodecsは一時バッファを作成することによって反復やり方で画像データをダウンロードしようとします。このバッファのサイズは、このメソッドを呼び出す前にUriOperationBufferSizeを準備することによって決定されることができて、変更されることができます。

確実性とプロキシ設定のために、UriOperationCredentialsUriOperationProxyを参照します。

RasterCodecsクラスは、LoadAsyncメソッドを用いて非同期でロード画像ファイルをサポートします。これらのいずれかのメソッドを呼び出すと、コーラースレッドはブロックされ、ロード状態にあるインスタンスRasterImageのでただちに返されます(RasterImage.IsLoadingをtrueに設定)。オブジェクトがロード状態にある間は、このオブジェクトのその他のプロパティは使用してはなりません。

RasterCodecsオブジェクトがimageをロードするを完了するとき、RasterImageのいろいろなプロパティは画像情報で値を入力されます、そして、データとRasterImage.IsLoadingプロパティはfalseに設定されます。

画像のロードが完了したかどうかを判断するためにRasterImage.IsLoadingプロパティをポーリングすることは避けてください。代わりに、通知を取得するために、LoadAsyncCompletedイベントに、LoadAsync操作が完了したとき、そして、任意のエラーが発生したかどうかにかかわらず、サブスクライブします。

LoadAsyncCompletedイベントデータにはLoadAsyncから返されたものと同じオブジェクトも含まれます。このためアプリケーション内にオリジナルのオブジェクトを保持しておく必要はありません。

CodecsLoadOptions.AllPagesプロパティは、画像データが複数ページを格納するならば、RasterCodecsがすべてのページかまさにその最初のページをロードしようとするかどうか制御します。単一のページをロードするために、LoadAsync(ウーリuri、int pageNumber、オブジェクトuserState)を使います。

サンプル
サンプルのために、参照しますLoadAsyncCompleted
必要条件

ターゲットプラットホーム

参照

参照

RasterCodecsクラス
RasterCodecsメンバ
オーバーロードリスト
イメージのロードと保存
大きなTIFF/BigTIFFファイルのロードと保存
1ビット画像処理の高速化
高速ファイル情報