createVignettePublishFormat
最終更新日: 2024年7月22日
作成対象:
- 開発者
- 管理者
ビネットの新しい公開形式を作成します。
ビネット形式は、公開するビネットとそのサムネールのサイズ、ズームレベル、シャープニングパラメーター、IPS から画像レンダリングサーバーに公開したプライマリビネットから生成されるビネットのファイルフォーマットバージョンを指定します。
新しいバージョンの Image Rendering Server では、ピラミッド ビネットをサポートできるため、公開用に特定のビネット形式サイズを定義する必要がなくなります。
許可されているユーザータイプ
IpsAdmin
IpsCompanyAdmin
TrialSiteAdmin
ImagePortalAdmin
パラメーター
入力(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 | はい | 作成されたビネット形式へのハンドル。 |
例
このコードは、ビネット公開形式を作成します。 作成リクエストでは、名前、ターゲットの幅と高さ、およびその他の必要な値を指定します。
リクエスト
<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