テキスト文字列

画像にオーバーレイするテキスト文字列です。テキストをレンダリングするには、この値を指定する必要があります。それ以外のテキストパラメータは、設定されていない場合は無視されます。単一行のテキストには txt パラメータを使用するのが最適です。複数行のテキストの場合は、代わりに~textのドキュメントを参照してください。

imgix は UTF-8 文字のフルサポートを提供しており、非ラテン文字セットや絵文字（Unicode 15.0 サポート）を適切にレンダリングします。これにより、異なる言語をサポートするために各言語ごとに別の画像を作成する必要がなくなります。

txt パラメータは、他のテキストパラメータが設定されていない場合、次のデフォルト値を持ちます：

• 位置：右下隅
• フォント：Helvetica
• サイズ：12px
• 色：#000（不透明な黒）
• パディング：10px

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Base64 エンコーディングの使用

Base64 エンコーディングを使用すると、テキストを URL にエンコードする際に問題が発生しないようにすることができます。これは、より複雑な画像合成を行う場合や、~textエンドポイントにテキストパラメータのコレクションを渡す場合に特に重要です。

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

Edit in Sandbox

パラメータの優先順位

画像に複数のパラメータをオーバーレイする場合、パラメータの優先順位がどのパラメータが他のパラメータの上に表示されるかを決定します。優先順位の順序は次のとおりです。

1. text
2. mark
3. blend

優先度が高いパラメータが、低い優先度のパラメータの上に表示されます。たとえば、text は常に mark の上に表示され、mark は常に blend の上に表示されます。