Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Wedia system can deliver images derivatives at scale through a CDN with a simple API.

...

  • uuid: The unique string-encoded identifier for the asset. Recommended for enhanced security.

  • type: The asset library type (e.g., asset, product_images). Not recommended for public URLs.

  • id: The unique integer identifier within the asset library.

  • basename: The desired base name for the output image, useful for SEO purposes.

  • suffix: (Optional) Specifies the output file format. If omitted or set to .auto, the system selects the best format based on browser capabilities.

...

  • Type: t=setbg

  • Description: Sets or replaces the background color of an image.

  • Parameters:

  • color (required): The desired HTML named color background color (e.g., black, white).

  • replace: The color to replace (default replaces transparent pixels).

  • fuzz: Tolerance level for color replacement (default is 1%).

  • Examples:

  • Force Tomato Background for a Transparent Source:

https://club-wed.wedia-group.com/api/wedia/dam/transform/brandcenterruwheefedknpfssojzuws6wwcw/2/thumb.webp?t=setbg&color=Tomato

...

  • Replace White Background with Black:

...

  • Type: t=iwatermark (Note the ‘i’ prefix indicating ‘image’)

  • Description: Adds an image watermark to the asset.

  • Parameters:

  • logoType or type: Type of the logo object.

  • logoId or id: Identifier of the logo.

  • logoUuid or uuid: (Required if logoType and logoId are not provided) UUID of the logo instance.

  • logoVariations or variations: (Required) List of logo variations to use for the watermark.

  • logoMaxWidth or width or w: (Required if logoMaxHeight is not provided) Maximum width of the logo on the image.

    • Decimal Value: Proportion of the source image (e.g., 0.25 for one-quarter of the source width).

    • Integer Value: Maximum width in pixels.

  • logoMaxHeight or height or h: (Required if logoMaxWidth is not provided) Maximum height of the logo on the image.

    • Decimal Value: Proportion of the source image height.

    • Integer Value: Maximum height in pixels.

  • logoGravity or gravity: Placement of the logo on the image (default is center).

    • Options:

      • nw (northwest)

      • n (north)

      • ne (northeast)

      • w (west)

      • c (center)

      • e (east)

      • sw (southwest)

      • s (south)

      • se (southeast)

  • logoX or x: X-axis offset relative to the gravity position.

  • logoY or y: Y-axis offset relative to the gravity position.

  • Basic Placements:

...

/api/wedia/dam/transform/{uuid}/{basename}.jpg?t=iwatermark&logoUuid=abcd1234&logoVariations=main&logoMaxWidth=0.25&logoGravity=se&logoX=10&logoY=10

https://club-wed.wedia-group.com/api/wedia/dam/transform/d6b81rwf1zejkf8gfi9acwhiuo/ski.jpg?t=iwatermark&logoUuid=ruwheefedknpfssojzuws6wwcw&logoVariations=thumbnailBig.webp&logoMaxWidth=400&logoGravity=c&logoX=100&logoY=100

...

  1. Extend Transformation

  • Type: t=extend

  • Description: Expands the image canvas to fixed dimensions, placing the original asset within it without enlarging the asset. Padding can be added around the asset.

  • Parameters:

  • width or w: Final width of the image (default is the source width).

  • height or h: Final height of the image (default is the source height).

  • padding: Uniform padding around all sides of the asset.

  • paddingLeftRight: Minimum padding on the left and right sides (overrides padding for these sides).

  • paddingTopBottom: Minimum padding on the top and bottom sides (overrides padding for these sides).

  • paddingColor or color: Color of the padding (default is transparent). Supported colors include standard color names (e.g., red, black, blue).

  • Example:

...