olaf_fp_matcher.h

Go to the documentation of this file.

// Olaf: Overly Lightweight Acoustic Fingerprinting
// Copyright (C) 2019-2025  Joren Six
 
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
 
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
 
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

 
#ifndef OLAF_FP_MATCHER_H
#define OLAF_FP_MATCHER_H
 
    #include "olaf_fp_extractor.h"
    #include "olaf_db.h"
    #include "olaf_config.h"
 
    
    typedef void (*Olaf_FP_Matcher_Result_Callback)(int matchCount, float queryStart, float queryStop, const char* path, uint32_t matchIdentifier, float referenceStart, float referenceStop);
    
    typedef struct Olaf_FP_Matcher Olaf_FP_Matcher;
 
    //Create a new matcher which matches incoming fingerprints with a database. 

    Olaf_FP_Matcher * olaf_fp_matcher_new(Olaf_Config * config,Olaf_DB* db,Olaf_FP_Matcher_Result_Callback callback );
    
    //Matches fingerprints to the database and updates internal state
    
    void olaf_fp_matcher_match(Olaf_FP_Matcher * olaf_fp_matcher, struct extracted_fingerprints * olaf_fps);
    
    void olaf_fp_matcher_print_header(Olaf_FP_Matcher * fp_matcher);

    void olaf_fp_matcher_callback_print_result(int matchCount, float queryStart, float queryStop, const char* path, uint32_t matchIdentifier, float referenceStart, float referenceStop);

    void olaf_fp_matcher_print_results(Olaf_FP_Matcher * olaf_fp_matcher);

    void olaf_fp_matcher_destroy(Olaf_FP_Matcher * olaf_fp_matcher);
 

    void olaf_fp_matcher_set_header(Olaf_FP_Matcher * fp_matcher, const char * header);
 
 
#endif // OLAF_FP_MATCHER_H