4D Doc Center : CONVERT PICTURE

4D v14.3

CONVERT PICTURE


CONVERT PICTURE ( picture ; codec {; compression} )

引数	型	説明
picture	ピクチャー	変換するピクチャ
		変換されたピクチャ
codec	文字	ピクチャCodec ID
compression	実数	圧縮の品質

説明

CONVERT PICTURE コマンドはpictureを新しいタイプに変換します。

codec 引数で生成するピクチャのタイプを指定します。Codecには拡張子 (例 “.gif”), またはMimeタイプ(例 “image/jpeg”)が使用できます。利用可能なCodecのリストは PICTURE CODEC LIST コマンドを使用して取得できます。

picture フィールドや変数が複合型 (例えばコピー/ペーストアクションの結果のピクチャ) の場合、codecタイプに対応する情報のみが結果ピクチャに保持されます。

Note: リクエストされた codec のタイプがpictureの元のタイプと同じ場合、変換は実行されず、そのままのピクチャが返されます (compression引数が使用された場合を除く、後述参照)。

オプションのcompression引数が渡されると、互換性のあるCODEC利用時に、結果のピクチャに適用する圧縮品質を指定できます。compressionには圧縮品質を指定する0から1の間の値を渡します。0が圧縮優先で1が品質優先です。この引数はCODECが圧縮をサポートし (例えばJPEGやHDPhoto)、さらにWICやImageIO APIによりサポートされている場合にのみ考慮されます。ピクチャ管理APIに関する詳細情報は、ピクチャを参照してください。compression引数を省略するとデフォルトで品質優先 (compression =1) が適用されます。

例題 1

vpPhoto ピクチャをjpegフォーマットに変換:

CONVERT PICTURE(vpPhoto;".jpg")

例題 2

60%の品質でピクチャを変換:

CONVERT PICTURE(vPicture;".JPG";0.6)