diff --git a/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html b/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html index 854cfb3..08cde40 100644 --- a/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html +++ b/docs/dir_68267d1309a1af8e8297ef4c3efbcdba.html @@ -47,6 +47,13 @@ $(function() {
src Directory Reference
+ + + + + +

+Files

file  identiconpp_c.h [code]
 C interface for identiconpp.
 
diff --git a/docs/example_8c-example.html b/docs/example_8c-example.html index 975a528..e3703d7 100644 --- a/docs/example_8c-example.html +++ b/docs/example_8c-example.html @@ -43,7 +43,7 @@ $(function() {
example.c
-
/* This file is part of identiconpp.
* Public Domain / CC-0
*
* Compile with gcc --std=c99 $(pkg-config --cflags --libs MagickWand) \
* $(pkg-config --cflags --libs openssl) -lidenticonpp
*/
#include <stdint.h>
#include <string.h>
#include <stdio.h>
#include "identiconpp_c.h"
#include <MagickWand/MagickWand.h>
#include <openssl/evp.h>
#include <openssl/bio.h>
char *b64decode(char *input, int length)
{
BIO *b64, *bmem;
char *buffer = (char *)malloc(length);
memset(buffer, 0, length);
b64 = BIO_new(BIO_f_base64());
BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
bmem = BIO_new_mem_buf(input, length);
bmem = BIO_push(b64, bmem);
BIO_read(bmem, buffer, length);
BIO_free_all(bmem);
return buffer;
}
int main(int argc, char *argv[])
{
char digest[65] = "973dfe463ec85785f5f95af5ba3906ee"
"db2d931c24e69824a89ea65dba4e813b";
const char colors[6][9] =
{
"800000ff",
"008000ff",
"000080ff",
"808000ff",
"008080ff",
"800080ff"
};
if (argc > 1)
{
strncpy(digest, argv[1], 64);
}
MagickWand *mw = NULL;
MagickWandGenesis();
mw = NewMagickWand();
{
const uint8_t padding[2] = { 20, 20 };
identiconpp_setup(4, 4, identiconpp_ltr_symmetric,
"ffffffff", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon1.png");
}
{
const uint8_t padding[2] = { 0, 0 };
identiconpp_setup(5, 5, identiconpp_sigil,
"00000080", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon2.png");
}
{
const uint8_t padding[2] = { 0, 0 };
identiconpp_setup(5, 5, identiconpp_ltr_asymmetric,
"000000ff", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon3.png");
}
{
const uint8_t padding[2] = { 10, 10 };
identiconpp_setup(6, 4, identiconpp_ltr_symmetric,
"000000c0", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon4.png");
}
DestroyMagickWand(mw);
MagickWandTerminus();
}
+
/* This file is part of identiconpp.
* Public Domain / CC-0
*
* Compile with gcc --std=c99 $(pkg-config --cflags --libs MagickWand) \
* $(pkg-config --cflags --libs openssl) -lidenticonpp
*/
#include <stdint.h>
#include <string.h>
#include <stdio.h>
#include "identiconpp_c.h"
#include <MagickWand/MagickWand.h>
#include <openssl/evp.h>
#include <openssl/bio.h>
char *b64decode(char *input, int length)
{
BIO *b64, *bmem;
char *buffer = (char *)malloc(length);
memset(buffer, 0, length);
b64 = BIO_new(BIO_f_base64());
BIO_set_flags(b64, BIO_FLAGS_BASE64_NO_NL);
bmem = BIO_new_mem_buf(input, length);
bmem = BIO_push(b64, bmem);
BIO_read(bmem, buffer, length);
BIO_free_all(bmem);
return buffer;
}
int main(int argc, char *argv[])
{
char digest[65] = "973dfe463ec85785f5f95af5ba3906ee"
"db2d931c24e69824a89ea65dba4e813b";
const char colors[6][9] =
{
"800000ff",
"008000ff",
"000080ff",
"808000ff",
"008080ff",
"800080ff"
};
if (argc > 1)
{
strncpy(digest, argv[1], 64);
}
MagickWand *mw = NULL;
MagickWandGenesis();
mw = NewMagickWand();
{
const uint8_t padding[2] = { 20, 20 };
identiconpp_setup(4, 4, identiconpp_ltr_symmetric,
"ffffffff", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon1.png");
}
{
const uint8_t padding[2] = { 0, 0 };
identiconpp_setup(5, 5, identiconpp_sigil,
"00000080", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon2.png");
}
{
const uint8_t padding[2] = { 0, 0 };
identiconpp_setup(5, 5, identiconpp_ltr_asymmetric,
"000000ff", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon3.png");
}
{
const uint8_t padding[2] = { 10, 10 };
identiconpp_setup(6, 4, identiconpp_ltr_symmetric,
"000000c0", colors, 6, padding);
uint64_t len = identiconpp_generate("png", digest, 200);
char base64[len];
strcpy(base64, identiconpp_base64());
MagickReadImageBlob(mw, b64decode(base64, len), len);
MagickWriteImage(mw, "identicon4.png");
}
DestroyMagickWand(mw);
MagickWandTerminus();
}
Generated by   diff --git a/docs/files.html b/docs/files.html index 419b4dd..ccff64b 100644 --- a/docs/files.html +++ b/docs/files.html @@ -48,7 +48,7 @@ $(function() {  ▼ src  debug.hpp  identiconpp.hpp - identiconpp_c.h + identiconpp_c.hC interface for identiconpp diff --git a/docs/globals.html b/docs/globals.html new file mode 100644 index 0000000..0c422a7 --- /dev/null +++ b/docs/globals.html @@ -0,0 +1,73 @@ + + + + + + + +identiconpp: File Members + + + + + + +
+
+ + + + + + +
+
identiconpp +  0.4.0 +
+
+
+ + + + + + +
+
+
Here is a list of all documented file members with links to the documentation:
+
+ +
+Generated by   +doxygen + 1.8.14 +
+ + diff --git a/docs/globals_enum.html b/docs/globals_enum.html new file mode 100644 index 0000000..691e6a3 --- /dev/null +++ b/docs/globals_enum.html @@ -0,0 +1,55 @@ + + + + + + + +identiconpp: File Members + + + + + + +
+
+ + + + + + +
+
identiconpp +  0.4.0 +
+
+
+ + + + + + +
+
+  +
+ +
+Generated by   +doxygen + 1.8.14 +
+ + diff --git a/docs/globals_eval.html b/docs/globals_eval.html new file mode 100644 index 0000000..acf331a --- /dev/null +++ b/docs/globals_eval.html @@ -0,0 +1,61 @@ + + + + + + + +identiconpp: File Members + + + + + + +
+
+ + + + + + +
+
identiconpp +  0.4.0 +
+
+
+ + + + + + +
+
+  +
+ +
+Generated by   +doxygen + 1.8.14 +
+ + diff --git a/docs/globals_func.html b/docs/globals_func.html new file mode 100644 index 0000000..1b6cf76 --- /dev/null +++ b/docs/globals_func.html @@ -0,0 +1,61 @@ + + + + + + + +identiconpp: File Members + + + + + + +
+
+ + + + + + +
+
identiconpp +  0.4.0 +
+
+
+ + + + + + +
+
+  +
+ +
+Generated by   +doxygen + 1.8.14 +
+ + diff --git a/docs/identiconpp__c_8h.html b/docs/identiconpp__c_8h.html new file mode 100644 index 0000000..df03f6f --- /dev/null +++ b/docs/identiconpp__c_8h.html @@ -0,0 +1,252 @@ + + + + + + + +identiconpp: src/identiconpp_c.h File Reference + + + + + + +
+
+ + + + + + +
+
identiconpp +  0.4.0 +
+
+
+ + + + + + + +
+
+
+Enumerations | +Functions
+
+
identiconpp_c.h File Reference
+
+
+ +

C interface for identiconpp. +More...

+
#include <stdbool.h>
+#include <stdint.h>
+#include <stddef.h>
+
+

Go to the source code of this file.

+ + + + + +

+Enumerations

enum  identiconpp_algorithm { identiconpp_ltr_symmetric, +identiconpp_ltr_asymmetric, +identiconpp_sigil + }
 List of identicon algorithms. More...
 
+ + + + + + + + + + +

+Functions

bool identiconpp_setup (const uint8_t columns, const uint8_t rows, identiconpp_algorithm type, const char background[9], const char foreground[][9], const uint8_t foreground_len, const uint8_t padding[2])
 Setup identicon parameters. More...
 
uint64_t identiconpp_generate (const char magick[], const char digest[], const uint16_t width)
 Generates identicon from digest. More...
 
+const char * identiconpp_base64 ()
 Return base64-encoded string of the image generated with identiconpp_generate().
 
+

Detailed Description

+

C interface for identiconpp.

+

Enumeration Type Documentation

+ +

◆ identiconpp_algorithm

+ +
+
+ + + + +
enum identiconpp_algorithm
+
+ +

List of identicon algorithms.

+ + + + +
Enumerator
identiconpp_ltr_symmetric 

Generates symmetric (vertically mirrored) identicons.

+
identiconpp_ltr_asymmetric 

Generates asymmetric identicons.

+
identiconpp_sigil 

Generates the same results as sigil and pydenticon.

+
+
39  {
41  identiconpp_ltr_symmetric,
43  identiconpp_ltr_asymmetric,
49  identiconpp_sigil
50  } identiconpp_algorithm;
identiconpp_ltr_asymmetric
Generates asymmetric identicons.
Definition: identiconpp_c.h:43
+
identiconpp_ltr_symmetric
Generates symmetric (vertically mirrored) identicons.
Definition: identiconpp_c.h:41
+
identiconpp_sigil
Definition: identiconpp_c.h:49
+
identiconpp_algorithm
identiconpp_algorithm
List of identicon algorithms.
Definition: identiconpp_c.h:38
+
+
+
+

Function Documentation

+ +

◆ identiconpp_generate()

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
uint64_t identiconpp_generate (const char magick[],
const char digest[],
const uint16_t width 
)
+
+ +

Generates identicon from digest.

+
Parameters
+ + + + +
magickSee http://imagemagick.org/script/formats.php
digestThe pre-computed digest
widthThe width of the identicon
+
+
+
Returns
Length of the generated base64-string, or 0 on error.
+
Examples:
example.c.
+
83 {
84  try
85  {
86  Magick::Image img = identicon->generate(digest, width);
87  Magick::Blob blob;
88  img.magick(magick);
89  img.write(&blob);
90  base64 = blob.base64();
91  return blob.base64().length();
92  }
93  catch (const std::exception &e)
94  {
95  cerr << e.what() << endl;
96  return 0;
97  }
98 }
+
+
+ +

◆ identiconpp_setup()

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
bool identiconpp_setup (const uint8_t columns,
const uint8_t rows,
identiconpp_algorithm type,
const char background[9],
const char foreground[][9],
const uint8_t foreground_len,
const uint8_t padding[2] 
)
+
+ +

Setup identicon parameters.

+
Parameters
+ + + + + + + + +
columnsNumber of columns
rowsNumber of rows
typeThe algorithm to use
backgroundBackground color, hexadecimal, rrggbbaa
foregroundArray of foreground colors
foreground_lenLength of the array of foreground colors
paddingPadding in pixels { left & right, top & down }
+
+
+
Returns
false on error, true otherwise.
+
Examples:
example.c.
+
39 {
40  Identiconpp::algorithm algo = Identiconpp::algorithm::ltr_symmetric;
41  switch (type)
42  {
43  case identiconpp_ltr_symmetric:
44  {
45  algo = Identiconpp::algorithm::ltr_symmetric;
46  break;
47  }
48  case identiconpp_ltr_asymmetric:
49  {
50  algo = Identiconpp::algorithm::ltr_asymmetric;
51  break;
52  }
53  case identiconpp_sigil:
54  {
55  algo = Identiconpp::algorithm::sigil;
56  break;
57  }
58  }
59 
60  std::vector<string> vforeground;
61  for (uint8_t i = 0; i < foreground_len; ++i)
62  {
63  vforeground.push_back(foreground[i]);
64  }
65 
66  try
67  {
68  identicon = std::make_unique<Identiconpp>(
69  Identiconpp(columns, rows, algo, background, vforeground,
70  { padding[0], padding[1] }));
71  }
72  catch (const std::exception &e)
73  {
74  cerr << e.what() << endl;
75  return false;
76  }
77 
78  return true;
79 }
identiconpp_ltr_asymmetric
Generates asymmetric identicons.
Definition: identiconpp_c.h:43
+
Identiconpp::algorithm
algorithm
List of identicon algorithms.
Definition: identiconpp.hpp:49
+
identiconpp_ltr_symmetric
Generates symmetric (vertically mirrored) identicons.
Definition: identiconpp_c.h:41
+
Identiconpp
Base class for identiconpp.
Definition: identiconpp.hpp:42
+
identiconpp_sigil
Definition: identiconpp_c.h:49
+
Identiconpp::algorithm::ltr_symmetric
Generates symmetric (vertically mirrored) identicons.
+ +
Identiconpp::algorithm::ltr_asymmetric
Generates asymmetric identicons.
+
+
+
+
+ +
+Generated by   +doxygen + 1.8.14 +
+ + diff --git a/docs/identiconpp__c_8h_source.html b/docs/identiconpp__c_8h_source.html index 110f766..2c63c82 100644 --- a/docs/identiconpp__c_8h_source.html +++ b/docs/identiconpp__c_8h_source.html @@ -47,7 +47,14 @@ $(function() {
identiconpp_c.h
-
1 /* This file is part of identiconpp.
2  * Copyright © 2019 tastytea <tastytea@tastytea.de>
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation, version 3.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  */
16 
17 #ifndef IDENTICONPP_H
18 #define IDENTICONPP_H
19 
20 #ifdef __cplusplus
21 extern "C"
22 {
23 #endif
24 
25  #include <stdbool.h>
26  #include <stdint.h>
27  #include <stddef.h>
28 
40  typedef enum
41  {
42  identiconpp_ltr_symmetric,
43  identiconpp_ltr_asymmetric,
44  identiconpp_sigil
45  } identiconpp_algorithm;
46 
60  bool identiconpp_setup(const uint8_t columns, const uint8_t rows,
61  identiconpp_algorithm type,
62  const char background[9],
63  const char foreground[][9],
64  const uint8_t foreground_len,
65  const uint8_t padding[2]);
66 
76  uint64_t identiconpp_generate(const char magick[],
77  const char digest[], const uint16_t width);
78 
83  const char *identiconpp_base64();
84 
85 #ifdef __cplusplus
86 }
87 #endif
88 #endif // IDENTICONPP_H
+Go to the documentation of this file.
1 /* This file is part of identiconpp.
2  * Copyright © 2019 tastytea <tastytea@tastytea.de>
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation, version 3.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  */
16 
17 #ifndef IDENTICONPP_H
18 #define IDENTICONPP_H
19 
20 #ifdef __cplusplus
21 extern "C"
22 {
23 #endif
24 
25  #include <stdbool.h>
26  #include <stdint.h>
27  #include <stddef.h>
28 
38  typedef enum
39  {
41  identiconpp_ltr_symmetric,
43  identiconpp_ltr_asymmetric,
49  identiconpp_sigil
50  } identiconpp_algorithm;
51 
65  bool identiconpp_setup(const uint8_t columns, const uint8_t rows,
66  identiconpp_algorithm type,
67  const char background[9],
68  const char foreground[][9],
69  const uint8_t foreground_len,
70  const uint8_t padding[2]);
71 
81  uint64_t identiconpp_generate(const char magick[],
82  const char digest[], const uint16_t width);
83 
88  const char *identiconpp_base64();
89 
90 #ifdef __cplusplus
91 }
92 #endif
93 #endif // IDENTICONPP_H
identiconpp_generate
uint64_t identiconpp_generate(const char magick[], const char digest[], const uint16_t width)
Generates identicon from digest.
Definition: c_interface.cpp:81
+
identiconpp_ltr_asymmetric
Generates asymmetric identicons.
Definition: identiconpp_c.h:43
+
identiconpp_setup
bool identiconpp_setup(const uint8_t columns, const uint8_t rows, identiconpp_algorithm type, const char background[9], const char foreground[][9], const uint8_t foreground_len, const uint8_t padding[2])
Setup identicon parameters.
Definition: c_interface.cpp:33
+
identiconpp_ltr_symmetric
Generates symmetric (vertically mirrored) identicons.
Definition: identiconpp_c.h:41
+
identiconpp_sigil
Definition: identiconpp_c.h:49
+
identiconpp_algorithm
identiconpp_algorithm
List of identicon algorithms.
Definition: identiconpp_c.h:38
+
identiconpp_base64
const char * identiconpp_base64()
Return base64-encoded string of the image generated with identiconpp_generate().
Definition: c_interface.cpp:100
+
Generated by   diff --git a/docs/menudata.js b/docs/menudata.js index 3653169..48a74de 100644 --- a/docs/menudata.js +++ b/docs/menudata.js @@ -31,5 +31,10 @@ var menudata={children:[ {text:"Functions",url:"functions_func.html"}, {text:"Enumerations",url:"functions_enum.html"}]}]}, {text:"Files",url:"files.html",children:[ -{text:"File List",url:"files.html"}]}, +{text:"File List",url:"files.html"}, +{text:"File Members",url:"globals.html",children:[ +{text:"All",url:"globals.html"}, +{text:"Functions",url:"globals_func.html"}, +{text:"Enumerations",url:"globals_enum.html"}, +{text:"Enumerator",url:"globals_eval.html"}]}]}, {text:"Examples",url:"examples.html"}]}