ImageClip.GetScaledDownImage

導入

v4.0

詳細

このメソッドは ImageClip.GetImage とほぼ同じですが、イメージの縮小バージョンを戻すという点が異なります。ソースイメージが非常に大きい場合、フル解像度の必要がなければ（たとえば、サムネイルを生成する場合など）、このメソッドを使用するとパフォーマンスが大幅に向上します。

注: この呼び出しの結果には、ユーザプリファレンス preferences.rendering.maximum_proxy_level およびpreferences.rendering.minimum_proxy_size が影響することがあります。戻されたイメージが要求よりも大きくなる場合があります。

C#構文

Image ImageClip.GetScaledDownImage( siImageRatio in_Ratio, Object in_vFrame );

スクリプト構文

oReturn = ImageClip.GetScaledDownImage( Ratio, [Variant] );

戻り値

Image

パラメータ

パラメータ タイプ 説明
割合 siImageRatio イメージの縮小率を定義する値
Variant Variant イメージを取得するフレーム。ImageClip がイメージシーケンスまたはムービーファイルを表している場合は、このパラメータが非常に重要になります。

デフォルト値: ImageClip インスタンスの作成時のプレイ カーソルに対応するフレーム。

例

JScript の例

var factoryImages = Application.InstallationPath(siFactoryPath) + 

			"/Data/XSI_SAMPLES/Pictures/"	

	var strImagePath = factoryImages + "jio.jpg" ;

	var oImageClip = CreateImageClip( strImagePath, "ScalingClip" ) ;

	var oImage = oImageClip.GetScaledDownImage( siImageRatio1x1 ) ;

	LogMessage( "Full res image is " + oImage.ResX + "x" + oImage.ResY ) ;

	oClip = oImageClip.GetScaledDownImage( siImageRatio2x1 ) ;

	LogMessage( "2:1 image is " + oImage.ResX + "x" + oImage.ResY ) ;

	oClip = oImageClip.GetScaledDownImage( siImageRatio4x1 ) ;

	LogMessage( "4:1 image is " + oImage.ResX + "x" + oImage.ResY ) ;

	oClip = oImageClip.GetScaledDownImage( siImageRatio8x1 ) ;

	LogMessage( "8:1 image is " + oImage.ResX + "x" + oImage.ResY ) ;

	oClip = oImageClip.GetScaledDownImage( siImageRatio16x1 ) ;

	LogMessage( "16:1 image is " + oImage.ResX + "x" + oImage.ResY ) ;

	oClip = oImageClip.GetScaledDownImage( siImageRatioThumbnail ) ;

	LogMessage( "Thumbnail image is " + oImage.ResX + "x" + oImage.ResY ) ;