geo_pattern

Q: 同一字符串每次生成的图案一样吗？

一样。字符串被转成 SHA 哈希，颜色、图案类型和元素尺寸都由哈希值决定，相同输入与参数始终得到相同 SVG。

Q: base_color 和 color 有什么区别？

base_color 会在该基色上按哈希偏移色相和饱和度；color 则直接使用指定背景色，不做任何偏移调整。

Q: 生成的图案能用作网页背景吗？

可以把它作为容器的 background-image，使用 base64 形式内嵌仍是 SVG 渲染，在高分屏上依然清晰。

Q: 这个项目还在维护吗？

README 说明项目已基本停止维护，仅接受 PR 维持可用，安装与使用不受影响，但生产使用前建议自行验证兼容性。

输入一段字符串，生成可复现的几何背景图

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 87 🐛 待处理 1 👀 关注 18

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1273

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源免费

项目预览

geo_pattern 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类图像生成

开发团队jasonlong

官网地址http://jasonlong.github.io/geo_pattern

GitHubhttps://github.com/jasonlong/geo_pattern

定价模式🏷️完全免费

价格说明开源免费

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Ruby

技术栈/模型generative,procedural,ruby,visualization

GitHub 星标★ 1273

上线时间2014-01-27 00:00:00

代码更新2026-10-21

仓库体积1.7 MB

本站数据更新2026-11-03

维护状态较活跃

收录时间2026-11-03

浏览次数0

项目介绍

geo_pattern 是一个 Ruby 库，可根据任意字符串确定性地生成几何图案背景图，相同输入始终得到相同图案。它解决的是为应用快速提供稳定、可复现的视觉标识问题，例如用用户名、文章标题或哈希值生成专属头像底图、卡片背景或占位图。核心能力包括：基于字符串哈希驱动图案参数，内置多种几何图案类型（如重叠圆、三角形、波浪、马赛克等），支持自定义颜色、尺寸与图案样式，输出 SVG 矢量图，便于无损缩放和嵌入网页。项目以 Ruby 实现，API 简洁，适合在 Rails 等服务端场景中直接调用，无需外部图像服务。由于图案由算法生成而非随机图片，同一标识在多次渲染中保持一致，适合做用户身份或内容指纹的视觉化表达。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-11-03 · 当前星标 ★ 1273

技术标签

generative procedural ruby visualization

使用教程

难度：入门约 10 分钟部署方式：库/依赖 7 步

环境要求

Ruby 2.6 或更高版本
Ruby 自带的 gem 包管理器
如需从源码跑测试，需安装 Bundler 与 rake
依赖 color gem，1.x 与 2.x 版本均支持

安装与启动步骤

1检查 Ruby 版本

GeoPattern 要求 Ruby 2.6 或更高，先确认本机版本满足要求再安装。
```
ruby -v
```
2安装 gem

用 gem 命令全局安装 geo_pattern，即可在任意 Ruby 脚本中引用。
```
gem install geo_pattern
```
3用 Bundler 安装

已有 Ruby 项目时，先在 Gemfile 中添加 gem 'geo_pattern'，再执行安装。
```
bundle install
```
4生成第一个图案

调用 GeoPattern.generate 传入字符串，再用 to_svg 取得 SVG 字符串内容。
```
ruby -e "require 'geo_pattern'; puts GeoPattern.generate('Mastering Markdown').to_svg"
```
5自定义颜色

base_color 指定基色并自动调整色相饱和度；color 则直接固定背景色。
```
ruby -e "require 'geo_pattern'; puts GeoPattern.generate('Mastering Markdown', base_color: '#fc0').to_svg"
```
6指定图案类型

patterns 可传单个图案符号，也可传符号数组限定可选的图案范围。
```
ruby -e "require 'geo_pattern'; puts GeoPattern.generate('Mastering Markdown', patterns: :sine_waves).to_svg"
```
7运行自带测试

在源码仓库目录下运行测试，确认安装和运行环境正常。
```
bundle exec rake test
```

关键配置

配置项	必填	说明	示例
`base_color`	否	指定基色，色相与饱和度会按字符串哈希自动偏移	`#fc0`
`color`	否	固定背景色，不再做色相与饱和度调整	`#fc0`
`patterns`	否	指定图案生成器，可传单个符号或符号数组	`:sine_waves`