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 */