locatorpass.h

//##################################################################################################
//
// Copyright (c) 2024 Beijing Qiongqi Tech Co.,Ltd. All rights reserved.
 
// This source code is confidential and proprietary to Beijing Qiongqi Tech Co.,Ltd(The Holder).
// Any unauthorized use, copying, modification, or distribution of the code is strictly prohibited.
// Any user shall obtain authorizaition from the Holder before modifying the source code. And the user shall not
// sublicense, sell, distribute, or transfer the source code, whether in original or modified form, to any third party
// without the prior written consent of the Holder.
 
// This copyright notice and permission grant shall be included in all copies or substantial portions of the source code.
 
// Author  Cumulia Illustrator
// Date    2025-08-05
// Version V2.1.0
//##################################################################################################
 
#pragma once
 
#include "locator.h"
#include "handler.h"
 
#include <cilcore.h>
 
#include <memory>
#include <tuple>
 
namespace cil
{
    class LocatorPass : public Pass
    {
    public:
        LocatorPass(const std::shared_ptr<Background>& background, const std::shared_ptr<Camera>& camera);
        virtual ~LocatorPass();
 
        void add(const std::shared_ptr<AbstractLocator>& locator) const;
        void remove(const std::shared_ptr<AbstractLocator>& locator) const;
        void clear() const;
        bool begin(const Ray& r, Locator::Modifier modifier = Locator::Modifier::None);
        bool update(const Ray& r);
        bool end(const Ray& r);
 
        void bind(const std::string& name, std::function<void()> callback);
        void unbind(const std::string& name);
        void send(const std::string& name);
 
        std::shared_ptr<Locator> activeLocator() const;
        void setHandlerNormal(const Color3f& color);
        Color3f handlerNormal() const;
        void setHandlerHilited(const Color3f& color);
        Color3f handlerHilited() const;
        void setLocatorOutline(const Color3f& color);
        Color3f locatorOutline() const;
        void setLocatorOutface(const Color3f& color);
        Color3f locatorOutface() const;
 
    private:
        Ray findRay(const Ray& r, const Matrix4f& m);
        std::tuple<std::shared_ptr<Locator>, std::shared_ptr<Handler>> hit(const Ray& r);
        bool hilite(const Ray& r);
        void updateHandlerColor();
 
    private:
        float m_devicePixelRatio;
        Locator::Modifier m_modifier;
        std::shared_ptr<Locator> m_actived;
        std::shared_ptr<Handler> m_hilited;
        Matrix4f m_initial;
        std::function<void()> m_onHilited;
        std::function<void()> m_onBegun;
        std::function<void()> m_onUpdated;
        std::function<void()> m_onEnded;
    };
 
    std::shared_ptr<LocatorPass> _locatorPass(const std::shared_ptr<Background>& background, const std::shared_ptr<Camera>& camera);
}