ImageClip.GetScaledDownImage

導入

v4.0

詳細

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

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

スクリプト 構文

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 ) ;