The pixelated-avatar-generator package

[maintain]

Pixelated Avatar Generator is a library and application for generating pixelated avatar images from seed strings.


[Skip to ReadMe]

Properties

Versions0.1.0, 0.1.1, 0.1.1, 0.1.2, 0.1.3
Dependenciesbase (>=4.7 && <5), bytestring (>=0.10.6.0), JuicyPixels (>=3.2.7), pixelated-avatar-generator, pureMD5 (>=2.1.0.0), split (>=0.2.3.0) [details]
LicenseMIT
Copyright2016 Christopher Wells
AuthorChristopher Wells
Maintainercwellsny@nycap.rr.com
StabilityExperimental
CategoryImage, Graphics
Home pagehttps://github.com/ExcaliburZero/pixelated-avatar-generator
Bug trackerhttps://github.com/ExcaliburZero/pixelated-avatar-generator/issues
Source repositoryhead: git clone https://github.com/ExcaliburZero/pixelated-avatar-generator
Executablespixelated-avatar-generator
UploadedTue Jul 19 16:18:32 UTC 2016 by ExcaliburZero

Modules

[Index]

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for pixelated-avatar-generator-0.1.1

Pixelated Avatar Generator Travis CI Status Coverage Status

Pixelated Avatar Generator is a Haskell library and application for generating pixelated avatar images from seed values.

import Graphics.Avatars.Pixelated

createAndSaveAvatar :: String -> FilePath -> IO ()
createAndSaveAvatar s path = saveAvatar avatar path
  where avatar = scaleAvatar 32 $ generateAvatar seed
        seed   = createSeed s

Some examples of avatars generated by the library.

Library

Pixelated Avatar Generator is a library which provides functions and data types for generating, altering, and saving pixelated avatars.

For information on how to use the library, see the documentation for the Graphics.Avatars.Pixelated module.

Documentation

The documentation for the latest release of the library can be found in the library's Hackage entry.

Documentation of the development versions of the library can be generated by running the following command in the main directory of the project:

$ stack haddock

The generated html documentation can then be found in the following directory:

.stack-work/dist/x86_64-linux/Cabal-1.22.5.0/doc

Executable

An example executable program that uses the library is also provided. It creates an avatar from a given seed string and saves the created .png image to a given file location.

The executable can be compiled by running the following command:

$ stack build

The executable can then by run by running it with stack exec and providing it the desired filepath of the output file including the .png extension and a random seed string.

$ stack exec pixelated-avatar-generator image.png "Hello, World"
Creating avatar at image.png
Grey
█ ████ █
        
  ████  
█  ██  █
████████
█ █  █ █
█      █
████████
Successfully created avatar, and saved it to image.png

Usage

Usage: pixelated-avatar-generator FILEPATH SEEDSTRING

FILEPATH   -- The location to save the generated avatar at. "img/test.png"
SEEDSTRING -- The string to use to generate the avatar. "Hello"

Links

License

The source code of Pixelated Avatar Generator is available under the MIT license, see LICENSE for more information.