Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/TakWolf/ark-pixel-font

Open source Pan-CJK pixel font / 开源的泛中日韩像素字体
https://github.com/TakWolf/ark-pixel-font

bitmap-font bitmap-fonts chinese chinese-simplified chinese-translation cjk font fonts game japanese korean pixel pixel-font pixel-fonts typeface

Last synced: 28 days ago
JSON representation

Open source Pan-CJK pixel font / 开源的泛中日韩像素字体

Lists

README

        

![banner](docs/readme-banner.png)

# 方舟像素字体 / Ark Pixel Font

[![License OFL](https://img.shields.io/badge/license-OFL--1.1-orange)](https://openfontlicense.org)
[![License MIT](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/licenses/MIT)
[![Releases](https://img.shields.io/github/v/release/TakWolf/ark-pixel-font)](https://github.com/TakWolf/ark-pixel-font/releases)
[![Itch.io](https://img.shields.io/badge/itch.io-ark--pixel--font-FF2449?logo=itch.io&logoColor=white)](https://takwolf.itch.io/ark-pixel-font)
[![Discord](https://img.shields.io/discord/949265373964947458?color=4E5AF0&logo=discord&logoColor=white&label=discord)](https://discord.gg/3GKtPKtjdU)
[![QQ Group](https://img.shields.io/badge/QQ群-302383204-brightgreen?logo=tencentqq&logoColor=white)](https://jq.qq.com/?_wv=1027&k=EXtKGHar)

开源的泛中日韩像素字体,黑体无衬线风格,支持 10、12 和 16 像素。

这个项目不仅提供了全部的字形源文件,也提供了构建字体所需要的完整程序。

> [!WARNING]
>
> 该字体目前处于积极开发阶段,仍然缺少大量汉字。
>
> 生产环境请考虑临时性过渡方案:[缝合像素字体](https://github.com/TakWolf/fusion-pixel-font)

> [!IMPORTANT]
>
> 这是一个开源项目,字体可以免费商用。
>
> 如果这个项目对您有帮助,请考虑 [赞助](#赞助) 来支持开发工作。

## 预览

可以通过 [Playground](https://ark-pixel-font.takwolf.com/playground.html) 实时预览字体效果。

### 10 像素

[示例文本](https://ark-pixel-font.takwolf.com/demo-10px.html) · [等宽模式-字母表](https://ark-pixel-font.takwolf.com/alphabet-10px-monospaced.html) · [比例模式-字母表](https://ark-pixel-font.takwolf.com/alphabet-10px-proportional.html)

![preview-10px](docs/preview-10px.png)

### 12 像素

[示例文本](https://ark-pixel-font.takwolf.com/demo-12px.html) · [等宽模式-字母表](https://ark-pixel-font.takwolf.com/alphabet-12px-monospaced.html) · [比例模式-字母表](https://ark-pixel-font.takwolf.com/alphabet-12px-proportional.html)

![preview-12px](docs/preview-12px.png)

### 16 像素

[示例文本](https://ark-pixel-font.takwolf.com/demo-16px.html) · [等宽模式-字母表](https://ark-pixel-font.takwolf.com/alphabet-16px-monospaced.html) · [比例模式-字母表](https://ark-pixel-font.takwolf.com/alphabet-16px-proportional.html)

![preview-16px](docs/preview-16px.png)

## 字符统计

可以通过下面的链接来查看字体各尺寸目前支持的字符情况。

| 尺寸 | 等宽模式 | 比例模式 |
|---|---|---|
| 10px | [font-info-10px-monospaced](docs/font-info-10px-monospaced.md) | [font-info-10px-proportional](docs/font-info-10px-proportional.md) |
| 12px | [font-info-12px-monospaced](docs/font-info-12px-monospaced.md) | [font-info-12px-proportional](docs/font-info-12px-proportional.md) |
| 16px | [font-info-16px-monospaced](docs/font-info-16px-monospaced.md) | [font-info-16px-proportional](docs/font-info-16px-proportional.md) |

## 尺寸

目前支持 10、12 和 16 三个像素尺寸。

字体的 `UPM`(`Units Per Em`,每个字面框包含的设计单位的数量)按照像素尺寸的 100 倍来转化,即:`1 px = 100 units` 。

字体各尺寸的 `UPM` 值如下:

| 尺寸 | UPM |
|---|---|
| 10px | 1000 |
| 12px | 1200 |
| 16px | 1600 |

在渲染时,请将文本尺寸设置为对应字体的像素尺寸或其整数倍,以保证栅格化时能够精确地进行像素转化。

## 宽度模式

目前支持「等宽」和「比例」两种模式。

### 「等宽」模式

字符为全宽或半宽,排版时可严格对其。字形完全处于字面框内部,默认行高等于字体的像素尺寸。

但基线位置略微偏高,中西文混排时西文在视觉上重心偏高,美观性略差。

### 「比例」模式

字符宽度根据字形实际情况变化,基线处于合适的位置。纵向上字形可能会超出字面框,默认行高大于字体的像素尺寸。

该模式排版观感自然,如无特殊需求,你应该优先选择这个模式。

字体各尺寸的默认行高如下:

| 尺寸 | 行高 |
|---|---|
| 10px | 16px |
| 12px | 18px |
| 16px | 24px |

## 语言特定字形

不同国家或地区,由于规范或书写习惯不同,同一个字符,字形可能存在差别。这种情况大部分为汉字,少量为标点符号。

目前支持以下语言特定字形版本:

| 版本 | 含义 | 说明 |
|---|---|---|
| latin | 拉丁语 | 在非中日韩环境下使用,标点符号采用西文习惯写法。 |
| zh_cn | 中文-中国大陆 | 字形采用中国大陆地区标准规范 [《通用规范汉字表》](https://www.moe.gov.cn/jyb_sjzl/ziliao/A19/201306/t20130601_186002.html) 中的写法。 |
| zh_hk | 中文-香港特别行政区 | 字形采用香港地区教育规范 [《常用字字形表》](https://zh.wikipedia.org/wiki/%E5%B8%B8%E7%94%A8%E5%AD%97%E5%AD%97%E5%BD%A2%E8%A1%A8) 中的写法。 |
| zh_tw | 中文-台湾地区 | 字形采用台湾地区教育规范 [《国字标准字体》](https://zh.wikipedia.org/wiki/%E5%9C%8B%E5%AD%97%E6%A8%99%E6%BA%96%E5%AD%97%E9%AB%94) 中的写法。 |
| zh_tr | 中文-传统印刷 | 字形采用 [「传统印刷体」](https://zh.wikipedia.org/wiki/%E8%88%8A%E5%AD%97%E5%BD%A2) 写法,符合香港和台湾地区传统使用习惯。 |
| ja | 日语 | 字形采用日本参考规范 [《常用汉字表》](https://zh.wikipedia.org/wiki/%E5%B8%B8%E7%94%A8%E6%BC%A2%E5%AD%97) 中的写法。 |
| ko | 朝鲜语 | |

## 下载

可通过以下渠道下载最新的版本:

- [GitHub Releases](https://github.com/TakWolf/ark-pixel-font/releases)
- [itch.io](https://takwolf.itch.io/ark-pixel-font)

目前提供 `.otf`、`.ttf`、`.woff2`、`.bdf`、`.pcf` 五种单字体格式,以及 `.otc`、`.ttc` 两种集合字体格式。

## 使用包管理器安装

### [Homebrew](https://brew.sh)

```shell
brew install font-ark-pixel-10px-monospaced
brew install font-ark-pixel-12px-monospaced
brew install font-ark-pixel-16px-monospaced

brew install font-ark-pixel-10px-proportional
brew install font-ark-pixel-12px-proportional
brew install font-ark-pixel-16px-proportional
```

## 本地构建

这是一个标准的 [Python3](https://www.python.org) 项目。

当您配置好运行环境后,执行 `python ./build.py` 命令来开始构建。

等待任务完成后,可在 `build/outputs` 目录下找到生成的字体文件。

## 授权许可

分为「字体」和「构建程序」两个部分。

### 字体

使用 [「SIL 开放字体许可证第 1.1 版」](LICENSE-OFL) 授权,保留字体名称「方舟像素 / Ark Pixel」。

### 构建程序

使用 [「MIT 许可证」](LICENSE-MIT) 授权。

## 官方社区

- [「像素字体工房」Discord 服务器](https://discord.gg/3GKtPKtjdU)
- [「像素字体工房」QQ 群 (302383204)](https://jq.qq.com/?_wv=1027&k=EXtKGHar)

## 程序依赖

- [Pixel Font Builder](https://github.com/TakWolf/pixel-font-builder)
- [Unidata Blocks](https://github.com/TakWolf/unidata-blocks)
- [Character Encoding Utils](https://github.com/TakWolf/character-encoding-utils)
- [PyPNG](https://gitlab.com/drj11/pypng)
- [Pillow](https://github.com/python-pillow/Pillow)
- [Beautiful Soup](https://www.crummy.com/software/BeautifulSoup/)
- [Jinja](https://github.com/pallets/jinja)
- [GitPython](https://github.com/gitpython-developers/GitPython)

## 字形依赖

- [像素字形 - 谚文音节](https://github.com/TakWolf/pixel-glyphs-hangul-syllables)
- [像素字形 - 盲文图案](https://github.com/TakWolf/pixel-glyphs-braille-patterns)

## 外部工具

- [SYMBL - Unicode 查询工具](https://symbl.cc)
- [字嗨 - 漢字部件檢索](https://zi-hi.com/sp/uni/CJKSeeker)
- [字統网 - 字形檢字](https://zi.tools/?secondary=search)
- [思源映射管理器](https://github.com/NightFurySL2001/shs-cid)

## 参考资料

- [字体开发最佳实践](https://silnrsi.github.io/FDBP/)
- [Microsoft - OpenType 字体文档](https://learn.microsoft.com/en-us/typography/opentype/)
- [Glyphs 软件教程 - 纵向量度值](https://glyphsapp.com/zh/learn/vertical-metrics)
- [FreeType 字形约定](https://freetype.org/freetype2/docs/glyphs/index.html)

## 赞助

如果这个项目对您有帮助,请考虑赞助来支持开发工作。

[![赞赏码](https://raw.githubusercontent.com/TakWolf/TakWolf/master/images/[email protected])](https://github.com/TakWolf/TakWolf/blob/master/payment-qr-codes.md)
[![爱发电](https://raw.githubusercontent.com/TakWolf/TakWolf/master/images/[email protected])](https://afdian.net/@takwolf)

请通过下面的链接来查看收到的赞助的具体情况:

[赞助详情](https://github.com/TakWolf/TakWolf/blob/master/sponsors.md)