Core public API for the Denigma conversion libraries. More...

Namespaces
namespace	classify
	Music classification helpers for Finale symbol extraction.

namespace	formats
	Conversion adapters for Denigma output formats.

Classes
class	BufferRandomAccessReader
	Random-access reader backed by caller-owned memory. More...

struct	CommonOptions
	Options common to all public converter adapters. More...

struct	ConversionRequest
	Type-erased request used by registry-based converter calls. More...

struct	ConversionResult
	Result metadata returned after a conversion completes. More...

class	ConverterRegistry
	Lightweight registry for locating converters by source and target format. More...

struct	Diagnostic
	A non-fatal message emitted by a converter. More...

class	FileRandomAccessReader
	Random-access reader backed by a filesystem file. More...

class	IConverter
	Public interface implemented by each conversion adapter. More...

class	IMultiOutputConverter
	Public interface implemented by adapters that may produce multiple output documents. More...

class	IOptions
	Base class for adapter-specific option structs. More...

class	IRandomAccessReader
	Random-access byte reader used for container formats such as MUSX. More...

class	IReaderConverter
	Public interface implemented by adapters whose input is a random-access container. More...

class	IReaderMultiOutputConverter
	Public interface implemented by reader-backed adapters that may produce multiple output documents. More...

Typedefs
using	MultiOutputCallback = std::function< void(std::string_view suggestedName, std::span< const std::byte > data)>
	Callback used by converters that may emit zero, one, or many output buffers.

Enumerations
enum class	FormatId { Musx , EnigmaXml , MnxJson , MusicXml , MssXml , Svg }
	Stable identifiers for converter input and output formats. More...

enum class	MessageSeverity { Info , Warning , Error , Verbose }
	Severity for log messages and diagnostics emitted by converters.

Functions
template<typename OptionsT >
OptionsT	optionsFromRequest (const ConversionRequest &request, std::string_view converterName)
	Returns typed options from an erased request, or default options when none were supplied.

Detailed Description

Core public API for the Denigma conversion libraries.

Enumeration Type Documentation

strong

Stable identifiers for converter input and output formats.

Enumerator
Musx	Finale MUSX archive.
EnigmaXml	Finale Enigma XML.
MnxJson	MNX JSON as produced by mnxdom.
MusicXml	MusicXML score-partwise XML.
MssXml	MuseScore style sheet XML.
Svg	Scalable Vector Graphics XML.

template<typename OptionsT >

OptionsT denigma::optionsFromRequest	(	const ConversionRequest &	request,
		std::string_view	converterName
	)

Returns typed options from an erased request, or default options when none were supplied.

Exceptions

std::invalid_argument if the request contains incompatible options.