// @flow import React, { Component } from 'react'; /** * Constants to describe the dimensions of the video. Landscape videos * are wider than they are taller and portrait videos are taller than they * are wider. The dimensions will determine how {@code LargeVideoBackground} * will strech to fill its container. * * @type {Object} */ export const ORIENTATION = { LANDSCAPE: 'landscape', PORTRAIT: 'portrait' }; /** * A mapping of orientations to a class that should fit the * {@code LargeVideoBackground} into its container. * * @private * @type {Object} */ const ORIENTATION_TO_CLASS = { [ORIENTATION.LANDSCAPE]: 'fit-full-width', [ORIENTATION.PORTRAIT]: 'fit-full-height' }; /** * The type of the React {@code Component} props of * {@link LargeVideoBackgroundCanvas}. */ type Props = { /** * Additional CSS class names to add to the root of the component. */ className: String, /** * Whether or not the background should have its visibility hidden. */ hidden: boolean, /** * Whether or not the video should display flipped horizontally, so left * becomes right and right becomes left. */ mirror: boolean, /** * Whether the component should ensure full width of the video is displayed * (landscape) or full height (portrait). */ orientationFit: string, /** * Whether or not to display a filter on the video to visually indicate a * problem with the video being displayed. */ showLocalProblemFilter: boolean, /** * Whether or not to display a filter on the video to visually indicate a * problem with the video being displayed. */ showRemoteProblemFilter: boolean, /** * The video stream to display. */ videoElement: Object }; /** * Implements a React Component which shows a video element intended to be used * as a background to fill the empty space of container with another video. * * @extends Component */ export class LargeVideoBackground extends Component { _canvasEl: Object; _updateCanvasInterval: *; /** * Initializes new {@code LargeVideoBackground} instance. * * @param {*} props - The read-only properties with which the new instance * is to be initialized. */ constructor(props: Props) { super(props); // Bind event handlers so they are only bound once per instance. this._setCanvasEl = this._setCanvasEl.bind(this); this._updateCanvas = this._updateCanvas.bind(this); } /** * If the canvas is not hidden, sets the initial interval to update the * image displayed in the canvas. * * @inheritdoc * @returns {void} */ componentDidMount() { if (this.props.videoElement && !this.props.hidden) { this._updateCanvas(); this._setUpdateCanvasInterval(); } } /** * Starts or stops the interval to update the image displayed in the canvas. * * @inheritdoc */ componentDidUpdate(prevProps: Props) { if (prevProps.hidden && !this.props.hidden) { this._clearCanvas(); this._setUpdateCanvasInterval(); } if ((!prevProps.hidden && this.props.hidden) || !this.props.videoElement) { this._clearCanvas(); this._clearUpdateCanvasInterval(); } } /** * Clears the interval for updating the image displayed in the canvas. * * @inheritdoc */ componentWillUnmount() { this._clearUpdateCanvasInterval(); } /** * Implements React's {@link Component#render()}. * * @inheritdoc * @returns {ReactElement} */ render() { const { hidden, mirror, orientationFit, showLocalProblemFilter, showRemoteProblemFilter } = this.props; const orientationClass = orientationFit ? ORIENTATION_TO_CLASS[orientationFit] : ''; const classNames = `large-video-background ${mirror ? 'flip-x' : ''} ${ hidden ? 'invisible' : ''} ${orientationClass} ${ showLocalProblemFilter ? 'videoProblemFilter' : ''} ${ showRemoteProblemFilter ? 'remoteVideoProblemFilter' : ''}`; return (
); } /** * Removes any image displayed on the canvas. * * @private * @returns {void} */ _clearCanvas() { const cavnasContext = this._canvasEl.getContext('2d'); cavnasContext.clearRect( 0, 0, this._canvasEl.width, this._canvasEl.height); } /** * Clears the interval for updating the image displayed in the canvas. * * @private * @returns {void} */ _clearUpdateCanvasInterval() { clearInterval(this._updateCanvasInterval); } _setCanvasEl: () => void; /** * Sets the instance variable for the component's canvas element so it can * be accessed directly for drawing on. * * @param {Object} element - The DOM element for the component's canvas. * @private * @returns {void} */ _setCanvasEl(element) { this._canvasEl = element; } /** * Starts the interval for updating the image displayed in the canvas. * * @private * @returns {void} */ _setUpdateCanvasInterval() { this._clearUpdateCanvasInterval(); this._updateCanvasInterval = setInterval(this._updateCanvas, 200); } _updateCanvas: () => void; /** * Draws the current frame of the passed in video element onto the canvas. * * @private * @returns {void} */ _updateCanvas() { const { videoElement } = this.props; const { videoWidth, videoHeight } = videoElement; const { height: canvasHeight, width: canvasWidth } = this._canvasEl; const cavnasContext = this._canvasEl.getContext('2d'); if (this.props.orientationFit === ORIENTATION.LANDSCAPE) { const heightScaledToFit = (canvasWidth / videoWidth) * videoHeight; cavnasContext.drawImage( videoElement, 0, 0, canvasWidth, heightScaledToFit); } else { const widthScaledToFit = (canvasHeight / videoHeight) * videoWidth; cavnasContext.drawImage( videoElement, 0, 0, widthScaledToFit, canvasHeight); } } }