stream.h

Go to the documentation of this file.

/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
 * Copyright (C) 2019, Google Inc.
 *
 * Video stream for a Camera
 */

#pragma once

#include <map>
#include <ostream>
#include <string>
#include <vector>

#include <libcamera/color_space.h>
#include <libcamera/framebuffer.h>
#include <libcamera/geometry.h>
#include <libcamera/pixel_format.h>

namespace libcamera {

class Camera;
class Stream;

class StreamFormats
{
public:
    StreamFormats();
    StreamFormats(const std::map<PixelFormat, std::vector<SizeRange>> &formats);

    std::vector<PixelFormat> pixelformats() const;
    std::vector<Size> sizes(const PixelFormat &pixelformat) const;

    SizeRange range(const PixelFormat &pixelformat) const;

private:
    std::map<PixelFormat, std::vector<SizeRange>> formats_;
};

struct StreamConfiguration {
    StreamConfiguration();
    StreamConfiguration(const StreamFormats &formats);

    PixelFormat pixelFormat;
    Size size;
    unsigned int stride;
    unsigned int frameSize;

    unsigned int bufferCount;

    std::optional<ColorSpace> colorSpace;

    Stream *stream() const { return stream_; }
    void setStream(Stream *stream) { stream_ = stream; }
    const StreamFormats &formats() const { return formats_; }

    std::string toString() const;

private:
    Stream *stream_;
    StreamFormats formats_;
};

std::ostream &operator<<(std::ostream &out, const StreamConfiguration &cfg);

enum class StreamRole {
    Raw,
    StillCapture,
    VideoRecording,
    Viewfinder,
};

std::ostream &operator<<(std::ostream &out, StreamRole role);

class Stream
{
public:
    Stream();

    const StreamConfiguration &configuration() const { return configuration_; }

protected:
    friend class Camera;

    StreamConfiguration configuration_;
};

} /* namespace libcamera */