メインコンテンツまでスキップ
バージョン: 20 R7 BETA

CONVERT PICTURE

CONVERT PICTURE ( picture ; codec {; compression} )

引数説明
picturePicture変換するピクチャ
変換されたピクチャ
codecTextピクチャCodec ID
compressionReal圧縮の品質

説明

CONVERT PICTURE コマンドはpictureを新しいタイプに変換します。引数で生成するピクチャのタイプを指定します。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) が適用されます。

注: CONVERT PICTURE を、64-bit 版4D ではサポートされていないタイプのピクチャー(PICT など)に使用したい場合、変換は、オリジナルのタイプがサポートされている32-bit 版の4D で実行するようにしてください。詳細な情報については、32-bit版から64-bit版への移行 のページを参照してください。

例題 1

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

 CONVERT PICTURE(vpPhoto;".jpg")

例題 2

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

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

参照

PICTURE CODEC LIST

プロパティ

コマンド番号1002
スレッドセーフである