GuitarPrometheus::Parser::GpFileParser

Native Guitar Pro 7 / 8 (.gp) importer. More…

#include <GpFileParser.h>

Inherits from GuitarPrometheus::Parser::IScoreImporter

Public Functions

	Name
virtual Result	import(const std::filesystem::path & file) const override Import a `.gp` (Guitar Pro 7 / 8) 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::GpFileParser;

Native Guitar Pro 7 / 8 (.gp) importer.

Opens the file as a ZIP archive, extracts the inner Content/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 .gp (Guitar Pro 7 / 8) file from disk.

Parameters:

file Absolute path to the .gp archive.

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 (missing score.gpif, malformed ZIP, etc.). Warnings collected by [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