この機能により、イメージまたはテキストを透かして他のイメージに追加できます。
パラメーター
このテーブルは、watermark
操作で使用できる基本パラメーターとその値の説明です。
名前 | 説明 | パラメーター種別 |
---|---|---|
t |
透明度を示します。 このパラメーターは、追加されたイメージの透かし、またはテキストの透かしの透明度を上げます。 既定値: 100 (単位は % )。透明度はありません。値の範囲: [0 - 100] |
オプション |
g |
対象のイメージ上の透かしの位置を示します。 位置をを次の図に示します。 値の範囲: [nw,north,ne,west,center,east,sw,south,se] |
オプション |
x |
水平方向の余白、つまり透かしとイメージの端との間の水平方向の距離を示します。 このパラメーターは、透かしがイメージの左上、左中央、左下隅、右上、右中央、または右下隅にある場合にのみ有効です。 既定値: 1 値の範囲: [1 - 1000] 単位: ピクセル (px) |
オプション |
y | 垂直余白、つまり透かしとイメージの端との間の垂直距離を示します。 このパラメーターは、透かしがイメージの左上、中央上部、右上、左下隅、中央下部、または右下隅にある場合にのみ有効です。 既定値: 1 値の範囲: [0 - 4,096] 単位: ピクセル (px) | オプション |
voffset | 正中線の垂直方向のオフセットを示します。 透かしがイメージの中央左、中央、または右中央にあるときは、正中線に沿って透かしの垂直方向のオフセットを指定します。 既定値: 0 値の範囲: [ - 1,000 - 1,000] 単位: ピクセル (px) | オプション |
- イメージに複数の透かしがある場合、イメージ上の透かしの位置に加えて、水平方向の余白、垂直方向の余白、および正中線の垂直方向のオフセットにより、透かしのレイアウトを調整します。
- イメージ処理中、URL セーフの Base64 エンコードを使用できます。 詳しくは、RFC4648 または URL セーフの Base64 エンコードのセクションをご参照ください。
- g パラメーターの、パラメーター位置マッピングテーブルは、次のように提供されます。

名前 | 説明 | パラメーター種別 |
---|---|---|
image |
これは、イメージ透かしのオブジェクト名 (エンコードする必要があります) を示します。 注 URLセーフの base64 エンコードが必要です。: encodedObject = url_safe_base64_encode(object) たとえば、オブジェクト名が
"panda.png" の場合、エンコードされた名前は "cGFuZGEucG5n" です。
|
必須パラメーター |
透かしイメージの前処理
ユーザーが透かしを適用すると、透かしイメージを前処理することができます。 サポートされている前処理操作は次のとおりです。 イメージの拡大縮小、イメージのクロッピング (内接円の調整はサポートされていません)、およびイメージの回転。 さらに、サイズ変更操作で使用するパラメーターは他にもサポートされています。: P パラメーター。 P は、マスターイメージに対する透かしイメージの縮尺を示します。 値の範囲は [1 - 100] で、スケールの割合を示します。
前処理の例
たとえば、P_10 が設定されている 100 × 100 のマスターイメージの透かしのサイズは 10 × 10 です。 同じ透かし処理パラメーターが異なるサイズのイメージに適用される場合、透かしイメージは大きすぎるか小さすぎになる可能性があります。 Pパラメーターはこの問題を解決します。 IMGは、p パラメーターを使用し、メインイメージのサイズに応じて透かしイメージのサイズを動的に調整します。
panda.pngを 30% の幅に拡大縮小すると、透かしファイルは次のようになります。"panda.png?x-oss-process=image/resize,P_30" URL セーフの Base64 エンコードを追加した後は、この透かしファイルは次のようになります。 "cGFuZGEucG5nP3gtb3NzLXByb2Nlc3M9aW1hZ2UvcmVzaXplLFBfMzA"
透かしが右下隅の角に配置され、ソースイメージの幅が 400 に縮小される場合、透かし演算は "watermark=1&object=cGFuZGEucG5nQDMwUA&t=90&p=9&x=10&y=10" となります。 これは、次のようにイメージに適用されます。

ソースイメージの幅が 300 に縮小された場合、透かし演算は次のようになります。

名前 | 説明 | パラメーター種別 |
---|---|---|
text |
テキスト透かしのテキストを示します (エンコードが必要です)。 注 URL セーフの base64 エンコーディングが必要です。: encodeText = url_safe_base64_encode(fontText) 最大長:
64 文字
|
必須項目 |
type |
テキスト透かしのリテラルタイプを示します (エンコードが必要です)。 注 注記: URL セーフの base64 エンコードが必要です。: encodeText = url_safe_base64_encode(fontType)
値の範囲: 次のリテラルタイプエンコードテーブルをご参照ください。 既定値: wqy-zenhei (エンコード値: d3F5LXplbmhlaQ) |
オプション |
color |
テキスト透かしのテキストコンテンツの色を示します (エンコードが必要です)。 URL セーフの base64 エンコードが必要です。: EncodeFontColor = url_safe_base64_encode(fontColor) パラメーターの形式は # + 6 つの 16 進数でなければなりません。 たとえば、"#000000" は黒色を示します。"#" はプレフィックスを示します。 000000 の 2 桁ごとに RGB カラーが構成されます。 #FFFFFF は白色を表します。 既定値: #000000 (黒色) |
オプション |
size |
テキスト透かしのテキストコンテンツのサイズ (px) を示します。 値の範囲: [0 - 1000] 既定値: 40 |
オプション |
shadow |
テキスト透かしの影の透明度を示します。 値の範囲: [0 - 100] |
オプション |
rotate |
テキストの時計回りの回転角度を示します。 値の範囲: [0 - 360] |
オプション |
fill |
イメージに透かしを入れる効果を示します。 値の範囲: [0 , 1] 1 はイメージが透かしで塗りつぶされることを示します。 0 は塗りつぶし効果がないことを示します。 |
オプション |
リテラル型エンコードテーブル
パラメーターの値 | 意味 | URL セーフの Base64 エンコード値 | 備考 |
---|---|---|---|
wqy-zenhei | Wen quan yi zheng hei ti、漢字のフォントタイプ | D3F5LXplbmhlaQ== | RFC の基準では、埋め込み文字 == を省略することができるため、d3F5LXplbmhlaQ となります。 |
wqy-microhei | WenQuanYi Chinese font プロジェクトの Micro Hei フォント | d3F5LW1pY3JvaGVp | |
fangzhengshusong | 簡体字フォント Founder ShuSong | ZmFuZ3poZW5nc2h1c29uZw== | RFC の基準では、埋め込み文字 == を省略することができるため、ZmFuZ3poZW5nc2h1c29uZw となります。 |
fangzhengkaiti | 簡体字フォント Founder Kai | ZmFuZ3poZW5na2FpdGk= | RFC の基準では、埋め込み文字 = を省略することができるため、ZmFuZ3poZW5na2FpdGk となります。 |
fangzhengheiti | 簡体字フォント Founder Hei | ZmFuZ3poZW5naGVpdGk= | RFC の基準では、埋め込み文字 = を省略することができるため、ZmFuZ3poZW5naGVpdGk となります。 |
fangzhengfangsong | 簡体字フォント Founder FangSong | ZmFuZ3poZW5nZmFuZ3Nvbmc= | RFC の基準では、埋め込み文字 = を省略することができるため、ZmFuZ3poZW5nZmFuZ3Nvbmc となります。 |
droidsansfallback | フォールバックフォント Droid Sans | ZHJvaWRzYW5zZmFsbGJhY2s= | RFC の基準では、埋め込み文字 = を省略することができるため、ZHJvaWRzYW5zZmFsbGJhY2s となります。 |
名前 | 説明 | パラメーター種別 |
---|---|---|
order |
テキスト & イメージの透かしのテキストの透かしと、イメージの透かしの順番を示します。 値の範囲: [0 , 1] 0 (既定値) は、イメージの透かしがテキストの透かしより前にあることを示します。 1 は、テキストの透かしがイメージの透かしの前にあることを示します。 |
オプション |
align |
テキスト & イメージの透かしのテキストの透かしと、イメージの透かしの配置を示します。 値の範囲: [0, 1, 2] 0 (既定値): 上、1: 中央、2: 下 |
オプション |
interval |
テキスト & イメージの透かしのテキストの透かしと、イメージの透かしの間のスペースを示します。 値の範囲: [0, 1000] |
オプション |
多くのパラメーターは、イメージ処理中に Base64 エンコードをする必要があります。 詳しくは、「RFC4648」をご参照ください。 URL セーフの Base64 エンコードは、特定の透かしパラメーター (テキストコンテンツのテキストコンテンツ、色、フォント、イメージ透かしのオブジェクト) にのみ適用できます。 署名には使用しないでください。 エンコード形式は次のとおりです。
- コンテンツをエンコードして base64 結果を生成します。
- 結果のプラス記号 (+) をマイナス記号 (-) に置き換えます。
- 結果のスラッシュ記号 (/) を下線 (_) に置き換えます。
- 結果の末尾にあるイコール記号 (=) を維持します。
Python での例を以下に示します。
import base64
input='wqy-microhei'
print(base64.urlsafe_b64encode(input))
例
- 次の URL は、ファイル "example.jpg" に "panda.png" で透かしを入れます(URL セーフの base64 エンコード後: cGFuZGEucG5n)。
- "panda.png" の幅を 50 に設定します。 透かしファイルは、panda.png?x-oss-process=image/resize,w_50となり、URL
セーフの Base64 エンコードの後、cGFuZGEucG5nP3gtb3NzLXByb2Nlc3M9aW1hZ2UvcmVzaXplLHdfNTA=) になります。