createVignetPublishFormat

ビネット用の新しい公開形式を作成します。

ビネット形式は、公開済みビネットとそのサムネールのサイズ、ズームレベル、シャープパラメータ、IPS から Image Rendering Server に公開されたプライマリビネットから作成されたビネットのファイル形式バージョンを指定します。

新しい Image Rendering Server バージョンでは、ピラミッドビネットをサポートできるので、公開用に特定のビネット形式のサイズを定義する必要がなくなりました。

認証済みユーザータイプ

IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
ImagePortalAdmin

パラメータ

入力 (createVignettePublishFormatParam)

名前	種類	必須	説明
companyHandle	xsd:string	はい	ビネットが属する会社を処理します。
名前	コードフレーズ	はい	ビネット公開形式を識別する名前です。
targetWidth	コードフレーズ	はい	生成されるビネット表示のターゲット幅をピクセル単位で指定します。出力ビネットのサイズがプライマリビネットと同じになるように、ゼロを使用します。
targetHeight	コードフレーズ	はい	画像レンダリングサーバでのズーム処理に最適なピラミッドビネットを作成します。このオプションでは、1 つのビネット出力ファイルで複数サイズの表示を作成します。ターゲットビネットサイズフィールドで設定された最大サイズから作成を開始します。表示のサイズは、幅と高さが 128x128 ピクセル以内になるまで、1/2 ずつ縮小されます。
createPyramid	コードフレーズ	はい	生成される各サムネールの幅をピクセル単位で指定します。この設定はオプションです。サムネールファイルを使用しない場合はゼロのままにします。
thumbWidth	コードフレーズ	はい	公開したビネットのファイル形式を指定します。新しいバージョンの画像オーサリングと古いバージョンの画像レンダリングサーバーを指定する場合、ImageRendering Server が読み取ることのできるビネットバージョンを指定する必要があります。より高いバージョンを指定した場合、画像レンダリングサーバは公開済みビネットを読み取れません。最新バージョンのビネットを公開するには、0 に設定します。
saveAsVersion	コードフレーズ	はい	ビネット名と幅を示すサフィックスを区切る文字を指定します。
sizeSuffixSeparator	コードフレーズ	はい	ビネット名と幅を示すサフィックスを区切る文字を指定します。
鋭くする	コードフレーズ	いいえ	メイン表示画像に対してシャープを適用し、各画像サイズに対してシャープを適用します。シャープを適用すると、ビネッターを拡大・縮小したときにぼかしを補正できます。
usmAmount	コードフレーズ	はい	デジタルアンシャープマスクは、特にスキャンされた画像でシャープネスを高める柔軟で強力な方法です。これは、各オーバーシュートの大きさ（エッジ境界がどれだけ暗く、ライトになるか）を制御します。
usmRadius	コードフレーズ	はい	拡張するエッジのサイズやエッジリムの幅に影響を与えます。したがって、小さいラジウムは小さいスケールの詳細を高めます。半径の値を大きくすると、エッジにハローが発生する場合があります。細かい詳細は、同じサイズの小さな詳細と同じか、半径より小さい細かい詳細が失われるので、小さい半径を必要とします。
usmThreshold	コードフレーズ	はい	シャープにする最小の明るさの変化、または隣接する階調値の間隔を、フィルターが機能する前にどの程度制御します。この設定により、より回転するエッジをよりシャープにし、より繊細なエッジは手を付けずに残すことができます。しきい値の許容範囲は 0～255 です。

出力 (createVignettePublishFormatReturn)

名前	種類	必須	説明
vignetFormatHandle	`xsd:string`	はい	作成したビネット形式のハンドル。

例

このコードはビネット公開形式を作成します。作成リクエストでは、名前、ターゲットの幅と高さ、およびその他の必須値を指定します。

リクエスト

<createVignettePublishFormatParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <name>APIcreateVignettePublishFormat1</name>
   <targetWidth>1200</<targetWidth>
   <targetHeight>800</targetHeight>
   <createPyramid>true</createPyramid>
   <thumbWidth>400</thumbWidth>
   <saveAsVersion>0</saveAsVersion>
   <sizeSuffixSeparator>-</sizeSuffixSeparator>
   <sharpen>50</sharpen>
   <usmAmount>230.0</usmAmount>
   <usmRadius>1.1</usmRadius>
   <usmThreshold>130</usmThreshold>
</createVignettePublishFormatParam>

応答

<createVignettePublishFormatReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <vignetteFormatHandle>v|21|282</vignetteFormatHandle>
</createVignettePublishFormatReturn>