// SPDX-License-Identifier: MIT // // EmulationStation Desktop Edition // VideoComponent.h // // Base class for playing videos. // #ifndef ES_CORE_COMPONENTS_VIDEO_COMPONENT_H #define ES_CORE_COMPONENTS_VIDEO_COMPONENT_H #include "GuiComponent.h" #include "components/ImageComponent.h" #include #include class MediaViewer; class TextureResource; class VideoComponent : public GuiComponent { // Structure that groups together the configuration of the video component. struct Configuration { unsigned startDelay; bool showSnapshotNoVideo; bool showSnapshotDelay; std::string defaultVideoPath; std::string staticVideoPath; }; public: VideoComponent(); virtual ~VideoComponent(); // Loads the video at the given filepath. bool setVideo(std::string path); // Configures the component to show the default video. void setDefaultVideo() { setVideo(mConfig.defaultVideoPath); } // Configures the component to show the static video. void setStaticVideo() { setVideo(mConfig.staticVideoPath); } // Loads a static image that is displayed if the video cannot be played. void setImage(const std::string& path, bool tile = false) override; // Sets whether we're in media viewer mode. void setMediaViewerMode(bool isMediaViewer) { mMediaViewerMode = isMediaViewer; } // Sets whether we're in screensaver mode. void setScreensaverMode(bool isScreensaver) { mScreensaverMode = isScreensaver; } // Set the opacity for the embedded static image. void setOpacity(float opacity) override { mOpacity = opacity; } // Set whether to draw black pillarboxes/letterboxes behind videos. void setDrawPillarboxes(bool state) { mDrawPillarboxes = state; } bool hasStaticVideo() { return !mConfig.staticVideoPath.empty(); } bool hasStaticImage() { return mStaticImage.getTextureSize() != glm::ivec2 {0, 0}; } bool hasStartDelay() { if (mLegacyTheme) return mConfig.showSnapshotDelay && mConfig.startDelay > 0; else return mConfig.startDelay > 0; } // These functions update the embedded static image. void onOriginChanged() override { mStaticImage.setOrigin(mOrigin); } void onPositionChanged() override { mStaticImage.setPosition(mPosition); } void onSizeChanged() override { mStaticImage.onSizeChanged(); } void applyTheme(const std::shared_ptr& theme, const std::string& view, const std::string& element, unsigned int properties) override; std::vector getHelpPrompts() override; void update(int deltaTime) override; // Resize the video to fit this size. If one axis is zero, scale that axis to maintain // aspect ratio. If both are non-zero, potentially break the aspect ratio. If both are // zero, no resizing. This can be set before or after a video is loaded. // setMaxSize() and setResize() are mutually exclusive. virtual void setResize(float width, float height) override = 0; void setResize(const glm::vec2& size) { setResize(size.x, size.y); } // Resize the video to be as large as possible but fit within a box of this size. // This can be set before or after a video is loaded. // Never breaks the aspect ratio. setMaxSize() and setResize() are mutually exclusive. virtual void setMaxSize(float width, float height) = 0; void setMaxSize(const glm::vec2& size) { setMaxSize(size.x, size.y); } // Basic video controls. void startVideoPlayer(); virtual void stopVideoPlayer() {} virtual void pauseVideoPlayer() {} // Handle looping of the video. Must be called periodically. virtual void handleLooping() {} // Used to immediately mute audio even if there are still samples to play in the buffer. virtual void muteVideoPlayer() {} virtual void updatePlayer() {} protected: virtual void startVideoStream() {} void renderSnapshot(const glm::mat4& parentTrans); ImageComponent mStaticImage; unsigned mVideoWidth; unsigned mVideoHeight; glm::vec2 mTargetSize; glm::vec2 mVideoAreaPos; glm::vec2 mVideoAreaSize; std::shared_ptr mTexture; std::string mStaticImagePath; std::string mDefaultImagePath; std::string mVideoPath; unsigned mStartTime; std::atomic mIsPlaying; std::atomic mIsActuallyPlaying; std::atomic mPaused; bool mMediaViewerMode; bool mScreensaverMode; bool mTargetIsMax; bool mPlayAudio; bool mDrawPillarboxes; bool mRenderScanlines; bool mLegacyTheme; bool mHasVideo; float mFadeIn; float mFadeInTime; Configuration mConfig; }; #endif // ES_CORE_COMPONENTS_VIDEO_COMPONENT_H