メディア処理

画像変換タスク

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

画像変換タスクは、画像またはドキュメントを別の画像に変換するために使用します。

さまざまな設定を適用して、最終的な変換の設定を定義することができます。

パラメーター	型	説明	必須	既定
input	文字列	ソースファイルのキーを見つけるプロパティの名前。
output	文字列	出力ファイルのキーを渡すプロパティの名前。	はい
outputfileprovider	文字列	出力ファイルを渡すファイルプロバイダーの名前。	はい
multipage	Boolean	入力のドキュメントに複数のページがあるかどうかを指定します。	ありません	false
imagemagickexecutabletimeout	int	ImageMagick アプリケーションのタイムアウト (秒)。 ImageMagick アプリケーションのタイムアウトは、最大で 120 秒まで設定できます。
imagemagickidentifyexecutabletimeout	Identify アプリケーション (ImageMagick のサブアプリ) のタイムアウト (秒)。
targetextension	文字列	出力ファイルのファイル拡張子。	ありません	ソースファイルの拡張子
clippingpath	文字列	複数のパスがある場合の 8BIM 画像プロファイルの埋め込みクリッピングパスの ID 名。これにより、指定したパスで選択されているピクセルにのみ操作が適用されます。	クリッピングパスが設定されている場合は、追加の変換パラメーターは無視されることに注意してください。	ありません
density	int	ImageMagick の密度のパラメーター。	ありません
conversionparameter	文字列	ImageMagick に使用するいくつかの追加のパラメーター。	ありません	"-alpha remove -strip -background white -auto-orient"
conversionparameterorder	文字列	ImageMagick のパラメーターの順番。	ありません	"{input} {density} {colorspace} {resize} {quality} {extraparameters}"
colorspace	文字列	変換に使用する色空間。	ありません	Identify から返される色空間
jpegcompression	int	jpeg 画像の圧縮率を 1 から 100 で定義する値。	ありません
imageresizeoption	enum	どのような画像のサイズ変更を行う必要があるかを指定するオプション。使用可能なオプション: DoNotResize、IngoreAspectRatio、OnlyShrinkLargerImages、OnlyEnlargeSmallerImages	ありません	DoNotResize
height	int	サイズ変更を行う場合の高さ。	ありません	元のソースの高さ
width	int	サイズ変更を行う場合の幅。	ありません	元のソースの幅
resizeforcropbehavior	enum	画像をトリミングしようとする場合に、画像を実際にトリミングする必要があるか、拡大縮小するだけでよいかを決定するオプション。使用可能なオプション: Default、ForceCropping、ForceScaling。 Default では、アプリケーションが画像がロゴであることを検出した場合は拡大縮小されます。それ以外の場合は、トリミングされます。	ありません	Default
resizelogoscalefactor	double	画像をトリミングしようとするときに、アプリケーションが代わりに画像を拡大縮小することを選択した場合の拡大縮小率を定義します。	ありません	0.75
embeddedPreviewPriorities	文字列	埋め込みプレビューのラベルのコンマ区切りリスト。処理エージェントは、それらを指定された順番で抽出します。指定されていない場合は、既定の変換が行われます。	ありません	null

設定例

画像変換タスクをメディアマトリックスで設定して、どのタイプのファイルを画像に変換できるかを定義できます。設定の例を以下に示します。

{
    "type": "ConvertImage",
    "imageresizeoption": "OnlyShrinkLargerImages",
    "width": 800,
    "height": 600,
    "density": 72,
    "colorspace": "sRGB",
    "targetextension": "jpg",
    "input": "source",
    "output": "preview",
    "outputproperties": {
        "width": "preview_width",
        "height": "preview_height"
    },
    "outputfileprovider": "local",
    "contenttype": "image/jpeg",
    "contentdisposition": "inline",
    "resizelogoscalefactor":0.5,
    "resizeforcropbehavior":"ForceScaling"
}

埋め込みプレビューの動作

[埋め込みプレビューの優先順位] ラベルは、コンマ区切りリストで入力する必要があります。これがタスクで定義されている場合、処理エージェントは指定された順番に従ってそれらのプレビューが使用可能かどうかを確認します。プレビューがある場合は、そのプレビューが抽出され、既定の画像変換が行われて対象の画像が生成されます。要求されているプレビューがない場合は、既定の変換が元の画像に適用されます。

RAW 画像には、処理が最小限のデータが含まれています。 RAW コンバーターは、RAW 画像の色空間を変換して、保管、出力、さらなる操作のために TIFF や JPEG などのポジティブのファイル形式に変換する前に細かい調整を行うことができます。

RAW ファイルのメタデータ

RAW ファイルには、表示可能な画像を生成するために必要なメタデータと情報が含まれています。 RAW データの構造は、通常、次のような一定の形式に従っています。

ファイルの短いヘッダー。これには、通常、ファイルのバイトオーダーのインジケーター、ファイルの識別子、プライマリファイルのデータのオフセットが含まれます。
カメラのセンサーのメタデータ。これは、センサーのサイズ、CFA の属性、そのカラープロファイルなど、センサーの画像データを解釈するために必要です。
画像のメタデータを抽出して、任意の CMS データベースに含めることができます。これには、露出の設定、カメラ/スキャナー/レンズのモデル、撮影/スキャンの日付 (および任意で場所)、オーサリング情報などがあります。 RAW ファイルには、多くの場合、EXIF で標準化されているメタデータのセクションを含めることができます。
画像のサムネイル。ほとんどの RAW ファイルには、フルサイズの JPEG 変換画像が含まれています。これは、カメラの LCD パネルなどでファイルをプレビューするために使用されます。

ExifTool

RAW 画像で使用できるサムネイルを確認する最も簡単な方法は、Exiftool を使用することです。 ExifTool は、画像、音声、動画、PDF のメタデータの読み取り、書き込み、操作を行うための無料のオープンソースソフトウェアプログラムです。プラットフォームに依存せず、Perl ライブラリまたはコマンドラインアプリケーションとして使用できます。

RAW 画像で使用できるプレビューを確認するには、次のコマンドを実行します。

exiftool -preview:all <image>

出力は次の例のようになります。

exiftool -preview:all RAW_CANON_EOS_5DMARK3.CR2
Preview Image                   : (Binary data 3192436 bytes, use -b option to extract)
Thumbnail Image                 : (Binary data 18733 bytes, use -b option to extract)

これらのプレビューを RAW 画像から [埋め込みプレビューの優先順位] フィールドに追加するには、追加するタグの名前をスペースなしで入力します。この場合は、PreviewImage と ThumbnailImage が有効なラベルになります。

この記事を改善するための提案がある場合は、お知らせください!