GuitarPrometheus::Parser::GpxFileParser

Native Guitar Pro 6 (.gpx) importer. More…

#include <GpxFileParser.h>

Inherits from GuitarPrometheus::Parser::IScoreImporter

Public Functions

	Name
virtual Result	import(const std::filesystem::path & file) const override Import a `.gpx` (Guitar Pro 6) file from disk.

Additional inherited members

Public Functions inherited from GuitarPrometheus::Parser::IScoreImporter

	Name
virtual	~IScoreImporter() =default
virtual Result	importMemory(const std::uint8_t * bytes, std::size_t size) const Parse a score from raw bytes already in memory.

Detailed Description

class GuitarPrometheus::Parser::GpxFileParser;

Native Guitar Pro 6 (.gpx) importer.

Decodes the BCFZ-compressed BCFS sector filesystem via [GpxFileSystem](/api-reference/classes/classguitarprometheus_1_1parser_1_1gpxfilesystem/), extracts the inner score.gpif XML payload, and feeds it to the shared [GpifReader](/api-reference/classes/classguitarprometheus_1_1parser_1_1gpifreader/). The reader emits an [IntermediateScore](/api-reference/classes/structguitarprometheus_1_1parser_1_1intermediatescore/), which [ScoreBuilder::build](/api-reference/classes/classguitarprometheus_1_1parser_1_1scorebuilder/#function-build) finalises into the immutable Score.

Stateless and cheap to construct — instantiate one per import call rather than caching.

Public Functions Documentation

function import

virtual Result import(
    const std::filesystem::path & file
) const override

Import a .gpx (Guitar Pro 6) file from disk.

Parameters:

file Absolute path to the .gpx container.

Return: A [Result](/api-reference/classes/structguitarprometheus_1_1parser_1_1result/) with the parsed Score on success, or a list of error diagnostics describing why the import failed (BCFZ decompression failure, missing score.gpif, payload exceeding the 256 MB cap, etc.). Warnings from [GpifReader](/api-reference/classes/classguitarprometheus_1_1parser_1_1gpifreader/) are forwarded but do not affect success.

Reimplements: GuitarPrometheus::Parser::IScoreImporter::import

Updated on 2026-05-29 at 07:39:52 +0000