Jsonaea 2025.5.9__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,218 @@
1
+ Metadata-Version: 2.1
2
+ Name: Jsonaea
3
+ Version: 2025.5.9
4
+ Summary: 将Arcaea游戏中铺面文件(x.aff)转换为json文件,亦可将json文件转换回铺面文件的实用库
5
+ Home-page: https://github.com/321bug/Jsonaea
6
+ Author: Begloon(321bug)
7
+ Author-email: bugbugbug321@163.com
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: License :: OSI Approved :: MIT License
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.0
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+
15
+ ***Jsonaea*** *script by* ***Begloon.***
16
+
17
+ # 简介
18
+ **Jsonaea**为可将Arcaea游戏中铺面文件(``x.aff``)转换为json文件 / 字典,亦可将json文件 / 字典转换回铺面文件的实用库。
19
+ 其理论上可读取并转换aff文件中的任何语句(目前除注释外),并无损地将其互相转换。
20
+ 此库使用``Python``编写。
21
+ 此库还有一个``Tools``附加库,内含多种不必要但减少代码量的实用函数。
22
+
23
+ ## 快速使用
24
+ 在github本项目上直接下载后手动安装。
25
+ 在 [本页面](https://github.com/321bug/Jsonaea/tree/main/dist) 下载最新版本的两个打包中任意一个
26
+ 然后在终端中输入命令:
27
+ ```
28
+ pip install 下载的文件本地路径
29
+ ```
30
+
31
+ ---
32
+ 在py文件中导入库:
33
+ ```python
34
+ import jsonaea
35
+ ```
36
+ ---
37
+ 使用load函数生成字典:
38
+ ```python
39
+ load(arcPath)
40
+ ```
41
+ ``arcPath``: Arcaea铺面文件导入路径
42
+ 此函数将返回一个字典。
43
+
44
+ ---
45
+ 使用createJson函数生成json文件
46
+ ```python
47
+ createJson(dict,JsonPath)
48
+ ```
49
+ `dict`:创建json文件的字典
50
+ `JsonPath`:创建json文件的路径
51
+ 此函数不返回值,会创建一个json文件。
52
+
53
+ ---
54
+ 导出生成的json文件 / 字典为``.aff``文件:
55
+ ```python
56
+ output(arcJson,arcPath)
57
+ ```
58
+ ``arcJson``: 提供的json文件(字典)
59
+ ``arcPath``: Arcaea铺面文件导出路径
60
+ 此函数不返回值,会创建一个``.aff``文件。
61
+
62
+ ### 示例
63
+ jsonaea库使用的具体示例,以下代码可将铺面中的arc全部转化为蛇:
64
+ ```python
65
+ import tkinter as tk
66
+ from tkinter import filedialog
67
+ from jsonaea import *
68
+
69
+ #生成铺面导入窗口
70
+ root = tk.Tk()
71
+ root.withdraw ()
72
+ arcPath = filedialog.askopenfilename ()
73
+
74
+ #导入铺面
75
+ arc = load(arcPath)
76
+ #设置Tools库全局变量
77
+ Tools.arcJson = arc
78
+ #检索所有黑线事件
79
+ searchedEvent = Tools.searchEventSubject({"type":"arc","IsSkyline": True})
80
+ #并将其全部转化为蛇
81
+ for se in searchedEvent:
82
+ Tools.changeEvent(se,{"IsSkyline":False})
83
+ #导出铺面
84
+ output(arc,"./noSkyline.aff")
85
+ #导出处理完的Json文件
86
+ createJson(arc, "./this.json")
87
+ input("已完成")
88
+ ```
89
+
90
+ # json文件 / 字典格式
91
+ ```json
92
+ {
93
+ "META":{},
94
+ "Camera":[],
95
+ "Scenecontrol":[],
96
+ "TimingList":[
97
+ {
98
+ "tags":[],
99
+ "notes":[],
100
+ "timing":[],
101
+ }
102
+ ]
103
+ }
104
+ ```
105
+ - META字典:
106
+ 存储铺面文件头,如:
107
+ ```json
108
+ "AudioOffset": 0,
109
+ "TimingPointDensityFactor":2
110
+ ```
111
+ - Camera列表:
112
+ 存储铺面摄像头信息,如:
113
+ ```json
114
+ "time": 0,
115
+ "transverse": 0.0,
116
+ "bottomzoom": 0.0,
117
+ "linezoom": 0.0,
118
+ "steadyangle": 0.0,
119
+ "topzoom": 0.0,
120
+ "angle": 0.0,
121
+ "easing": "reset",
122
+ "lastingtime": 1
123
+ ```
124
+ 详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍
125
+ 多个字典以列表形式存储
126
+
127
+ - Scenecontrol列表:
128
+ 存储铺面Scenecontrol事件信息,如:
129
+ ```json
130
+ "time": 0,
131
+ "type": "arcahvdistort",
132
+ "param": [
133
+ 1.25,
134
+ 0
135
+ ]
136
+ ```
137
+ 其中``"param"``项在没有参数时不会生成,详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍
138
+ 多个字典以列表形式存储
139
+ - TimingList列表:
140
+ 存储无timinggroup与timinggroup组的事件
141
+ 在该列表中无timinggroup的下标为0,timinggroup组的下标≥1(如果铺面中无timinggroup组,则该列表中只有下标为零的字典)
142
+ 多个字典以列表形式存储,字典中存有key为``"tags"``,``"notes"``与``"timing"``的三个列表
143
+ 当在该列表中下标为0的字典中(即无timinggroup的事件),``"tags"``中无参数。
144
+ - tags
145
+ 在aff文件``timinggroup(){};``中小括号中的标识,一般用于对timinggroup中的事件达成特殊效果(如noinput)
146
+ 字典格式如:
147
+ ```json
148
+ "noinput",
149
+ "anglex200"
150
+ ```
151
+
152
+ - notes
153
+ note事件,分为``tap``、``hold``、``arc``三个类型,由key值``"type"``区分
154
+ 其中``tap``的字典格式如:
155
+ ```json
156
+ "type": "tap",
157
+ "time": 0,
158
+ "track": 1
159
+ ```
160
+ 其中track指轨道,目前无法读取track为小数的tap事件
161
+
162
+ 其中``hold``的字典格式如:
163
+ ```json
164
+ "type": "hold",
165
+ "startTime": 0,
166
+ "endTime": 1000,
167
+ "track": 3
168
+ ```
169
+ 其中track指轨道,目前无法读取track为小数的hold事件
170
+
171
+ 其中``arc``的字典格式如:
172
+ ```json
173
+ "type": "arc",
174
+ "startTime": 0,
175
+ "endTime": 1000,
176
+ "startPos": [
177
+ 0.5,
178
+ 1.0
179
+ ],
180
+ "endPos": [
181
+ 1.0,
182
+ 1.0
183
+ ],
184
+ "arcType": "si",
185
+ "color": "blue",
186
+ "hitsound": "none",
187
+ "IsSkyline": true
188
+ ```
189
+ 其中``"startPos"``与``"endPos"``列表中下标为0的参数时坐标x,下标为1的为坐标y
190
+ ``"arcType"``是指该arc的滑动方式
191
+ ``"hitsound"``为该arc上arctap的打击音,如果有填以铺面的相对路径,如果没有填none
192
+ ``"IsSkyline"``为该arc是否为黑线,反之为蛇
193
+ 如果该arc上有arctap,那么将在下方添加键值对,如:
194
+ ```json
195
+ "arctap": [
196
+ 200,
197
+ 600
198
+ ]
199
+ ```
200
+ 列表中存储着该arc上所有arctap的时间,其范围在startTime与endTime之间
201
+
202
+ - timing
203
+ 控制铺面的bpm(流速)与beat(小节线)
204
+ 其格式如:
205
+ ```json
206
+ "time": 0,
207
+ "BPM": 191.0,
208
+ "metreInfo": 4.0
209
+ ```
210
+ 其中``"metreInfo"``是指表示每多少个四分拍为一小节,并出现一条小节线
211
+ 多个字典以列表形式存储
212
+
213
+ 对以上任何信息如有困惑,详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍。
214
+
215
+ # 特别声明
216
+ **本项目只对Arcaea铺面文件进行解读,关于Arcaea铺面使用与更改的最终解释权归Arcaea版权方lowiro所有。**
217
+ **任何通过通过本项目对游戏内铺面的改写与本项目无关,一切责任归使用者所有。**
218
+ **本项目版权归程序编写者Begloon(321bug)所有。**
@@ -0,0 +1,7 @@
1
+ LICENSE
2
+ README.md
3
+ setup.py
4
+ Jsonaea.egg-info/PKG-INFO
5
+ Jsonaea.egg-info/SOURCES.txt
6
+ Jsonaea.egg-info/dependency_links.txt
7
+ Jsonaea.egg-info/top_level.txt
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2023 Begloon(321bug)
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,218 @@
1
+ Metadata-Version: 2.1
2
+ Name: Jsonaea
3
+ Version: 2025.5.9
4
+ Summary: 将Arcaea游戏中铺面文件(x.aff)转换为json文件,亦可将json文件转换回铺面文件的实用库
5
+ Home-page: https://github.com/321bug/Jsonaea
6
+ Author: Begloon(321bug)
7
+ Author-email: bugbugbug321@163.com
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: License :: OSI Approved :: MIT License
10
+ Classifier: Operating System :: OS Independent
11
+ Requires-Python: >=3.0
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+
15
+ ***Jsonaea*** *script by* ***Begloon.***
16
+
17
+ # 简介
18
+ **Jsonaea**为可将Arcaea游戏中铺面文件(``x.aff``)转换为json文件 / 字典,亦可将json文件 / 字典转换回铺面文件的实用库。
19
+ 其理论上可读取并转换aff文件中的任何语句(目前除注释外),并无损地将其互相转换。
20
+ 此库使用``Python``编写。
21
+ 此库还有一个``Tools``附加库,内含多种不必要但减少代码量的实用函数。
22
+
23
+ ## 快速使用
24
+ 在github本项目上直接下载后手动安装。
25
+ 在 [本页面](https://github.com/321bug/Jsonaea/tree/main/dist) 下载最新版本的两个打包中任意一个
26
+ 然后在终端中输入命令:
27
+ ```
28
+ pip install 下载的文件本地路径
29
+ ```
30
+
31
+ ---
32
+ 在py文件中导入库:
33
+ ```python
34
+ import jsonaea
35
+ ```
36
+ ---
37
+ 使用load函数生成字典:
38
+ ```python
39
+ load(arcPath)
40
+ ```
41
+ ``arcPath``: Arcaea铺面文件导入路径
42
+ 此函数将返回一个字典。
43
+
44
+ ---
45
+ 使用createJson函数生成json文件
46
+ ```python
47
+ createJson(dict,JsonPath)
48
+ ```
49
+ `dict`:创建json文件的字典
50
+ `JsonPath`:创建json文件的路径
51
+ 此函数不返回值,会创建一个json文件。
52
+
53
+ ---
54
+ 导出生成的json文件 / 字典为``.aff``文件:
55
+ ```python
56
+ output(arcJson,arcPath)
57
+ ```
58
+ ``arcJson``: 提供的json文件(字典)
59
+ ``arcPath``: Arcaea铺面文件导出路径
60
+ 此函数不返回值,会创建一个``.aff``文件。
61
+
62
+ ### 示例
63
+ jsonaea库使用的具体示例,以下代码可将铺面中的arc全部转化为蛇:
64
+ ```python
65
+ import tkinter as tk
66
+ from tkinter import filedialog
67
+ from jsonaea import *
68
+
69
+ #生成铺面导入窗口
70
+ root = tk.Tk()
71
+ root.withdraw ()
72
+ arcPath = filedialog.askopenfilename ()
73
+
74
+ #导入铺面
75
+ arc = load(arcPath)
76
+ #设置Tools库全局变量
77
+ Tools.arcJson = arc
78
+ #检索所有黑线事件
79
+ searchedEvent = Tools.searchEventSubject({"type":"arc","IsSkyline": True})
80
+ #并将其全部转化为蛇
81
+ for se in searchedEvent:
82
+ Tools.changeEvent(se,{"IsSkyline":False})
83
+ #导出铺面
84
+ output(arc,"./noSkyline.aff")
85
+ #导出处理完的Json文件
86
+ createJson(arc, "./this.json")
87
+ input("已完成")
88
+ ```
89
+
90
+ # json文件 / 字典格式
91
+ ```json
92
+ {
93
+ "META":{},
94
+ "Camera":[],
95
+ "Scenecontrol":[],
96
+ "TimingList":[
97
+ {
98
+ "tags":[],
99
+ "notes":[],
100
+ "timing":[],
101
+ }
102
+ ]
103
+ }
104
+ ```
105
+ - META字典:
106
+ 存储铺面文件头,如:
107
+ ```json
108
+ "AudioOffset": 0,
109
+ "TimingPointDensityFactor":2
110
+ ```
111
+ - Camera列表:
112
+ 存储铺面摄像头信息,如:
113
+ ```json
114
+ "time": 0,
115
+ "transverse": 0.0,
116
+ "bottomzoom": 0.0,
117
+ "linezoom": 0.0,
118
+ "steadyangle": 0.0,
119
+ "topzoom": 0.0,
120
+ "angle": 0.0,
121
+ "easing": "reset",
122
+ "lastingtime": 1
123
+ ```
124
+ 详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍
125
+ 多个字典以列表形式存储
126
+
127
+ - Scenecontrol列表:
128
+ 存储铺面Scenecontrol事件信息,如:
129
+ ```json
130
+ "time": 0,
131
+ "type": "arcahvdistort",
132
+ "param": [
133
+ 1.25,
134
+ 0
135
+ ]
136
+ ```
137
+ 其中``"param"``项在没有参数时不会生成,详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍
138
+ 多个字典以列表形式存储
139
+ - TimingList列表:
140
+ 存储无timinggroup与timinggroup组的事件
141
+ 在该列表中无timinggroup的下标为0,timinggroup组的下标≥1(如果铺面中无timinggroup组,则该列表中只有下标为零的字典)
142
+ 多个字典以列表形式存储,字典中存有key为``"tags"``,``"notes"``与``"timing"``的三个列表
143
+ 当在该列表中下标为0的字典中(即无timinggroup的事件),``"tags"``中无参数。
144
+ - tags
145
+ 在aff文件``timinggroup(){};``中小括号中的标识,一般用于对timinggroup中的事件达成特殊效果(如noinput)
146
+ 字典格式如:
147
+ ```json
148
+ "noinput",
149
+ "anglex200"
150
+ ```
151
+
152
+ - notes
153
+ note事件,分为``tap``、``hold``、``arc``三个类型,由key值``"type"``区分
154
+ 其中``tap``的字典格式如:
155
+ ```json
156
+ "type": "tap",
157
+ "time": 0,
158
+ "track": 1
159
+ ```
160
+ 其中track指轨道,目前无法读取track为小数的tap事件
161
+
162
+ 其中``hold``的字典格式如:
163
+ ```json
164
+ "type": "hold",
165
+ "startTime": 0,
166
+ "endTime": 1000,
167
+ "track": 3
168
+ ```
169
+ 其中track指轨道,目前无法读取track为小数的hold事件
170
+
171
+ 其中``arc``的字典格式如:
172
+ ```json
173
+ "type": "arc",
174
+ "startTime": 0,
175
+ "endTime": 1000,
176
+ "startPos": [
177
+ 0.5,
178
+ 1.0
179
+ ],
180
+ "endPos": [
181
+ 1.0,
182
+ 1.0
183
+ ],
184
+ "arcType": "si",
185
+ "color": "blue",
186
+ "hitsound": "none",
187
+ "IsSkyline": true
188
+ ```
189
+ 其中``"startPos"``与``"endPos"``列表中下标为0的参数时坐标x,下标为1的为坐标y
190
+ ``"arcType"``是指该arc的滑动方式
191
+ ``"hitsound"``为该arc上arctap的打击音,如果有填以铺面的相对路径,如果没有填none
192
+ ``"IsSkyline"``为该arc是否为黑线,反之为蛇
193
+ 如果该arc上有arctap,那么将在下方添加键值对,如:
194
+ ```json
195
+ "arctap": [
196
+ 200,
197
+ 600
198
+ ]
199
+ ```
200
+ 列表中存储着该arc上所有arctap的时间,其范围在startTime与endTime之间
201
+
202
+ - timing
203
+ 控制铺面的bpm(流速)与beat(小节线)
204
+ 其格式如:
205
+ ```json
206
+ "time": 0,
207
+ "BPM": 191.0,
208
+ "metreInfo": 4.0
209
+ ```
210
+ 其中``"metreInfo"``是指表示每多少个四分拍为一小节,并出现一条小节线
211
+ 多个字典以列表形式存储
212
+
213
+ 对以上任何信息如有困惑,详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍。
214
+
215
+ # 特别声明
216
+ **本项目只对Arcaea铺面文件进行解读,关于Arcaea铺面使用与更改的最终解释权归Arcaea版权方lowiro所有。**
217
+ **任何通过通过本项目对游戏内铺面的改写与本项目无关,一切责任归使用者所有。**
218
+ **本项目版权归程序编写者Begloon(321bug)所有。**
@@ -0,0 +1,204 @@
1
+ ***Jsonaea*** *script by* ***Begloon.***
2
+
3
+ # 简介
4
+ **Jsonaea**为可将Arcaea游戏中铺面文件(``x.aff``)转换为json文件 / 字典,亦可将json文件 / 字典转换回铺面文件的实用库。
5
+ 其理论上可读取并转换aff文件中的任何语句(目前除注释外),并无损地将其互相转换。
6
+ 此库使用``Python``编写。
7
+ 此库还有一个``Tools``附加库,内含多种不必要但减少代码量的实用函数。
8
+
9
+ ## 快速使用
10
+ 在github本项目上直接下载后手动安装。
11
+ 在 [本页面](https://github.com/321bug/Jsonaea/tree/main/dist) 下载最新版本的两个打包中任意一个
12
+ 然后在终端中输入命令:
13
+ ```
14
+ pip install 下载的文件本地路径
15
+ ```
16
+
17
+ ---
18
+ 在py文件中导入库:
19
+ ```python
20
+ import jsonaea
21
+ ```
22
+ ---
23
+ 使用load函数生成字典:
24
+ ```python
25
+ load(arcPath)
26
+ ```
27
+ ``arcPath``: Arcaea铺面文件导入路径
28
+ 此函数将返回一个字典。
29
+
30
+ ---
31
+ 使用createJson函数生成json文件
32
+ ```python
33
+ createJson(dict,JsonPath)
34
+ ```
35
+ `dict`:创建json文件的字典
36
+ `JsonPath`:创建json文件的路径
37
+ 此函数不返回值,会创建一个json文件。
38
+
39
+ ---
40
+ 导出生成的json文件 / 字典为``.aff``文件:
41
+ ```python
42
+ output(arcJson,arcPath)
43
+ ```
44
+ ``arcJson``: 提供的json文件(字典)
45
+ ``arcPath``: Arcaea铺面文件导出路径
46
+ 此函数不返回值,会创建一个``.aff``文件。
47
+
48
+ ### 示例
49
+ jsonaea库使用的具体示例,以下代码可将铺面中的arc全部转化为蛇:
50
+ ```python
51
+ import tkinter as tk
52
+ from tkinter import filedialog
53
+ from jsonaea import *
54
+
55
+ #生成铺面导入窗口
56
+ root = tk.Tk()
57
+ root.withdraw ()
58
+ arcPath = filedialog.askopenfilename ()
59
+
60
+ #导入铺面
61
+ arc = load(arcPath)
62
+ #设置Tools库全局变量
63
+ Tools.arcJson = arc
64
+ #检索所有黑线事件
65
+ searchedEvent = Tools.searchEventSubject({"type":"arc","IsSkyline": True})
66
+ #并将其全部转化为蛇
67
+ for se in searchedEvent:
68
+ Tools.changeEvent(se,{"IsSkyline":False})
69
+ #导出铺面
70
+ output(arc,"./noSkyline.aff")
71
+ #导出处理完的Json文件
72
+ createJson(arc, "./this.json")
73
+ input("已完成")
74
+ ```
75
+
76
+ # json文件 / 字典格式
77
+ ```json
78
+ {
79
+ "META":{},
80
+ "Camera":[],
81
+ "Scenecontrol":[],
82
+ "TimingList":[
83
+ {
84
+ "tags":[],
85
+ "notes":[],
86
+ "timing":[],
87
+ }
88
+ ]
89
+ }
90
+ ```
91
+ - META字典:
92
+ 存储铺面文件头,如:
93
+ ```json
94
+ "AudioOffset": 0,
95
+ "TimingPointDensityFactor":2
96
+ ```
97
+ - Camera列表:
98
+ 存储铺面摄像头信息,如:
99
+ ```json
100
+ "time": 0,
101
+ "transverse": 0.0,
102
+ "bottomzoom": 0.0,
103
+ "linezoom": 0.0,
104
+ "steadyangle": 0.0,
105
+ "topzoom": 0.0,
106
+ "angle": 0.0,
107
+ "easing": "reset",
108
+ "lastingtime": 1
109
+ ```
110
+ 详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍
111
+ 多个字典以列表形式存储
112
+
113
+ - Scenecontrol列表:
114
+ 存储铺面Scenecontrol事件信息,如:
115
+ ```json
116
+ "time": 0,
117
+ "type": "arcahvdistort",
118
+ "param": [
119
+ 1.25,
120
+ 0
121
+ ]
122
+ ```
123
+ 其中``"param"``项在没有参数时不会生成,详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍
124
+ 多个字典以列表形式存储
125
+ - TimingList列表:
126
+ 存储无timinggroup与timinggroup组的事件
127
+ 在该列表中无timinggroup的下标为0,timinggroup组的下标≥1(如果铺面中无timinggroup组,则该列表中只有下标为零的字典)
128
+ 多个字典以列表形式存储,字典中存有key为``"tags"``,``"notes"``与``"timing"``的三个列表
129
+ 当在该列表中下标为0的字典中(即无timinggroup的事件),``"tags"``中无参数。
130
+ - tags
131
+ 在aff文件``timinggroup(){};``中小括号中的标识,一般用于对timinggroup中的事件达成特殊效果(如noinput)
132
+ 字典格式如:
133
+ ```json
134
+ "noinput",
135
+ "anglex200"
136
+ ```
137
+
138
+ - notes
139
+ note事件,分为``tap``、``hold``、``arc``三个类型,由key值``"type"``区分
140
+ 其中``tap``的字典格式如:
141
+ ```json
142
+ "type": "tap",
143
+ "time": 0,
144
+ "track": 1
145
+ ```
146
+ 其中track指轨道,目前无法读取track为小数的tap事件
147
+
148
+ 其中``hold``的字典格式如:
149
+ ```json
150
+ "type": "hold",
151
+ "startTime": 0,
152
+ "endTime": 1000,
153
+ "track": 3
154
+ ```
155
+ 其中track指轨道,目前无法读取track为小数的hold事件
156
+
157
+ 其中``arc``的字典格式如:
158
+ ```json
159
+ "type": "arc",
160
+ "startTime": 0,
161
+ "endTime": 1000,
162
+ "startPos": [
163
+ 0.5,
164
+ 1.0
165
+ ],
166
+ "endPos": [
167
+ 1.0,
168
+ 1.0
169
+ ],
170
+ "arcType": "si",
171
+ "color": "blue",
172
+ "hitsound": "none",
173
+ "IsSkyline": true
174
+ ```
175
+ 其中``"startPos"``与``"endPos"``列表中下标为0的参数时坐标x,下标为1的为坐标y
176
+ ``"arcType"``是指该arc的滑动方式
177
+ ``"hitsound"``为该arc上arctap的打击音,如果有填以铺面的相对路径,如果没有填none
178
+ ``"IsSkyline"``为该arc是否为黑线,反之为蛇
179
+ 如果该arc上有arctap,那么将在下方添加键值对,如:
180
+ ```json
181
+ "arctap": [
182
+ 200,
183
+ 600
184
+ ]
185
+ ```
186
+ 列表中存储着该arc上所有arctap的时间,其范围在startTime与endTime之间
187
+
188
+ - timing
189
+ 控制铺面的bpm(流速)与beat(小节线)
190
+ 其格式如:
191
+ ```json
192
+ "time": 0,
193
+ "BPM": 191.0,
194
+ "metreInfo": 4.0
195
+ ```
196
+ 其中``"metreInfo"``是指表示每多少个四分拍为一小节,并出现一条小节线
197
+ 多个字典以列表形式存储
198
+
199
+ 对以上任何信息如有困惑,详见 [ARCAEA中文维基](https://wiki.arcaea.cn/) 中对谱面格式的介绍。
200
+
201
+ # 特别声明
202
+ **本项目只对Arcaea铺面文件进行解读,关于Arcaea铺面使用与更改的最终解释权归Arcaea版权方lowiro所有。**
203
+ **任何通过通过本项目对游戏内铺面的改写与本项目无关,一切责任归使用者所有。**
204
+ **本项目版权归程序编写者Begloon(321bug)所有。**
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,29 @@
1
+ import setuptools #导入setuptools打包工具
2
+
3
+ with open("README.md", "r", encoding="utf-8") as fh:
4
+ long_description = fh.read()
5
+
6
+ def processDate(date:int):
7
+ date = str(date)
8
+ year = "20" + date[:1]
9
+ month = str(int(date[2:3]))
10
+ day = str(int(date[4:5]))
11
+ return "%s.%s.%s"%(year,month,day)
12
+
13
+ setuptools.setup(
14
+ name="Jsonaea", # 用自己的名替换其中的YOUR_USERNAME_
15
+ version="2025.5.9", #包版本号,便于维护版本
16
+ author="Begloon(321bug)", #作者,可以写自己的姓名
17
+ author_email="bugbugbug321@163.com", #作者联系方式,可写自己的邮箱地址
18
+ description="将Arcaea游戏中铺面文件(x.aff)转换为json文件,亦可将json文件转换回铺面文件的实用库",#包的简述
19
+ long_description=long_description, #包的详细介绍,一般在README.md文件内
20
+ long_description_content_type="text/markdown",
21
+ url="https://github.com/321bug/Jsonaea", #自己项目地址,比如github的项目地址
22
+ packages=setuptools.find_packages(),
23
+ classifiers=[
24
+ "Programming Language :: Python :: 3",
25
+ "License :: OSI Approved :: MIT License",
26
+ "Operating System :: OS Independent",
27
+ ],
28
+ python_requires='>=3.0', #对python的最低版本要求
29
+ )