34 lines
2.1 KiB
Markdown
34 lines
2.1 KiB
Markdown
#Pixel-Style Avatar Generator
|
|
|
|
|
|
I needed a kid-friendly (G rated) avatar generator, preferably PHP based. Inspired by the randomly generated github avatars, but unable to find a satisfactory pre-made solution, I did what I always do and took on the challenge from scratch. Here's the results of my simple PG-rated pixel-style avatar generator, with billions of possible combinations!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##Usage
|
|
It should be pretty straightforward to use-
|
|
|
|
```
|
|
// Avatar::render($size = 400, $gender = null, $id = null)
|
|
Avatar::render(200, 'male', 'some-reusable-identifier');
|
|
```
|
|
By using an identifier, you can re-generate the identical avatar by sending the same identifier (and gender) later. For my own purposes size is limited to 512 max width/height for performance reasons, but if you plan to generate and cache the avatars, you can go as big as you like!
|
|
|
|
If you want to use the output rather than render directly to the output stream, use `Avatar::generate` which returns the image resource.
|
|
|
|
##Photoshop file included
|
|
Under `graphics/` you'll find `avatars.psd`, a complete photoshop file that produced the layers using the image assets generator. You can add and remove layers, regenerate the layers and then replace the `images/` folder to use your own set. Just make sure the file names begin with the layer name. include `_m`, `_f`, or `_mf` at the end of the file name to designate the layer for Males, Females, or both respectively.
|
|
|
|
The generator is set to 20x20px layer sizes. If you create a brand new set with a different resolution you'll want to change the `AVATAR_SIZE` constant in avatar.php.
|
|
|
|
##More Examples
|
|
|
|
|
|
Enjoy!
|
|
|
|
Licensed under the MIT licence. See LICENSE for details.
|