LEADTOOLS Leadtools.Documents(Leadtools.Documentsアセンブリ)

フレームを表示

MaximumImagePixelSizeプロパティ(DocumentImages)






このドキュメントにおけるページから画像データを得るとき、ピクセル単位で使う最大幅または高さ。
構文
public int MaximumImagePixelSize {get; set;}
'Declaration
 
Public Property MaximumImagePixelSize As Integer
'Usage
 
Dim instance As DocumentImages
Dim value As Integer
 
instance.MaximumImagePixelSize = value
 
value = instance.MaximumImagePixelSize
public int getMaximumImagePixelSize()
public void setMaximumImagePixelSize(int value)
            
public:
property int MaximumImagePixelSize {
   int get();
   void set (    int value);
}

属性値

このドキュメントにおけるページから画像データを得るとき、ピクセル単位で使う最大幅または高さ。デフォルト値は0で、これはオリジナルサイズを使うという意味です。
解説

DocumentPage.GetImageDocumentPage.GetSvgDocumentPage.GetSvgBackImageメソッドは、ドキュメントにおけるページのラスターまたはSVGドキュメント表現を得るのに用いられます。MaximumImagePixelSizeの値が0(デフォルト)であるとき、imageまたはSVGオブジェクトの戻り値はページのサイズと同じになります。

オリジナルドキュメントのピクセルサイズが大きい場合は、望ましい動作ではありません。たとえば、ドキュメントライブラリがメモリサイズが制限される自動車用途により用いられるならば。返される画像の最大サイズを制限すると、あらゆる種類のアプリケーションのパフォーマンスが向上します。ドキュメントとアプリケーションの間でやりとりされるデータサイズは小さくなり、そのため取得も描画も速くなります。

imageとSVGオブジェクトの最大サイズを制限するために、MaximumImagePixelSizeの値を目的のピクセルサイズに設定します。その後、GetImageGetSvgまたはGetSvgBackImageを呼び出すと、ラスター画像またはSVG画像は幅や高さが最大MaximumImagePixelSizeとなります。アスペクト比を維持しつつ、これが取得されているときのそのままデータをサイズ変更することでこの操作を実行します。

サンプル:ページは、8.5×11インチ(DocumentPage.Sizeは6120×7920です)のサイズを持っています。300の一般的な解像度のピクセルサイズは、2550×3300です。

GetImageを0のデフォルトに設定されるMaximumImagePixelSizeの値を指定して呼び出すことは、再サイズ設定なしに終わります。この、得られるimageオブジェクトは、2550×3300のピクセルのサイズを持っています。使われるscale値は、1.0です。

MaximumImagePixelSizeの値が1024に設定されると、画像は返される前にサイズ変更され792×1024ピクセルのサイズになります。これは、アスペクト比を保持している間、許可する最大限へのオリジナルのサイズで最も良好ものとして計算されます。使われるscale値は、3.223です。

しかし、MaximumImagePixelSizeの値が4096に設定されるならば、オリジナルのサイズが最大値の中に合わせるため、imageは大きさを変更されません。使われるscale値は、1.0です。

全ての場合において、使われるscale値は、DocumentPage.ImageScaleで設定されます。この値を使って、画像を拡大縮小するかどうかを決定し、生成される画像のピクセルとページ単位の間の座標変換を伴う計算に使用できます。LEADTOOLSドキュメントビューワは、画像ビューワコントロールにおけるページのために、各項目のimage scaleで、この値を設定します。

上記と同じ動作は、GetSvg(結果SVGドキュメントは大きさを変更されます)とGetSvgBackImageでも発生します。ページは、通常いつでも1つのImageScaleを持っています。

必要条件

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

参照

参照

DocumentImagesクラス
DocumentImagesメンバ

   Leadtools.Documentsは、DocumentまたはMedicalツールキットのライセンスと、解除キーが必要です。詳細は、以下を参照してください。LEADTOOLSツールキット機能