ドキュメントDynamic Media Image Production System API

createVignettePublishFormat createvignettepublishformat

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者
  • 管理者

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

ビネット形式は、公開するビネットとそのサムネールのサイズ、ズームレベル、シャープニングパラメーター、IPS から画像レンダリングサーバーに公開したプライマリビネットから生成されるビネットのファイルフォーマットバージョンを指定します。

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

許可されているユーザータイプ section-f5c563e3695c4dba8df41e2a965aace7

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

パラメーター section-3a368186ec1d4005bca056fc9d9bacc7

入力（createVignettePublishFormatParam）

名前
種類
必須
説明
companyHandle
xsd:string
はい
ビネットが所属する会社のハンドル。
の名前
のコードフレーズ
はい
ビネット公開形式を識別する名前。
targetWidth
のコードフレーズ
はい

生成されるビネットビューのターゲット幅をピクセル単位で指定します。

出力ビネットがプライマリ ビネットと同じサイズになるように、ゼロを使用します。

targetHeight
のコードフレーズ
はい
イメージ レンダリング サーバでズーム用に最適化されたピラミッド ビネットを作成します。 [ ターゲット ビネット サイズ ] フィールドで設定した最大サイズから始めて、1 つのビネット出力ファイルに複数のサイズ ビューを作成します。 その後の各表示サイズは、幅と高さが 128 x 128 ピクセル以内になるまで半分になります。
createPyramid
のコードフレーズ
はい
生成される各サムネールの幅をピクセル単位で指定します。 この設定はオプションです。 サムネールファイルがない場合は 0 のままにします。
thumbWidth
のコードフレーズ
はい
公開するビネットのファイル形式を指定します。 新しいバージョンの画像オーサリングと古いバージョンの画像レンダリングサーバーを指定する場合、ImageRendering サーバーが読み取れるビネットバージョンを指定する必要があります。 新しいバージョンを指定すると、イメージ レンダリング サーバは公開されたビネットを読み取ることができません。 最新バージョンでビネットを公開するには、ゼロに設定します。
saveAsVersion
のコードフレーズ
はい
ビネット名と、その幅を示すサフィックスを区切る文字を指定します。
sizeSuffixSeparator
のコードフレーズ
はい
ビネット名と、その幅を示すサフィックスを区切る文字を指定します。
sharpen
のコードフレーズ
いいえ
各パブリッシュビネットサイズのメインビュー画像にシャープニングを適用しますシャープニングは、ビネットサイズの拡大時のぼかしを補うことができます。
usmAmount
のコードフレーズ
はい
デジタルアンシャープマスクは、特にスキャンされた画像のシャープネスを高める柔軟かつ強力な方法です。 これは、各オーバーシュートの大きさ（エッジの境界が暗くなり、明るくなるほど）を制御します。
usmRadius
のコードフレーズ
はい
拡張するエッジのサイズやエッジのリムの幅に影響を与えるため、ラジウムを小さくすると、スケールの小さいディテールが強調されます。 半径の値を大きくすると、エッジにハローが発生する場合があります。 細かいディテールには、同じサイズの小さなディテールが失われたり、半径よりも小さなディテールが失われたりするため、半径を小さくする必要があります。
usmThreshold
のコードフレーズ
はい
シャープにする輝度の変化の最小値や、隣接する階調値の間隔を、フィルターが機能する前に制御します。 この設定を使用すると、より繊細なエッジを残しながら、より多くの発音されたエッジをシャープにすることができます。 しきい値の許容範囲は 0 ～ 255 です。

出力（createVignettePublishFormatReturn）

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

例 section-0564752d439642b9bb8de2903db6de1e

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

リクエスト

<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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681