photo_engine.h

Go to the documentation of this file.

 
#pragma once
 
#include "managers/source_manager.h"
#include "managers/state_image_manager.h"
#include "operations/operation_descriptor.h"
#include "common/image_region.h"
#include "common/error_handling/core_error.h"
#include "common/types/image_types.h"
 
#include <memory>
#include <string_view>
#include <vector>
#include <expected>
#include <future>
 
namespace CaptureMoment::Core {
 
namespace Engine {
 
class PhotoEngine
{
private:
    std::unique_ptr<Managers::StateImageManager> m_state_manager;
 
public:
    PhotoEngine();
 
    [[nodiscard]] std::expected<void, ErrorHandling::CoreError> loadImage(std::string_view path);
 
    [[nodiscard]] std::expected<void, ErrorHandling::CoreError> commitWorkingImageToSource();
 
    void resetWorkingImage();
 
    [[nodiscard]] Common::ImageDim width() const noexcept;
 
    [[nodiscard]] Common::ImageDim height() const noexcept;
 
    [[nodiscard]] Common::ImageChan channels() const noexcept;
 
    [[nodiscard]] std::future<bool> applyOperations(std::vector<Operations::OperationDescriptor>&& ops);
 
    [[nodiscard]] std::expected<std::unique_ptr<Common::ImageRegion>, ErrorHandling::CoreError> getWorkingImageAsRegion() const;
 
 
    /*
     * @brief Gets a downsampled version of the working image for display purposes.
     *
     * This method performs an internal downsampling of the working image to create
     * a lower-resolution version suitable for real-time display. The dimensions of
     * the downsampled image are determined based on the current viewport size and
     * the original source image dimensions.
     *
     * This is intended for use by the DisplayManager to efficiently render a preview
     * without needing to process the full-resolution image on every update.
    */
    [[nodiscard]] std::expected<std::unique_ptr<Common::ImageRegion>, ErrorHandling::CoreError>
    getDownsampledDisplayImage(Common::ImageDim width, Common::ImageDim height);
};
 
} // namespace Engine
 
} // namespace CaptureMoment::Core