ArcaeaChartRender

Another chart previewing library for Arcaea.

requirements

pydantic~=1.9.1
Pillow~=9.1.1
opencv-python~=4.5.5.64
numpy~=1.23.0
pyparsing~=3.0.9
pytest~=7.2.2(for test only, remove it if you don't need to run tests)

pip install -r requirements.txt

Usage

Render an Arcaea Chart simply.

change your theme

Before using, you need to copy and rename theme.py to theme_local.py, and edit theme_local.py to locate assets file.

If a property of BaseTheme is inherited by one of its subclasses (e.g. LightTheme), you should modify the property on its subclass. If the property is not inherited, then you should modify it directly on BaseTheme.

name	file
`font_Exo_SemiBold_XX`	`Exo-SemiBold.ttf`
`font_Kazesawa_Regular_XX`	`Kazesawa-Regular.ttf`
`font_SourceHanMonoSC_Regular_XX`	`SourceHanMonoSC-Regular.otf`
`tile_path`	`track.png` and `track_dark.png`
`tap_path`	`note.png` and `note_dark.png`
`hold_path`	`note_hold.png` and `note_hold_dark.png`
`arctap_path`	`tap_l.png` and `tap_d.png`
`arctap_sfx_path`	`sfx_l_note.jpg` and `sfx_d_note.jpg`
`default_bg_path`	`base_light.jpg` and `base_conflict.jpg`
`custom_bg_dir_path`	put your custom background here if `bg` field has been defined in songlist

⚠ Note:
This repo does NOT provide these assets files, you need to obtain them by yourself. It is recommended to get them at Arcaea-Infinity/OpenArcaeaArts (Licensed under CC BY-NC).

render chart with a `songlist`

When rendering the official chart, you deserve to have a songlist from which you can build the song metadata.

from ArcaeaChartRender.render import Render
from ArcaeaChartRender.utils import fetch_song_info

render = Render(
    aff_path='./songs/panicbounceattack/2.aff',
    cover_path='./songs/panicbounceattacki/base.jpg',
    song=fetch_song_info('./songs/songlist', 'panicbounceattack'),
    difficulty=2,
    constant=7.0,
)

render.show()
render.save('panicbounceattack_2.png')

render chart without `songlist`

In some cases, you may not be conscious of creating a songlist (e.g. fan-made chart), then you can use the Song model instead of the fetch_song_info() function.

from ArcaeaChartRender.render import Render
from ArcaeaChartRender.model import Song

my_song = Song(
    **{
        "id": "panicbounceattack",
        "idx": 0,
        "title_localized": {
            "en": "PANIC! BOUNCE!! ATTACK!!!"
        },
        "artist": "3R2 feat. ptar124",
        "bpm": "248",
        "bpm_base": 248,
        "set": "base",
        "purchase": "",
        "audioPreview": 94798,
        "audioPreviewEnd": 110250,
        "side": 0,
        "bg": "shiawase2",
        "version": "3.12.6",
        "date": 1649603401,
        "difficulties": [
            {
                "ratingClass": 2,
                "chartDesigner": "Rabi-MisakaChan",
                "jacketDesigner": "Misaka12456\naffected by\nYumemochi",
                "rating": 10,
                "ratingPlus": True
            }
        ]
    }
)

render = Render(
    aff_path='./songs/panicbounceattack/2.aff',
    cover_path='./songs/panicbounceattacki/base.jpg',
    song=my_song,
    difficulty=2,
    constant=7.0,
)

render.show()
render.save('panicbounceattack_2.png')

Example

The yellow area means that the BPM in that area is not equal to the bpm_base of the song.

Side Usage

In addition to rendering charts, you can use the library to do the following things.

chart syntax check

A minimal syntax check for individual commands in a chart.

from ArcaeaChartRender.aff.decoder import parse_aff
from ArcaeaChartRender.utils import read_file

chart = parse_aff(read_file('./songs/panicbounceattacki/2.aff'))
for cmd in chart.command_list:
    print(cmd.syntax_check(), cmd)

chart statistics

Statistical information such as combo calculation.

See element.py for more information.

from ArcaeaChartRender.aff.decoder import parse_aff
from ArcaeaChartRender.element import Tap
from ArcaeaChartRender.utils import read_file

chart = parse_aff(read_file('./songs/panicbounceattacki/2.aff'))
print(chart.get_total_combo())
print(chart.get_combo_of(Tap))
print(chart.get_bpm_proportion())
print(chart.get_interval())
...

aff plain text parsing

Compose your Arcaea chart by Python DSL, and easily convert plain text of aff file to dict or list.

See aff_parsing.py for more information.

from ArcaeaChartRender.aff.parsing import command
from ArcaeaChartRender.utils import read_file

content = read_file('./songs/panicbounceattacki/2.aff')
print(command.parse_string(content).as_dict())
print(command.parse_string(content).as_list())
...

TODO

beautify text style (at text area)
add support for segmented combo count (per bar)
add support for custom background (when Song.bg field is not None)
other chart statistics (density, multi-finger, crossed hand, etc.)

License

BOFXVI - PANIC! BOUNCE! ATTACK!!! from Arcaea-Infinity/FanmadeCharts under 616 SB License
Aff2Preview from Arcaea-Infinity/Aff2Preview under 616 SB License
pyparsing from pyparsing/pyparsing under MIT License
opencv2 from opencv/opencv-python under MIT License
Pillow from python-pillow/Pillow under HPND License

This project is licensed under the terms of the 616 SB License.

Rosemoe/ArcaeaChartRender