Identiconpp Class Reference

Base class for identiconpp. More...

#include <identiconpp.hpp>

Public Types
enum	algorithm { ltr_symmetric, ltr_asymmetric, sigil }
	List of identicon algorithms.

Public Member Functions
	Identiconpp (const uint8_t columns, const uint8_t rows, algorithm type=algorithm::ltr_symmetric, const string &background="ffffffff", const vector< string > &foreground={ "000000ff" }, const array< const uint8_t, 2 > &padding={ 0, 0 })
	Initialises an instance of Identiconpp. More...
Magick::Image	generate (const string &digest, const uint16_t width=100)
	Generates identicon from digest. More...

Detailed Description

Base class for identiconpp.

Use this class for all your identicons. Exceptions will be thrown on error.

Constructor & Destructor Documentation

Identiconpp()

Identiconpp::Identiconpp ( const uint8_t  columns, const uint8_t  rows, algorithm  type = algorithm::ltr_symmetric, const string &  background = "ffffffff", const vector< string > &  foreground = { "000000ff" }, const array< const uint8_t, 2 > &  padding = { 0, 0 }  )

explicit

Initialises an instance of Identiconpp.

The instance can be used for creating identicons with differing image formats and sizes. The colors must consist of exactly 8 digits.

Parameters

columns	Number of columns
rows	Number of rows
type	The algorithm to use
background	Background color, hexadecimal, rrggbbaa
foreground	vector of foreground colors
padding	Padding in pixels { left & right, top & down }

: _rows(rows)
, _columns(columns)
, _type(type)
, _background(background)
, _foreground(foreground)
, _padding(padding)
{
    check_color(background);

    for (const string &color : foreground)
    {
        check_color(color);
    }
}

Member Function Documentation

generate()

Magick::Image Identiconpp::generate	(	const string &	digest,
		const uint16_t	width = 100
	)

Generates identicon from digest.

Parameters

digest	The pre-computed digest
width	The width of the image in pixels

Returns

The image as Magick::Image

{
    ttdebug << "Using digest: " << digest << '\n';
    check_entropy(digest, _type);
    const uint16_t imgwidth = width - _padding[0] * 2;
    const uint16_t imgheight = imgwidth / _columns * _rows;
    ttdebug << "width: " << std::to_string(imgwidth + _padding[0] * 2)
            << ", height: " << std::to_string(imgheight + _padding[1] * 2)
            << "\n";
    Magick::Image img;

    switch (_type)
    {
        case algorithm::ltr_symmetric:
        {
            img = generate_ltr_symmetric(digest);
            break;
        }
        case algorithm::ltr_asymmetric:
        {
            img = generate_ltr_asymmetric(digest);
            break;
        }
        case algorithm::sigil:
        {
            img = generate_sigil(digest);
            break;
        }
    }

    img.backgroundColor(Magick::Color('#' + _background));
    img.scale(Magick::Geometry(imgwidth, imgheight));
    img.borderColor(Magick::Color('#' + _background));
    img.border(Magick::Geometry(_padding[0], _padding[1]));
    return img;
}

---

The documentation for this class was generated from the following files:

• src/identiconpp.hpp
• src/checks.cpp
• src/identiconpp.cpp
• src/ltr_asymmetric.cpp
• src/ltr_symmetric.cpp
• src/sigil.cpp