emboss

The emboss transformation creates an embossed relief effect that makes images appear raised or carved. Perfect for creating textured overlays, artistic effects, or adding depth to graphics. The effect emphasizes edges and creates a 3D appearance.

Serving Content via CDN

The Media API is a CDN-based service that serves transformed images via GET requests. When you request a transformed image URL, the transformation is applied dynamically on the first request and then cached for subsequent requests.

URL Pattern

https://media.vyso.io/emboss:strength=AMOUNT/ASSET_ID.jpg

Examples

Light Emboss

curl -i GET https://media.vyso.io/emboss:strength=0.5/ASSET_ID.jpg

Standard Emboss

curl -i GET https://media.vyso.io/emboss/ASSET_ID.jpg

Strong Emboss

curl -i GET https://media.vyso.io/emboss:strength=1.5/ASSET_ID.jpg

Heavy Emboss (Relief Effect)

curl -i GET https://media.vyso.io/emboss:strength=2.0/ASSET_ID.jpg

Extreme Emboss

curl -i GET https://media.vyso.io/emboss:strength=3.0/ASSET_ID.jpg

On the first request, you'll receive a X-Cache: MISS header while the transformation is applied and cached. Subsequent requests will return X-Cache: HIT.

Parameters

strengthOPTIONAL

Strength of the emboss effect. Accepted values:

  • Range: 0.0 to 3.0+
  • 0.0 - No emboss effect
  • 1.0 - Standard emboss (default)
  • 0.5 - Subtle relief effect
  • 2.0+ - Heavy embossing with pronounced relief

Response

The API returns an embossed version of the image with a raised 3D effect. Higher strength values create more pronounced relief and texture. The response format depends on the format of the asset stored in the Vyso asset cloud.

Content-Type: Determined by the stored asset format (e.g., image/jpeg, image/png)

← Back to Transformations