Generate the SVG code of the identicon for the specified text.

Without specifying any optional arguments this function generates a 5x5 identicon with a transparent background and colored grid squares with full opacity.

A different hashing function is used automatically for each identicon size, so that the utilization of bits is maximized for the given size:

• MD5 for sizes 4 and 5,
• RIPEMD-160 for 6, and
• SHA3 for 7 to 10 with 224, 256, 384 and 512 bits, respectively.

Optionally, specify any combination of the following arguments:

• size: the number of grid squares of the identicon's side; integer, 4 to 10; 5 by default.
• bg_color: the color of the background grid squares as a hex code string (e.g., #eee) or an atom specifying the color complementarity (se below); nil by default.
• opacity: the opacity of the entire identicon (all grid squares); float, 0.0 to 1.0; 1.0 by default.

The color of the foreground grid squares is always equal to the three first bytes of the hash of text, regardless of which hashing function is used automatically.

Setting bg_color to nil (default value) generates only the foreground (colored) squares, with the default (1.0) or requested opacity.

New since v0.9.0: Setting padding to a positive integer sets the padding to the identicon to that value. If bg_color is non-nil, it will also be applied to the padding area with the with the default (1.0) or requested opacity, which is applied the same on the foreground and the background. The file size is greatly reduced. Set the squircle curvature factor with the :squircle_curvature keyword option to a float to crop the identicon to a squircle.

New since v0.8.0: Setting bg_color to one of the following 3 atom values sets the color of the background squares to the corresponding RGB-complementary color of the automatically-defined foreground color, with the default (1.0) or requested opacity:

• :basic: the complementary color, i.e. the opposite color of fg_color on the color wheel.
• :split1: the first adjacent tertiary color of the complement of fg_color on the color wheel.
• :split2: the second adjacent tertiary color of the complement of fg_color on the color wheel.

examples

Examples

5x5 identicon with transparent background:

generate("banana")

5x5 identicon with complementary background color:

generate("banana", 5, :basic)

5x5 identicon with first split-complementary background color:

generate("banana", 5, :split1)

5x5 identicon with second split-complementary background color:

generate("banana", 5, :split2)

6x6 identicon with transparent background:

generate("pineapple", 6)

7x7 identicon with padding 1, complementary background color, and 70% opacity:

generate("overbring.com", 7, :basic, 0.7, 1)

7x7 identicon with blue (#33f) background:

generate("refrigerator", 7, "#33f")

9x9 identicon with transparent background and 50% opacity:

generate("2023-03-14", 9, nil, 0.5)

10x10 identicon with yellow (#ff0) background and 80% opacity:

generate("banana", 10, "#ff0", 0.8)

10x10 identicon with split-1 background complementary color, with 3 squares of padding, at full opacity, cropped to a squircle with curvature factor 0.9:

generate("squircles!!", 10, :split2, 1.0, 3, squircle_curvature: 0.9)

5x5 identicon with basic background complementary color, with 2 squares of padding, at 40% opacity, cropped to a squircle with curvature factor 0.82:

generate("elixir", 5, :basic, 0.4, 2, squircle_curvature: 0.82)