panako

type Cent int64

type EventPoint struct {

	// Time The time expressed using an analysis frame index.
	Time uint32

	// Frequency The frequency expressed using the bin number Instance.TransformBands in the constant Q transform (Cent).
	Frequency uint32

	// Magnitude The energy value of the element.
	Magnitude float32
}

type EventPointProcessor struct {
	audio.Sink
	// contains filtered or unexported fields
}

type Fingerprint struct {
	// contains filtered or unexported fields
}

type FingerprintHashType int

type Hertz float64

type Instance struct {
	//BlockSize size of audio blocks and buffers, in number of samples per channel, passed to lower backends. Needs to be a power of two.
	BlockSize int

	//SampleRate in Hertz. sample rate of audio that the processor and fingerprinter require/resample to.
	SampleRate Hertz

	//TransformMinimumFrequency in Hertz. Acts as base for all others frequencies with octave offsets
	TransformMinimumFrequency Hertz
	//TransformReferenceFrequencyOffset in octaves above TransformMinimumFrequency. Determines bin centers
	TransformReferenceFrequencyOffset Octave
	//TransformMaximumFrequencyOffset in octaves above TransformMinimumFrequency.
	TransformMaximumFrequencyOffset Octave

	//TransformBands in absolute band count. Do not change away from 512 unless you know what you are doing. Total amount of bins for all octaves from min to TransformMaximumFrequencyOctaves
	TransformBands int

	//TransformTimeResolution in absolute values. Time resolution of fingerprints/matches
	TransformTimeResolution time.Duration

	//QueryRange in absolute time bins / hash units(???) range. When searching for hash matches, use query hash value +- QueryRange value
	QueryRange int

	//QueryMinimumHitsBeforeFiltering and QueryMinimumHitsAfterFiltering probably require adjustment if any of TransformTimeResolution, QueryRange are changed
	//QueryMinimumHitsBeforeFiltering in count per resourceId. Minimum amount of hits for a match to be considered for further filtering.
	QueryMinimumHitsBeforeFiltering int
	//QueryMinimumHitsAfterFiltering in count per resourceId. Minimum amount of hits for a match to be considered after basic filtering.
	QueryMinimumHitsAfterFiltering int

	//QueryTimeRatioFactor in ratio factor. Any match with its time ratio below or above 1 +- this value will not be considered
	QueryTimeRatioFactor float64
	//QueryFrequencyRatioFactor in ratio factor. Any match with its frequency ratio below or above 1 +- this value will not be considered
	//TODO: maybe change this to work on Octave or Cent?
	QueryFrequencyRatioFactor float64

	//QueryDurationPercentageMinimum in absolute percentage. Any match with its duration % ratio below this value will not be considered
	QueryDurationPercentageMinimum float64
	//QueryDurationMinimum in absolute value. Any match with its absolute duration below this value will not be considered
	QueryDurationMinimum time.Duration

	QueryMaximumHitListSize    int
	QueryHitListDivisor        int
	QueryHitListDeltaTimeDepth int

	//PointFilterMaximumTimeFilterSize in samples from SampleRate. Must be odd
	PointFilterMaximumTimeFilterSize int
	//PointFilterMaximumTimeFilterSize in Cent units(???)
	PointFilterMaximumFrequencyFilterSize int

	//PointFilterMinimumTimeDistance in TransformTimeResolution units. EventPoint pairings below this time distance will not be considered
	PointFilterMinimumTimeDistance int
	//PointFilterMaximumTimeDistance in TransformTimeResolution units. EventPoint pairings above this time distance will not be considered
	PointFilterMaximumTimeDistance int
	//PointFilterMinimumFrequencyDistance in Cent. EventPoint pairings below this frequency distance will not be considered
	PointFilterMinimumFrequencyDistance Cent
	//PointFilterMaximumFrequencyDistance in Cent. EventPoint pairings above this frequency distance will not be considered
	PointFilterMaximumFrequencyDistance Cent

	//Other options
	//HashType select whether to use Fingerprint.Hash, Fingerprint.RobustHash or Fingerprint.CompactHash method when creating StoreRecord
	HashType FingerprintHashType
}

type MatchedRecord struct {
	Query StoreRecord
	Match StoreRecord
}

type Octave int

type QueryResult struct {

	//query info
	QueryStart time.Duration
	QueryStop  time.Duration

	//ref info
	ReferenceResourceId ResourceId
	ReferenceStart      time.Duration
	ReferenceStop       time.Duration

	//match info
	Score                       int
	TimeFactor                  float64
	FrequencyFactor             float64
	PercentOfSecondsWithMatches float64
}

type ResourceId uint64

type Store interface {
	GetPanakoMatch(record StoreRecord, lookupRange int) chan *MatchedRecord
	GetPanakoMatches(records []StoreRecord, lookupRange int) chan *MatchedRecord
	//GetPanakoRecords optional to implement
	GetPanakoRecords(resourceId ResourceId) []StoreRecord
	StorePanakoPrint(record StoreRecord)
	StorePanakoPrints(records []StoreRecord)
}

type StoreRecord struct {
	ResourceId ResourceId
	Hash       uint64
	Time       uint32
	Frequency  uint32
}

type Strategy struct {
	// contains filtered or unexported fields
}