ScreenReceiver.h

Go to the documentation of this file.

// Copyright (c) 2025 Dave R. Smith.
// Malena Framework — Licensed under PolyForm Noncommercial 1.0.0; commercial use requires a paid license. See LICENSE.
 
#pragma once
#ifndef MALENA_SCREEN_RECEIVER_H
#define MALENA_SCREEN_RECEIVER_H
 
#include <Malena/Core/malena_export.h>
#include <Malena/Graphics/Base/Graphic.h>
#include <SFML/Graphics/RectangleShape.hpp>
#include <cstddef>
#include <cstdint>
#include <memory>
#include <string>
 
namespace ml {

class MALENA_API ScreenReceiverBase : public Graphic<sf::RectangleShape>
{
public:
    enum class ScaleMode { Stretch, Fit, Fill };

    ScreenReceiverBase(const char* name, const char* rtspUrl);
    ~ScreenReceiverBase() override;
 
    ScreenReceiverBase(const ScreenReceiverBase&)            = delete;
    ScreenReceiverBase& operator=(const ScreenReceiverBase&) = delete;

    void start();

    void stop();

    void setUrl(const std::string& rtspUrl);

    void setFrozen(bool frozen);
    bool isFrozen() const;

    void setScaleMode(ScaleMode mode);
    ScaleMode scaleMode() const;

    void pushFrame(const std::uint8_t* data, std::size_t size);

    bool isConnected() const;
 
    const std::string& receiverName() const;
    const std::string& url() const;
 
    // sf::Drawable override — uploads the latest frame and renders it (or a
    // black placeholder when no stream is active).
    void draw(sf::RenderTarget& target, sf::RenderStates states) const override;
 
private:
    struct Impl;
    std::unique_ptr<Impl> _impl;
};
 
// ---------------------------------------------------------------------------

template<typename Manifest>
class ScreenReceiver : public ScreenReceiverBase
{
public:
    ScreenReceiver()
        : ScreenReceiverBase(Manifest::name, Manifest::url)
    {}
};
 
} // namespace ml
 
#endif // MALENA_SCREEN_RECEIVER_H