Imgix APIsレンダリング APIテキストテキストY座標

テキストY座標

txt-y

基本画像の上端に対するテキストのy座標を定義します。

値には正・負のどちらも指定でき、ピクセル単位の整数、または画像に対する小数の割合で記述します(下記参照)。値が負の場合、画像は基本画像の境界の外部に部分的に配置されます。txt-y パラメータは、設定されている場合に txt-align=top、txt-align=middle、txt-align=bottom、および txt-pad(垂直方向)を上書きします。特定のテキストレイヤーのみで上書きするには txt-y[N] を使用してください — ベアな txt-y はデフォルトですべてのレイヤーに適用されます。

ピクセルと割合

数値の書き方によって単位が決まります。20 のような整数はこれまでどおりピクセル × dpr です。0.05、.5、1.0 のように小数点を含む0以上1以下の値は割合として扱われ、dpr が乗算されることはありません。2.5 のようにそれ以外の値はピクセルとして読み取られます。

つまり txt-y=1 は1ピクセルですが、txt-y=1.0 は画像の高さ全体になります。割合で記述したURLは、どの幅・どの dpr でも同じ比率を保ちます。