diff options
author | Jakob Odersky <jakob@odersky.com> | 2018-10-31 02:39:54 -0700 |
---|---|---|
committer | Jakob Odersky <jakob@odersky.com> | 2018-10-31 02:39:54 -0700 |
commit | ecd6bccd527ea0f5091a2efb14eb5173caddff27 (patch) | |
tree | a08f9d63092c8feb12a726ed27be94523eb068d9 /README.md | |
parent | ae7438bf93f8f5b6738b47f055b9f0b0599dea59 (diff) | |
download | identicon-ecd6bccd527ea0f5091a2efb14eb5173caddff27.tar.gz identicon-ecd6bccd527ea0f5091a2efb14eb5173caddff27.tar.bz2 identicon-ecd6bccd527ea0f5091a2efb14eb5173caddff27.zip |
Add readme and license
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..55603e8 --- /dev/null +++ b/README.md @@ -0,0 +1,30 @@ +# Identicons + +A tiny implementation of +[identicons](https://en.wikipedia.org/wiki/Identicon), similar to the +ones used by GitHub for new avatars. + +## Dependencies + +This library is totally self-contained, there are no 3rd party +dependencies. It is built and published for Scala on JVM, JS and +Native. + +```sbt +"io.crashbox" %%% "identicon" % "<unreleased>" +``` + +## Usage + +```scala +// generate identicon for user "admin" in SVG form +identicon.svg("admin") // = <svg width="5" height="5"><rect x="0" y="3" ... + +// in base64 data url form +identicon.url("admin") // = data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0... + +``` + +See the [online generator](https://jakob.odersky.com/identicon) for an +interactive preview. The generator is simply a static site that uses +the ScalaJS version of this library. |