libcamera/include/libcamera/internal/media_object.h
Kieran Bingham a783562a34 libcamera: media_object: Add MediaLink string representations
Various parts of libcamera print the representation of a MediaLink by
inline joining the parts to make a string representation.

This repeated use case can be supported with a common helper to print
the MediaLink in a common manner using the existing toString() and
operator<< overload style to make it easier to report on MediaLink
types.

This implementation will report in the following style:

  'imx283 1-001a'[0] -> 'video-mux'[0]

Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Stefan Klug <stefan.klug@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
2024-09-12 12:01:29 +02:00

146 lines
3.2 KiB
C++

/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
* Copyright (C) 2018, Google Inc.
*
* Media Device objects: entities, pads and links.
*/
#pragma once
#include <string>
#include <vector>
#include <linux/media.h>
#include <libcamera/base/class.h>
namespace libcamera {
class MediaDevice;
class MediaEntity;
class MediaPad;
class MediaObject
{
public:
MediaDevice *device() { return dev_; }
const MediaDevice *device() const { return dev_; }
unsigned int id() const { return id_; }
protected:
friend class MediaDevice;
MediaObject(MediaDevice *dev, unsigned int id)
: dev_(dev), id_(id)
{
}
virtual ~MediaObject() = default;
MediaDevice *dev_;
unsigned int id_;
};
class MediaLink : public MediaObject
{
public:
MediaPad *source() const { return source_; }
MediaPad *sink() const { return sink_; }
unsigned int flags() const { return flags_; }
int setEnabled(bool enable);
std::string toString() const;
private:
LIBCAMERA_DISABLE_COPY_AND_MOVE(MediaLink)
friend class MediaDevice;
MediaLink(const struct media_v2_link *link,
MediaPad *source, MediaPad *sink);
MediaPad *source_;
MediaPad *sink_;
unsigned int flags_;
};
std::ostream &operator<<(std::ostream &out, const MediaLink &link);
class MediaPad : public MediaObject
{
public:
unsigned int index() const { return index_; }
MediaEntity *entity() const { return entity_; }
unsigned int flags() const { return flags_; }
const std::vector<MediaLink *> &links() const { return links_; }
void addLink(MediaLink *link);
std::string toString() const;
private:
LIBCAMERA_DISABLE_COPY_AND_MOVE(MediaPad)
friend class MediaDevice;
MediaPad(const struct media_v2_pad *pad, MediaEntity *entity);
unsigned int index_;
MediaEntity *entity_;
unsigned int flags_;
std::vector<MediaLink *> links_;
};
std::ostream &operator<<(std::ostream &out, const MediaPad &pad);
class MediaEntity : public MediaObject
{
public:
enum class Type {
Invalid,
MediaEntity,
V4L2Subdevice,
V4L2VideoDevice,
};
const std::string &name() const { return name_; }
unsigned int function() const { return function_; }
unsigned int flags() const { return flags_; }
Type type() const { return type_; }
const std::string &deviceNode() const { return deviceNode_; }
unsigned int deviceMajor() const { return major_; }
unsigned int deviceMinor() const { return minor_; }
const std::vector<MediaPad *> &pads() const { return pads_; }
const std::vector<MediaEntity *> ancillaryEntities() const { return ancillaryEntities_; }
const MediaPad *getPadByIndex(unsigned int index) const;
const MediaPad *getPadById(unsigned int id) const;
int setDeviceNode(const std::string &deviceNode);
private:
LIBCAMERA_DISABLE_COPY_AND_MOVE(MediaEntity)
friend class MediaDevice;
MediaEntity(MediaDevice *dev, const struct media_v2_entity *entity,
const struct media_v2_interface *iface);
void addPad(MediaPad *pad);
void addAncillaryEntity(MediaEntity *ancillaryEntity);
std::string name_;
unsigned int function_;
unsigned int flags_;
Type type_;
std::string deviceNode_;
unsigned int major_;
unsigned int minor_;
std::vector<MediaPad *> pads_;
std::vector<MediaEntity *> ancillaryEntities_;
};
} /* namespace libcamera */