github.com/insionng/yougam@v0.0.0-20170714101924-2bc18d833463/libraries/identicon/doc.go (about)

     1  // Copyright 2015 by caixw, All rights reserved.
     2  // Use of this source code is governed by a MIT
     3  // license that can be found in the LICENSE file.
     4  
     5  // 一个基于hash值生成随机图像的包。
     6  //
     7  // 关于identicon并没有统一的标准，一般用于在用户注册时，
     8  // 取用户的邮箱或是访问IP等数据(也可以是其它任何数据)，
     9  // 进行hash运算，之后根据hash数据，产生一张图像，
    10  // 这样即可以为用户产生一张独特的头像，又不会泄漏用户的隐藏。
    11  //
    12  // 在identicon中，把图像分成以下九个部分:
    13  //  -------------
    14  //  | 1 | 2 | 3 |
    15  //  -------------
    16  //  | 4 | 5 | 6 |
    17  //  -------------
    18  //  | 7 | 8 | 9 |
    19  //  -------------
    20  // 其中1、3、9、7为不同角度(依次增加90度)的同一张图片，
    21  // 2、6、8、4也是如此，这样可以保持图像是对称的，比较美观。
    22  // 5则单独使用一张图片。
    23  //
    24  //  // 根据用户访问的IP，为其生成一张头像
    25  //  img, _ := identicon.Make(128, color.NRGBA{},color.NRGBA{}, []byte("192.168.1.1"))
    26  //  fi, _ := os.Create("/tmp/u1.png")
    27  //  png.Encode(fi, img)
    28  //  fi.Close()
    29  //
    30  //  // 或者
    31  //  ii, _ := identicon.New(128, color.NRGBA{}, color.NRGBA{}, color.NRGBA{})
    32  //  img := ii.Make([]byte("192.168.1.1"))
    33  //  img = ii.Make([]byte("192.168.1.2"))
    34  //
    35  // NOTE: go test 会在当前目录的testdata文件夹下产生大量的随机图片。
    36  // 要运行测试，必须保证该文件夹是存在的，且有相应的写入权限。
    37  package identicon