# Handright

**Repository Path**: liuxingluoer/Handright

## Basic Information

- **Project Name**: Handright
- **Description**: A lightweight Python library for simulating Chinese handwriting
- **Primary Language**: Python
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2019-08-17
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Handright
___A lightweight Python library for simulating Chinese handwriting___

[![released version](https://img.shields.io/pypi/v/Handright.svg)][pypi]
[![python version](https://img.shields.io/pypi/pyversions/Handright.svg)][pypi]
[![license](https://img.shields.io/github/license/Gsllchb/Handright.svg)][license]
[![build status](https://travis-ci.org/Gsllchb/Handright.svg?branch=master)](https://travis-ci.org/Gsllchb/Handright)
[![downloads](https://img.shields.io/pypi/dm/Handright.svg)](https://pypistats.org/packages/handright)

[Tutorial][tutorial] |
[Release Notes][release-notes] |
[Contributing][contributing]

![](https://github.com/Gsllchb/Handright/blob/master/docs/images/slogan.png)

## Vision
Reveal the nature of Chinese handwriting and use it to implement beautiful, simple and easy-to-use interfaces.

## Algorithm
首先，在水平位置、竖直位置和字体大小三个自由度上，对每个字的整体做随机扰动。随后，在水平位置、竖直位置和旋转角度三个自由度上，对每个字的每个笔画做随机扰动。

## Installation
```console
pip install handright
```

## Quick Start
```python
from PIL import Image, ImageFont

from handright import Template, handwrite

text = "我能吞下玻璃而不伤身体。"
template = Template(
    background=Image.new(mode="1", size=(1024, 2048), color=1),
    font_size=100,
    font=ImageFont.truetype("path/to/my/font.ttf"),
)
for image in handwrite(text, template):
    image.show()

```
更多信息请参阅[Tutorial][tutorial]。


[tutorial]: https://github.com/Gsllchb/Handright/blob/master/docs/tutorial.md
[PIL]: http://www.pythonware.com/products/pil/
[Pillow]: http://python-pillow.org/
[release-notes]: https://github.com/Gsllchb/Handright/blob/master/docs/release_notes.md
[pypi]: https://pypi.org/project/handright/
[license]: https://github.com/Gsllchb/Handright/blob/master/LICENSE
[contributing]: https://github.com/Gsllchb/Handright/blob/master/.github/CONTRIBUTING.md