VirtualProfiler.h

/*******************************************************************************
 *BSD 3-Clause License
 *
 *Copyright (c) 2016-2025, Mech-Mind Robotics Technologies Co., Ltd.
 *All rights reserved.
 *
 *Redistribution and use in source and binary forms, with or without
 *modification, are permitted provided that the following conditions are met:
 *
 *1. Redistributions of source code must retain the above copyright notice, this
 *   list of conditions and the following disclaimer.
 *
 *2. Redistributions in binary form must reproduce the above copyright notice,
 *   this list of conditions and the following disclaimer in the documentation
 *   and/or other materials provided with the distribution.
 *
 *3. Neither the name of the copyright holder nor the names of its
 *   contributors may be used to endorse or promote products derived from
 *   this software without specific prior written permission.
 *
 *THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 *DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
 *FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 *DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 *SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 *CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 *OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ******************************************************************************/
 
#pragma once
#include <memory>
#include <functional>
#include "api_global.h"
#include "ProfilerInfo.h"
#include "ProfileData.h"
#include "VirtualUserSet.h"
 
namespace mmind {
 
namespace eye {
 
class VirtualProfilerImpl;
 
class MMIND_API_EXPORT VirtualProfiler
{
public:
    using AcquisitionCallback = std::function<void(const ProfileBatch& batch, void* pUser)>;
 
    VirtualProfiler(const std::string& filePath);
 
    ~VirtualProfiler();
 
    VirtualProfiler(const VirtualProfiler& other) noexcept;
 
    VirtualProfiler& operator=(const VirtualProfiler& other) noexcept;
 
    ErrorStatus getProfilerInfo(ProfilerInfo& info) const;
 
    VirtualUserSet& currentUserSet();
 
    ErrorStatus retrieveBatchData(ProfileBatch& batch) const;
 
    ErrorStatus registerAcquisitionCallback(const VirtualProfiler::AcquisitionCallback& func,
                                            void* pUser);
 
    ErrorStatus startAcquisition();
 
    ErrorStatus stopAcquisition();
 
private:
    friend class InternalInterfaces;
    std::shared_ptr<VirtualProfilerImpl> _d;
};
 
} // namespace eye
 
} // namespace mmind