hyperion.ng/include/blackborder/BlackBorderProcessor.h

164 lines
4.8 KiB
C
Raw Normal View History

#pragma once
// QT includes
#include <QJsonObject>
2018-12-27 23:11:32 +01:00
// util
#include <utils/Logger.h>
#include <utils/settings.h>
#include <utils/Components.h>
// Local Hyperion includes
#include "BlackBorderDetector.h"
2018-12-27 23:11:32 +01:00
class Hyperion;
namespace hyperion
{
2013-09-09 04:54:13 +02:00
///
/// The BlackBorder processor is a wrapper around the black-border detector for keeping track of
/// detected borders and count of the type and size of detected borders.
///
2018-12-27 23:11:32 +01:00
class BlackBorderProcessor : public QObject
{
2018-12-27 23:11:32 +01:00
Q_OBJECT
public:
2018-12-27 23:11:32 +01:00
BlackBorderProcessor(Hyperion* hyperion, QObject* parent);
~BlackBorderProcessor() override;
2013-09-09 04:54:13 +02:00
///
/// Return the current (detected) border
/// @return The current border
///
BlackBorder getCurrentBorder() const;
2016-07-15 10:28:12 +02:00
///
/// Return activation state of black border detector
/// @return The current border
///
bool enabled() const;
///
/// Set activation state of black border detector
/// @param enable current state
///
void setEnabled(bool enable);
2018-12-27 23:11:32 +01:00
///
/// Sets the _hardDisabled state, if True prevents the enable from COMP_BLACKBORDER state emit (mimiks wrong state to external!)
/// It's not possible to enable bb from this method, if the user requsted a disable!
/// @param disable The new state
///
2020-08-08 13:09:15 +02:00
void setHardDisable(bool disable);
2018-12-27 23:11:32 +01:00
2013-09-09 04:54:13 +02:00
///
/// Processes the image. This performs detecion of black-border on the given image and
/// updates the current border accordingly. If the current border is updated the method call
/// will return true else false
///
/// @param image The image to process
///
/// @return True if a different border was detected than the current else false
///
template <typename Pixel_T>
bool process(const Image<Pixel_T> & image)
{
// get the border for the single image
BlackBorder imageBorder;
2016-07-15 10:28:12 +02:00
if (!enabled())
{
imageBorder.horizontalSize = 0;
imageBorder.verticalSize = 0;
imageBorder.unknown=true;
_currentBorder = imageBorder;
return true;
2016-07-15 10:28:12 +02:00
}
if (_detectionMode == "default") {
2018-12-27 23:11:32 +01:00
imageBorder = _detector->process(image);
} else if (_detectionMode == "classic") {
2018-12-27 23:11:32 +01:00
imageBorder = _detector->process_classic(image);
} else if (_detectionMode == "osd") {
2018-12-27 23:11:32 +01:00
imageBorder = _detector->process_osd(image);
} else if (_detectionMode == "letterbox") {
imageBorder = _detector->process_letterbox(image);
}
// add blur to the border
if (imageBorder.horizontalSize > 0)
{
imageBorder.horizontalSize += _blurRemoveCnt;
}
if (imageBorder.verticalSize > 0)
{
imageBorder.verticalSize += _blurRemoveCnt;
}
const bool borderUpdated = updateBorder(imageBorder);
return borderUpdated;
}
2018-12-27 23:11:32 +01:00
private slots:
///
/// @brief Handle settings update from Hyperion Settingsmanager emit or this constructor
/// @param type settingyType from enum
/// @param config configuration object
///
2020-08-08 13:09:15 +02:00
void handleSettingsUpdate(settings::type type, const QJsonDocument& config);
2018-12-27 23:11:32 +01:00
///
/// @brief Handle component state changes, it's not possible for BB to be enabled, when a hardDisable is active
///
2020-08-08 13:09:15 +02:00
void handleCompStateChangeRequest(hyperion::Components component, bool enable);
private:
2018-12-27 23:11:32 +01:00
/// Hyperion instance
Hyperion* _hyperion;
///
/// Updates the current border based on the newly detected border. Returns true if the
/// current border has changed.
///
/// @param newDetectedBorder The newly detected border
/// @return True if the current border changed else false
///
bool updateBorder(const BlackBorder & newDetectedBorder);
2016-07-15 10:28:12 +02:00
/// flag for blackborder detector usage
bool _enabled;
2018-12-27 23:11:32 +01:00
2013-09-09 04:54:13 +02:00
/// The number of unknown-borders detected before it becomes the current border
2018-12-27 23:11:32 +01:00
unsigned _unknownSwitchCnt;
2013-09-09 04:54:13 +02:00
/// The number of horizontal/vertical borders detected before it becomes the current border
2018-12-27 23:11:32 +01:00
unsigned _borderSwitchCnt;
// The number of frames that are "ignored" before a new border gets set as _previousDetectedBorder
2018-12-27 23:11:32 +01:00
unsigned _maxInconsistentCnt;
2013-09-09 04:54:13 +02:00
/// The number of pixels to increase a detected border for removing blury pixels
unsigned _blurRemoveCnt;
/// The border detection mode
2018-12-27 23:11:32 +01:00
QString _detectionMode;
2013-09-09 04:54:13 +02:00
/// The blackborder detector
2018-12-27 23:11:32 +01:00
BlackBorderDetector* _detector;
2013-09-09 04:54:13 +02:00
/// The current detected border
BlackBorder _currentBorder;
2013-09-09 04:54:13 +02:00
/// The border detected in the previous frame
BlackBorder _previousDetectedBorder;
2013-09-09 04:54:13 +02:00
/// The number of frame the previous detected border matched the incomming border
unsigned _consistentCnt;
/// The number of frame the previous detected border NOT matched the incomming border
unsigned _inconsistentCnt;
2018-12-27 23:11:32 +01:00
/// old threshold
double _oldThreshold;
/// True when disabled in specific situations, this prevents to enable BB when the visible priority requested a disable
bool _hardDisabled;
/// Reflect the last component state request from user (comp change)
bool _userEnabled;
};
} // end namespace hyperion