lincanbin/material-design-avatars

Create material deisgn avatars for users just like Google Messager. It may not be unique but looks better than Identicon or Gravatar.

Material-Design-Avatars

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

Screenshot

Carbon Forum

Android Client for Carbon Forum

Requirements

• The PHP GD library.

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 ([email protected])

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.

material-design-avatars's Issues

字体文件坏掉了

头像显示不了文字，发现是fonts文件夹中的字体文件坏掉了 ，我把Carbon-Forum中相应的字体文件复制过来覆盖就可以了

如果我需要两个字，那个偏移应该怎么办？

偏移的规则是怎么计算的呢？

生成头像方式问题

可以通过用户上传图片，生成头像？还是只能通过字来生成头像

Composer中添加无Psr-4命名空间

代码中看到已经支持了Psr-4，但在实际使用时，通过composer安装后的包里还是不支持Psr-4。composer update lincanbin/material-design-avatars--prefer-source 也不行，能否解决一下？

有没有办法生成正方形的头像

css控制已经有圆角了

使用汉字时strtoupper会破坏掉字符

https://github.com/lincanbin/Material-Design-Avatars/blob/master/src/MDAvatars.php#L32

$this->Char            = strtoupper(mb_substr($Char, 0, 1, "UTF-8"));

这块的strtoupper是起到什么作用的呢？

Md\MDAvatars Object
(
    [Char] => Ʊ�
    [AvatarSize] => 512
    [Padding] => 60
    [Avatar] => Resource id #5
    [FontFile] => /Users/kslr/Develop/Material-Design-Avatars/src/fonts/SourceHanSansCN-Normal.ttf
    [IsNotLetter] => 1
    [LetterFont] => /Users/kslr/Develop/Material-Design-Avatars/src/fonts/SourceCodePro-Light.ttf
    [AsianFont] => /Users/kslr/Develop/Material-Design-Avatars/src/fonts/SourceHanSansCN-Normal.ttf
    [EnableAsianChar] => 1
)

移除 strtoupper

➜  Material-Design-Avatars git:(master) ✗ php test.php
Md\MDAvatars Object
(
    [Char] => 你
    [AvatarSize] => 512
    [Padding] => 60
    [Avatar] => Resource id #5
    [FontFile] => /Users/kslr/Develop/Material-Design-Avatars/src/fonts/SourceHanSansCN-Normal.ttf
    [IsNotLetter] => 1
    [LetterFont] => /Users/kslr/Develop/Material-Design-Avatars/src/fonts/SourceCodePro-Light.ttf
    [AsianFont] => /Users/kslr/Develop/Material-Design-Avatars/src/fonts/SourceHanSansCN-Normal.ttf
    [EnableAsianChar] => 1
)

发现文档中有一句“
注意 “字母” 与当前所在区域有关。例如，在默认的 “C” 区域，字符 umlaut-a（ä）就不会被转换。”
http://php.net/manual/zh/function.strtoupper.php
是否和这个有关系呢？

env | grep LC_CTYPE
LC_CTYPE=zh_CN.UTF-8

ReadMe

麻烦打一个标签在Packagist上发布下

现在只有dev分支才有更新

https://packagist.org/packages/lincanbin/material-design-avatars