dart_gp_tab_reader 0.2.0
dart_gp_tab_reader: ^0.2.0 copied to clipboard
Pure-Dart, read-only reader for Guitar Pro tablature files (GP3, GP4, GP5, and GP7/GP8 .gp). Parses them into a Song > Track > Measure > Voice > Beat > Note tree.
0.2.0 #
- Guitar Pro 7/8 (
.gp) support.parseGpnow detects the zip-based.gpcontainer by its bytes and parses theContent/score.gpifGPIF XML score into the sameSongtree as the GP3–5 readers. Covered: metadata, tempo (incl. mid-song tempo automations, mapped toMixTableChange.tempo), per-track tuning/capo/GM program/volume/pan, mid-song sound switches (Soundautomations →MixTableChange.instrument), percussion articulation mapping to GM drum keys, time signatures, repeats, section markers, anacrusis (pickup) bars, rests, ties, dead/ghost notes, palm mute, let ring, hammer-on/pull-off, slides, bends, harmonics, vibrato, slap/pop/tap and dynamics. Grace beats are skipped (they carry no bar time in GPIF). - New exports:
parseGp7(zip container) andparseGpif(barescore.gpifXML, useful for GP6.gpxpayloads unpacked by other means). - GP6
.gpx(BCFS/BCFZ container) is still not decoded, but is now rejected with a clearGpExceptioninstead of an "unsupported version" error. - New dependencies:
archive,xml.
0.1.1 #
- Added dartdoc comments across the public API (
models.dart): every model class, enum, constructor and key field is now documented (≈99% coverage). - No functional changes.
0.1.0 #
- Initial release.
- Pure-Dart, read-only reader for Guitar Pro GP3, GP4 and GP5 files.
- Parses into a
Song→Track→Measure→Voice→Beat→Notetree. - Dart port of PyGuitarPro; the binary parsing logic mirrors it closely. Test fixtures and the reference dump are taken from the PyGuitarPro test suite.