/************************************************************************
 *
 * Copyright (C) 2014-2025 IRCAD France
 * Copyright (C) 2014-2020 IHU Strasbourg
 *
 * This file is part of Sight.
 *
 * Sight is free software: you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Sight 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with Sight. If not, see <https://www.gnu.org/licenses/>.
 *
 ***********************************************************************/

#pragma once

#include <sight/viz/scene3d/config.hpp>

#include "viz/scene3d/layer.hpp"
#include "viz/scene3d/utils.hpp"
#include "viz/scene3d/window_interactor.hpp"

#include <data/image.hpp>

#include <viz/__/render.hpp>

#include <OGRE/OgreAxisAlignedBox.h>

#include <map>
#include <tuple>

namespace sight::viz::scene3d
{

class adaptor;
class layer;

/**
 * @brief The generic scene service shows adaptors in a 3D Ogre scene.
 *
 * @section Signals Signals
 * - \b compositorUpdated(): sent when the compositor chain is modified.
 * - \b fullscreen_set(bool): sent when fullscreen is enabled/disabled.
 *
 * @section Slots Slots
 * - \b computeCameraParameters(): resets the camera position to visualize the whole scene.
 * - \b reset_cameras(): resets all layers camera.
 * - \b reset_camera_LAYER_ID(): "LAYER_ID" needs to be changed with your actual layer id. Resets the camera of the
 * layer
 * specified by LAYER_ID.
 * - \b render(): render the scene immediately, when the service is configured in manual render mode.
 * - \b request_render(): request the service to repaint the scene. DEPRECATED, use render() instead.
 * - \b disable_fullscreen(): switches to windowed rendering if fullscreen is enabled.
 * - \b enable_fullscreen(int): switches fullscreen rendering on the given screen.
 * - \b set_manual_mode(): switches to manual mode, the scene is rendered whenever the request_render() slot is called.
 * - \b set_auto_mode(): switches to auto mode, the scene is rendered whenever an adaptor decides it.
 *
 * @section XML XML Configuration
 * @code{.xml}
    <service uid="..." type="sight::viz::scene3d::render" auto_connect="true">
        <scene renderMode="auto">
            <background topColor="#000000" bottomColor="#FFFFFF" topScale="0.7" bottomScale="1.0"/>

            <layer id="...">
                <viewport hOffset="0.03" vOffset="0.03" width="0.3" height="0.3" hAlign="right" vAlign="top"/>
                <adaptor uid="..."/>
            </layer>
            <layer id="..." compositors="Invert;Laplace;Posterize" defaultLight="false" overlays="...">
                <adaptor uid="..."/>
            </layer>
        </scene>
    </service>
   @endcode
 *
 * @subsection In-Out In-Out
 * - \b offscreen [sight::data::image] (optional, unused by default): If used, render the scene in an image
 *      and not in a window.
 *
 * @subsection Configuration Configuration
 *  - \b scene (mandatory)
 *      - \b renderMode (optional, auto/manual, default=auto): 'auto' (when any of the adaptor calls "request_render",
 *           i.e. when its data has changed), or 'manual' (only when the slot "request_render" is called). This can also
 *           be changed at runtime with setManualMode and setAutoMode slots.
 *      - \b width (optional, int, default=1280): width for off-screen rendering.
 *      - \b height (optional, int, default=720): height for off-screen rendering.
 *  - \b background (optional): defines the scene background color.
 *      - \b color (optional, hexadecimal, default=#000000): color of the background, can't be used with topColor and
 *           bottomColor.
 *      - \b topColor (optional, hexadecimal, default=#000000): top color of the background.
 *      - \b bottomColor (optional, hexadecimal, default=#000000): top color of the background.
 *      - \b topScale (optional, float, default=0): top background scale.
 *      - \b bottomScale (optional, float, default=1): bottom background scale.
 *      - \b material (optional): overrides the default gradient material. Provide the name of the Ogre material.
 *  - \b layer (mandatory): defines the scene's layer.
 *      - \b viewport (optional):
 *          - \b hAlign (optional, left|center|right, default=left): defines the horizontal origin of the viewport.
 *          - \b vAlign (optional, top|center|bottom, default=top): defines the vertical origin of the viewport.
 *          - \b hOffset (optional, float, default=0.f): horizontal offset from the origin relatively to the window.
 *          - \b vOffset (optional, float, default=0.f): vertical offset from the origin relatively to the window.
 *          - \b width (optional, float, default=1.f): viewport width relatively to the window.
 *          - \b height (optional, float, default=1.f): viewport height relatively to the window.
 *    - \b id (mandatory, string): the identifier of the layer
 *    - @deprecated- \b depth (mandatory, int): deprecated, please use order instead.
 *    - \b order (mandatory, int): layer order to stack, starting from 1. The layer with the lowest order will be
 *         rendered first, and so the layer with the highest order will be displayed on top.
 *    - \b transparency (optional, DepthPeeling/DualDepthPeeling/WeightedBlended/HybridTransparency/
 *         CelShadingDepthPeeling, default=""): the transparency technique to use.
 *    - \b numPeels (optional, string, default=""): number of peels for the selected transparency technique.
 *         Not used for WeightedBlended OIT
 *    - \b compositors (optional, string): defines the default compositor chain. Compositors are separated by semicolons
 *    - \b fullscreen (optional, bool, default=false): Show the scene in full screen.
 *    - \b stereoMode (optional, false/AutoStereo5/AutoStereo8/Stereo, default=false): Sets the mode used for
 * stereoscopic 3D
 *         rendering.
 *    - \b defaultLight (optional, true/false, default=true): Sets if a default light is created in the layer.
 *    - \b overlays (optional, string): list of overlay names (separated by semicolons) rendered on top of the layer's
 *         viewport.
 *    - \b adaptor
 *      - \b uid (mandatory): the identifier of the adaptor.
 */
class SIGHT_VIZ_SCENE3D_CLASS_API render final : public viz::render
{
public:

    /// Generates default methods as New, dynamicCast, ...
    SIGHT_DECLARE_SERVICE(render, viz::render);

    /// Represents all possible render modes.
    enum class render_mode : std::uint8_t
    {
        AUTO,
        manual
    };

    struct signals
    {
        using key_t                       = sight::core::com::signals::key_t;
        using void_signal_t               = sight::core::com::signal<void ()>;
        using compositor_updated_signal_t = core::com::signal<void (std::string, bool, viz::scene3d::layer::sptr)>;

        static inline const key_t FULLSCREEN_SET     = "fullscreen_set";
        static inline const key_t FULLSCREEN_UNSET   = "fullscreen_unset";
        static inline const key_t COMPOSITOR_UPDATED = "compositorUpdated";
        static inline const key_t RENDERED           = "rendered";
    };

    /// Defines the type of adaptors ID.
    using adaptor_id_t = std::string;

    /// Defines the type of object ID.
    using ogre_object_id_t = std::string;

    /// Defines the type of scene ID.
    using scene_id_t = std::string;

    /// Defines actives layouts in the scene.
    using layer_map_t = std::map<scene_id_t, std::shared_ptr<viz::scene3d::layer> >;

    /// Contains the slot name that computes the parameters to reset the camera.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t COMPUTE_CAMERA_ORIG_SLOT;

    /// Contains the slot name that resets all layers camera.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t RESET_CAMERAS_SLOT;

    /// Contains the slot name that request the picker to do a ray cast according to the passed position.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t DO_RAY_CAST_SLOT;

    /// Contains the slot name that requests a rendering.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t REQUEST_RENDER_SLOT;

    /// Contains the slot name that requests a rendering.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t RENDER_SLOT;

    /// Contains the slot name that disables fullscreen rendering if it was enabled.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t DISABLE_FULLSCREEN;

    /// Contains the slot name that enables fullscreen rendering on a specific screen.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t ENABLE_FULLSCREEN;

    /// Contains the slot name that enables the manual rendering mode.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t SET_MANUAL_MODE;

    /// Contains the slot name that enables the automatic rendering mode.
    SIGHT_VIZ_SCENE3D_API static const core::com::slots::key_t SET_AUTO_MODE;

    struct layer
    {
        static const inline std::string BACKGROUND = "background";
        static const inline std::string GRID       = "grid";
    };

    /// Initializes slots.
    SIGHT_VIZ_SCENE3D_API render() noexcept;

    /// Destroys the service.
    SIGHT_VIZ_SCENE3D_API ~render() noexcept override;

    /// Sets this render service as the current OpenGL context.
    SIGHT_VIZ_SCENE3D_API void make_current();

    /// Requests a render from the Ogre render engine.
    SIGHT_VIZ_SCENE3D_API void request_render();

    /// @returns true if the scene is shown on screen.
    SIGHT_VIZ_SCENE3D_API bool is_shown_on_screen();

    /// @returns the scene manager corresponding to the sceneID.
    SIGHT_VIZ_SCENE3D_API Ogre::SceneManager* get_scene_manager(const std::string& _scene_id);

    /// @returns the layer corresponding to the sceneID.
    SIGHT_VIZ_SCENE3D_API viz::scene3d::layer::sptr layer(const std::string& _scene_id);

    /// @returns this render layers.
    SIGHT_VIZ_SCENE3D_API layer_map_t get_layers();

    /// @returns m_interactorManager.
    SIGHT_VIZ_SCENE3D_API viz::scene3d::window_interactor::sptr get_interactor_manager() const;

    /// Resets camera parameters with the actual global bounding box.
    SIGHT_VIZ_SCENE3D_API void reset_camera_coordinates(const std::string& _layer_id);

    /// Resets all layers camera parameters with the actual global bounding box.
    SIGHT_VIZ_SCENE3D_API void reset_cameras();

    template<class T>
    std::vector<SPTR(T)> get_adaptors() const;

    /// Registers the adaptor for update
    void register_adaptor(const SPTR(viz::scene3d::adaptor)& _adaptor);

    /// Unregisters the adaptor
    void unregister_adaptor(const SPTR(viz::scene3d::adaptor)& _adaptor);

    /// Sets the rendering mode
    void set_render_mode(bool _manual) const;

    /// Returns the rendering mode
    render_mode get_render_mode() const;

protected:

    /// Configures adaptors and connections.
    SIGHT_VIZ_SCENE3D_API void starting() override;

    /// Stops all adaptors
    SIGHT_VIZ_SCENE3D_API void stopping() override;

    /// Configures the adaptor.
    SIGHT_VIZ_SCENE3D_API void configuring() override;

    /// Does nothing.
    SIGHT_VIZ_SCENE3D_API void updating() override;

private:

    /// Trigger a rendering right now of the current frame.
    void render_now();

    /// Configures background layer of the scene.
    void configure_background_layer(const config_t& _cfg);

    /// Configures each layer of the scene.
    void configure_layer(const config_t& _cfg);

    /// Retrieves the viewport parameters from the configuration.
    static sight::viz::scene3d::layer::viewport_config_t configure_layer_viewport(const service::config_t& _cfg);

    /**
     * @brief Renders the scene in fullscreen on the screen with the given index.
     * @param _screen the index of the screen where the fullscreen is enabled.
     */
    void enable_fullscreen(int _screen);

    /// Switches back to windowed rendering if fullscreen is on.
    void disable_fullscreen();

    /// Contains all the layers of the scene.
    layer_map_t m_layers;

    /// Contains the Ogre window interactor manager.
    viz::scene3d::window_interactor::sptr m_interactor_manager;

    /// Contains the Ogre root.
    Ogre::Root* m_ogre_root {nullptr};

    /// Defines how the rendering is triggered.
    render_mode m_render_mode {render_mode::AUTO};

    /// Defines if the render window is in fullscreen.
    bool m_fullscreen {false};

    /// Defines the width for off-screen rendering.
    unsigned int m_width {0};

    /// Defines the height for off-screen rendering.
    unsigned int m_height {0};

    /// Defines if the scene is rendered off-screen.
    bool m_off_screen {false};

    /// Defines if the scene will be rendered upside down.
    /// @warning the scene must be rendered off-screen.
    bool m_flip {false};

    /// List of adaptors, each adaptor registers itself at start().
    /// The order of declaration is respected because it is required for the update
    std::vector<SPTR(viz::scene3d::adaptor)> m_adaptors;

    /// Index of the adaptor according to its uid
    std::map<std::string, std::size_t> m_adaptors_index;

    static constexpr std::string_view OFFSCREEN_INOUT = "offscreen";
    data::ptr<data::image, data::access::inout> m_off_screen_image {this, OFFSCREEN_INOUT, true};
};

//-----------------------------------------------------------------------------

template<class T>
std::vector<SPTR(T)> render::get_adaptors() const
{
    auto services_vector = sight::service::get_services("sight::viz::scene3d::adaptor");
    std::vector<SPTR(T)> result_vector;

    for(const auto& scene_adaptor : services_vector)
    {
        SPTR(T) adaptor = std::dynamic_pointer_cast<T>(scene_adaptor);
        if(adaptor)
        {
            if(adaptor->render_service() == this->get_const_sptr())
            {
                result_vector.push_back(adaptor);
            }
        }
    }

    return result_vector;
}

//------------------------------------------------------------------------------

inline render::render_mode render::get_render_mode() const
{
    return m_render_mode;
}

//-----------------------------------------------------------------------------

} // namespace sight::viz::scene3d