Skip to content
Create material deisgn avatars for users just like Google Messager. It may not be unique but looks better than Identicon or Gravatar.
Branch: master
Clone or download
Latest commit 04caff3 Nov 9, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
avatars Fixed a bug in demo. Apr 30, 2015
src
tools Fixed compatibility issue in low version PHP(5.3 or lower) May 1, 2015
.gitignore 增加Psr-4命名空间,方便在composer中直接依赖使用 May 4, 2016
.travis.yml Update .travis.yml Nov 9, 2017
LICENSE License Apr 30, 2015
README.md update usage Nov 4, 2017
avatar.php Automatic testing. Nov 22, 2016
composer.json Automatic testing. Nov 22, 2016
demo.php 增加Psr-4命名空间,方便在composer中直接依赖使用 May 4, 2016

README.md

Material-Design-Avatars Build Status

Create material deisgn avatars for users just like Google Messager.

It may not be unique but looks better than Identicon or Gravatar.

Online Demo

Language Support

ENGLISH

JTZW

FTZW

RIYU

Screenshot

Carbon Forum

Carbon Forum

Android Client for Carbon Forum

Android Client for Carbon Forum

Requirements

Initialize

<?php
require(dirname(__FILE__) . "/src/MDAvatars.php");
/*
'X'         : The character that you want to fill to the avatar.
512 (pixel) : The size of the avatar.
*/
$Avatar = new Md\MDAvatars('X', 512);
?>

Or initialize with composer:

{
	"require": {
		"lincanbin/material-design-avatars": "*.*"
	}
}
<?php
// composer 
require(__DIR__ . "/vendor/autoload.php");
use Md\MDAvatars;

$Avatar = new MDAvatars('X', 512);
?>

Usage

Show you avatar in the browser

<?php
$Avatar->Output2Browser();
?>
<?php
// You can resize the ouput size again here.
$OutputSize = 256;
$Avatar->Output2Browser($OutputSize);
// Output Base64 encoded image data.
$Avatar->Output2Base64($OutputSize);
// Get an image resource identifier.
$Avatar->Output2ImageResource($OutputSize);
?>

Save avatar to a file

<?php
$Avatar->Save('./avatars/Avatar.png');
//You can resize the size you want to save again here.
$Avatar->Save('./avatars/Avatar256.png', 256);
$Avatar->Save('./avatars/Avatar128.png', 128);
$Avatar->Save('./avatars/Avatar64.png', 64);
?>

Free memory

<?php
$Avatar->Free();
?>

Notice

If you do not need Chinese support, you can delete src/fonts/SourceHanSansCN-Normal.ttf.

When you input a Chinese character, it will automatically extract the first letter of the pinyin of the Chinese character instead of the original input if you deleted src/fonts/SourceHanSansCN-Normal.ttf.

$Avatar = new MDAvtars('', 512);//The pinyin of "林" is "Lin".

This will be the same as that below if you deleted src/fonts/SourceHanSansCN-Normal.ttf.

$Avatar = new MDAvtars('L', 512);//The first letter of that pinyin is "Lin".

Fonts

Source Code Pro

Source Han Sans

License

Copyright 2015 Canbin Lin (lincanbin@hotmail.com)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.