@@ -5,31 +5,31 @@ a tool to generate mahjong image
5
5
6
6
支持日麻/国标两种图案
7
7
8
- ![ 国标] ( https://mahjim .black-desk.cn/1s|1234567z?country=cn )
8
+ ![ 国标] ( https://mj .black-desk.cn/1s|1234567z?country=cn )
9
9
10
- ![ 日麻] ( https://mahjim .black-desk.cn/1s|1234567z| ?country=jp )
10
+ ![ 日麻] ( https://mj .black-desk.cn/1s|1234567z?country=jp )
11
11
12
12
支持吃,碰,明/暗杠的表示
13
13
14
- ![ _ 123s] ( https://mahjim .black-desk.cn/_123m )
14
+ ![ _ 123s] ( https://mj .black-desk.cn/_123m )
15
15
16
- ![ 2_22s] ( https://mahjim .black-desk.cn/2_22s )
16
+ ![ 2_22s] ( https://mj .black-desk.cn/2_22s )
17
17
18
- ![ 33_3p] ( https://mahjim .black-desk.cn/33_3p )
18
+ ![ 33_3p] ( https://mj .black-desk.cn/33_3p )
19
19
20
- ![ +2白+] ( https://mahjim .black-desk.cn/+2白+ )
20
+ ![ +2白+] ( https://mj .black-desk.cn/+2白+ )
21
21
22
- ![ +^中+] ( https://mahjim .black-desk.cn/+^中+ )
22
+ ![ +^中+] ( https://mj .black-desk.cn/+^中+ )
23
23
24
- ![ 发^发发] ( https://mahjim .black-desk.cn/^发2发 )
24
+ ![ 发^发发] ( https://mj .black-desk.cn/^发2发 )
25
25
26
26
牌背颜色有两种可选:
27
27
28
- ![ blue] ( https://mahjim .black-desk.cn/+?color=blue )
28
+ ![ blue] ( https://mj .black-desk.cn/+?color=blue )
29
29
30
- ![ orange] ( https://mahjim .black-desk.cn/+?color=orange )
30
+ ![ orange] ( https://mj .black-desk.cn/+?color=orange )
31
31
32
- 在我书写这个文档的时候, [ 这里] ( https://mahjim .black-desk.cn ) 有一个demo, 如果需要将这个工具应用在您的文章中, 请保存生成的图片, 而不要只留有一个链接在你的文档中.
32
+ 在我书写这个文档的时候, [ 这里] ( https://mj .black-desk.cn ) 有一个demo, 如果需要将这个工具应用在您的文章中, 请保存生成的图片, 而不要只留有一个链接在你的文档中.
33
33
34
34
你也可以将这个程序运行在你自己的电脑上, 来获得更稳定的体验.
35
35
@@ -39,11 +39,11 @@ a tool to generate mahjong image
39
39
40
40
### 使用方法
41
41
42
- 以上面提到的 demo 为实例, 我们简单学习一下如何使用这个工具, 它运行在 https://mahjim .black-desk.cn 这个地址, 你可以像这样来使用它:
42
+ 以上面提到的 demo 为实例, 我们简单学习一下如何使用这个工具, 它运行在 https://mj .black-desk.cn 这个地址, 你可以像这样来使用它:
43
43
44
- 字符串 ` 123m ` 代表 一万二万三万, 那么当你访问 https://mahjim .black-desk.cn/123m 就可以得到一张如下所示的图片:
44
+ 字符串 ` 123m ` 代表 一万二万三万, 那么当你访问 https://mj .black-desk.cn/123m 就可以得到一张如下所示的图片:
45
45
46
- ![ 123m] ( https://mahjim .black-desk.cn/123m )
46
+ ![ 123m] ( https://mj .black-desk.cn/123m )
47
47
48
48
本文档中的图片也都是这么生成的.
49
49
@@ -57,61 +57,61 @@ a tool to generate mahjong image
57
57
58
58
` 1234567z `
59
59
60
- ![ 1234567z] ( https://mahjim .black-desk.cn/1234567z| )
60
+ ![ 1234567z] ( https://mj .black-desk.cn/1234567z )
61
61
62
62
` 1234567z?country=cn ` :
63
63
64
- ![ 1234567z?country=cn] ( https://mahjim .black-desk.cn/1234567z?country=cn )
64
+ ![ 1234567z?country=cn] ( https://mj .black-desk.cn/1234567z?country=cn )
65
65
66
66
看几个简单的例子: 可以用 ` 1s2s3s ` 表示一条二条三条:
67
67
68
- ![ 1s2s3s] ( https://mahjim .black-desk.cn/1s2s3s )
68
+ ![ 1s2s3s] ( https://mj .black-desk.cn/1s2s3s )
69
69
70
70
和上面字牌的情况一样, 数字牌也支持简写, 比如 ` 123p ` 和 ` 1p2p3p ` 是等价的:
71
71
72
72
` 123p ` :
73
73
74
- ![ 123s] ( https://mahjim .black-desk.cn/123p )
74
+ ![ 123s] ( https://mj .black-desk.cn/123p )
75
75
76
76
` 1p2p3p ` :
77
77
78
- ![ 123p] ( https://mahjim .black-desk.cn/1p2p3p )
78
+ ![ 123p] ( https://mj .black-desk.cn/1p2p3p )
79
79
80
80
为了输入方便, 我们也可以直接用汉字来代表字牌, 例如 ` 白白白 ` 代表三张白:
81
81
82
82
` 白白白 ` :
83
83
84
- ![ 白白白] ( https://mahjim .black-desk.cn/白白白| ?country=jp )
84
+ ![ 白白白] ( https://mj .black-desk.cn/白白白?country=jp )
85
85
86
86
当然我们可以输入 ` 666z ` 来表示三张发:
87
87
88
88
` 666z ` :
89
89
90
- ![ 666z] ( https://mahjim .black-desk.cn/666z?country=jp )
90
+ ![ 666z] ( https://mj .black-desk.cn/666z?country=jp )
91
91
92
92
特别地,当使用汉字表示牌时可以简写, 例如 ` 3中 ` 和 ` 中中中 ` 也是等价的:
93
93
94
94
` 3中 ` :
95
95
96
- ![ 3中] ( https://mahjim .black-desk.cn/3中?country=jp )
96
+ ![ 3中] ( https://mj .black-desk.cn/3中?country=jp )
97
97
98
98
特别的, ` + ` 表示牌背:
99
99
100
100
` + ` :
101
101
102
- ![ +] ( https://mahjim .black-desk.cn/+?country=jp )
102
+ ![ +] ( https://mj .black-desk.cn/+?country=jp )
103
103
104
104
多个并排的牌背也可以简写, 比如 ` 4+ ` :
105
105
106
106
` 4+ ` :
107
107
108
- ![ 4+] ( https://mahjim .black-desk.cn/4+ )
108
+ ![ 4+] ( https://mj .black-desk.cn/4+ )
109
109
110
110
也支持春夏秋冬和梅兰竹菊, 但是不能以z的形式输入,只能使用汉字:
111
111
112
112
` 春夏秋冬梅兰竹菊 `
113
113
114
- ![ 春夏秋冬梅兰竹菊] ( https://mahjim .black-desk.cn/春夏秋冬梅兰竹菊 )
114
+ ![ 春夏秋冬梅兰竹菊] ( https://mj .black-desk.cn/春夏秋冬梅兰竹菊 )
115
115
116
116
汉字输入** 暂时不支持繁体**
117
117
@@ -121,49 +121,49 @@ a tool to generate mahjong image
121
121
122
122
当发生吃碰杠的时候, 有一些牌会被横置, 在以上规则的基础上, 用 ` _1m ` 表示横置的一万:
123
123
124
- ![ _ 1m] ( https://mahjim .black-desk.cn/_1m )
124
+ ![ _ 1m] ( https://mj .black-desk.cn/_1m )
125
125
126
126
那么我吃上家的 1m 形成的面子 123m, 可以如此表示
127
127
128
128
` _123m ` :
129
129
130
- ![ _ 123m] ( https://mahjim .black-desk.cn/_123m )
130
+ ![ _ 123m] ( https://mj .black-desk.cn/_123m )
131
131
132
132
碰的例子也类似:
133
133
134
134
` 中_中中 ` :
135
135
136
- ![ 中_中中] ( https://mahjim .black-desk.cn/中_中中 )
136
+ ![ 中_中中] ( https://mj .black-desk.cn/中_中中 )
137
137
138
138
而加杠形成的双横置以 ` ^ ` 表示, 例如 ` 2中^中 ` , 表示 碰下家的中之后加杠:
139
139
140
- ![ 2中^中] ( https://mahjim .black-desk.cn/2中^中 )
140
+ ![ 2中^中] ( https://mj .black-desk.cn/2中^中 )
141
141
142
142
当然, 使用 ` 77^7z ` , 也可以表示相同的事情:
143
143
144
- ![ 77^7z] ( https://mahjim .black-desk.cn/77^7z )
144
+ ![ 77^7z] ( https://mj .black-desk.cn/77^7z )
145
145
146
146
你也可以用另一种方式表示暗杠:
147
147
148
148
` +^中+ ` :
149
149
150
- ![ +^中+] ( https://mahjim .black-desk.cn/+^中+ )
150
+ ![ +^中+] ( https://mj .black-desk.cn/+^中+ )
151
151
152
152
本工具只是一个图片生成器, 并不检查牌是否合理, 所以实际上你也可以摆出一些很诡异的牌型, 比如:
153
153
154
154
` 2中^发2白 ` :
155
155
156
- ![ 2中^发白] ( https://mahjim .black-desk.cn/2中^发2白 )
156
+ ![ 2中^发白] ( https://mj .black-desk.cn/2中^发2白 )
157
157
158
158
` _6_6_6_6p ` :
159
159
160
- ![ _ 6_6_6_6p] ( https://mahjim .black-desk.cn/_6_6_6_6p )
160
+ ![ _ 6_6_6_6p] ( https://mj .black-desk.cn/_6_6_6_6p )
161
161
162
162
虽然不知道有什么用, 但是牌背是可以被横置的:
163
163
164
164
` _+ ` :
165
165
166
- ![ _ +] ( https://mahjim .black-desk.cn/_+ )
166
+ ![ _ +] ( https://mj .black-desk.cn/_+ )
167
167
168
168
169
169
@@ -173,37 +173,37 @@ a tool to generate mahjong image
173
173
174
174
可以在整个字符串的后面加上参数 ` country=cn ` 或者 ` country=jp ` 来说明希望生成 国标/日麻 图案, 如果不做说明默认是日麻图案, 例如以下分别是 ` 3白?country=cn ` 和 ` 3白?country=jp ` , 不添加此参数时默认为日麻图案.
175
175
176
- ![ 3发?country=cn] ( https://mahjim .black-desk.cn/3发s?country=cn )
176
+ ![ 3发?country=cn] ( https://mj .black-desk.cn/3发s?country=cn )
177
177
178
- ![ 3发?country=jp] ( https://mahjim .black-desk.cn/3发?country=jp )
178
+ ![ 3发?country=jp] ( https://mj .black-desk.cn/3发?country=jp )
179
179
180
180
这里展示一下两种风格下所有的牌画:
181
181
182
- ![ cn] ( https://mahjim .black-desk.cn/+123456789s123456789m123456789p1234567z春夏秋冬梅兰竹菊?country=cn&river=true&scale=0.7 )
182
+ ![ cn] ( https://mj .black-desk.cn/+123456789s123456789m123456789p1234567z春夏秋冬梅兰竹菊?country=cn&river=true&scale=0.7 )
183
183
184
- ![ jp] ( https://mahjim .black-desk.cn/+0123456789s0123456789m0123456789p1234567z?country=jp&river=true&scale=0.7 )
184
+ ![ jp] ( https://mj .black-desk.cn/+0123456789s0123456789m0123456789p1234567z?country=jp&river=true&scale=0.7 )
185
185
186
186
#### 缩小和放大 scale
187
187
188
188
默认生成的每张牌的大小为 70px x 100px, 如果需要更大或者更小的图片请使用缩放功能, 例如在整个字符串的最后加上参数 ` scale=1.2 ` 可以将图片放大为原来的 1.2 倍, 该参数不能大于 10, 如果输入了一个 >10 的参数, 那么返回结果就是一张 x10 的图, 以下分别是` 123m?scale=1.2 ` 和` 123m?scale=0.5 `
189
189
190
- ![ 123m?scale=1.2] ( https://mahjim .black-desk.cn/123m?scale=1.2 )
190
+ ![ 123m?scale=1.2] ( https://mj .black-desk.cn/123m?scale=1.2 )
191
191
192
- ![ 123m?scale=0.5] ( https://mahjim .black-desk.cn/123m?scale=0.5 )
192
+ ![ 123m?scale=0.5] ( https://mj .black-desk.cn/123m?scale=0.5 )
193
193
194
194
#### 牌背颜色 color
195
195
196
196
可以使用 ` color=orange ` 来获得橙色的牌背, 此参数不存在时默认为蓝色牌背.
197
197
198
- ![ +?color=orange] ( https://mahjim .black-desk.cn/+?color=orange )
198
+ ![ +?color=orange] ( https://mj .black-desk.cn/+?color=orange )
199
199
200
200
201
201
202
202
#### 牌河 river
203
203
204
204
参数` river=true ` 可以开启牌河生成模式, 牌河模式下 ` ^ ` 的意义是模切, ` _ ` 一样是横置, 一排放置 6 张牌,以下是` 1^233_4^5^6^7^8^9s?scale=0.7&river=true `
205
205
206
- ![ 1^233_4^5^6^7^8^9s^7^8^9m?scale=0.7&river=true] ( https://mahjim .black-desk.cn/1^233_4^5^6^7^8^9s^7^8^9m?scale=0.7&river=true )
206
+ ![ 1^233_4^5^6^7^8^9s^7^8^9m?scale=0.7&river=true] ( https://mj .black-desk.cn/1^233_4^5^6^7^8^9s^7^8^9m?scale=0.7&river=true )
207
207
208
208
出于实现方便, 立直牌靠下放置.
209
209
@@ -219,9 +219,9 @@ TODO: 这个功能目前并不完善, 比如立直之后本来应该默认就全
219
219
220
220
可以在牌与牌之间插入 ` | ` 来制造空隙, 每一个 ` | ` 是 1/10 个牌的宽度, 可以通过形如 ` 3| ` 的方式来增加间隙, 例如以下分别是 ` 123s|456p ` 和 ` 123s5|456p `
221
221
222
- ![ 123s|456p] ( https://mahjim .black-desk.cn/123s|456p )
222
+ ![ 123s|456p] ( https://mj .black-desk.cn/123s|456p )
223
223
224
- ![ 123s5|456p] ( https://mahjim .black-desk.cn/123s5|456p )
224
+ ![ 123s5|456p] ( https://mj .black-desk.cn/123s5|456p )
225
225
226
226
由于要使用` n| ` 的方式表示间隔的大小 ,所以 123m 456m 并不能写成 ` 123|456m ` . 需要写成 ` 123m|456m `
227
227
0 commit comments