postal/RSPiX/Src/GREEN/Video/Win95/VIDEO.H

////////////////////////////////////////////////////////////////////////////////
//
// Copyright 2016 RWS Inc, All Rights Reserved
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of version 2 of the GNU General Public License as published by
// the Free Software Foundation
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License along
// with this program; if not, write to the Free Software Foundation, Inc.,
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
//
#ifndef CVIDEO_H
#define CVIDEO_H


//////////////////////////////////////////////////////////////////////////////
// Constants
//////////////////////////////////////////////////////////////////////////////

// Error codes.
#define VIDEO_SUCCESS						((short)0)
#define VIDEO_ERR_GENERIC					((short)1)
#define VIDEO_ERR_VIDEO_UNSUPPORTED		((short)2)
#define VIDEO_ERR_CREATE					((short)3)
#define VIDEO_ERR_OPEN						((short)4)
#define VIDEO_ERR_PLAY						((short)5)
#define VIDEO_ERR_PAUSE						((short)6)
#define VIDEO_ERR_RESUME					((short)7)
#define VIDEO_ERR_STOP						((short)8)
#define VIDEO_ERR_CLOSE						((short)9)
#define VIDEO_ERR_ALREADY_CREATED		((short)10)
#define VIDEO_ERR_GETTING_WRECT			((short)11)
#define VIDEO_ERR_RESIZE_FAIL				((short)12)
#define VIDEO_ERR_SET_FRAMES				((short)13)
#define VIDEO_ERR_SET_TIME					((short)14)


// Clipping modes.
#define MODE_NORMAL							((short)0)			// no clipping
#define MODE_CLIP								((short)1)			// clip
#define MODE_STRETCH							((short)2)			// stretch/shrink to fit

// Play modes.
#define PLAY_ALL								((short)0)		// Play the entire video from begin to end
#define PLAY_SELECTION_TIME				((short)1)		// Play a selection specified in milliseconds
#define PLAY_SELECTION_FRAME				((short)2)		// Play a selection specified in frames

class CVideo
	{
	// Constructor/Destructor
	public:
		// Default constructor.
		CVideo(void);

		// Extended constructor which also creates the playback window.
		CVideo(char* szFilename,						// filename of the video
				 long x, 									// left edge of playback window
				 long y, 									// top of the playback window
				 long w, 									// width of the playback window
				 long h, 									// height of the playback window
				 short sClip); 							// clipping flag

		// Default destructor.
		~CVideo(void);

	// Implementation
	public:
		// Create a window which requests the digital video device.
		short Create(void);

		// Destroy the window and free the digital video device.
		void Destroy(void);
		
		// Open a video file and create the playback window.
		short Open(char* szFileName,						// name of the video file
					  long x,									// left edge of the playback window
					  long y,									// top of the playback window
					  long w,									// width of the playback window
					  long h,									// height of the playback window
					  short sClip);							// clipping flag, use following values:
						 											//    0: no clipping, window will be resized to 
																	//			actual video's size.
																	//		1:	video will be clipped to the size supplied.
																	//		2:	video will not be clipped, video will be
																	//			stretched/shrinked to the window's size.
																	// Close a video file.  Will abort the current video file, if playing.
		short Close(void);

		// Play the current video.  Currently, when this function is called, the video will be played
		//	from begin to end.  Possible future functionality may include setting from/to selections,
		// repeat characteristics, etc.  For now, just plain play the darn video.
		// The next day: I realize that we need additional functionality for playing segments within
		// the video.  This could be accomplished with 3 parameters, all of which could be left out
		// for default operation.
		// sMode: 	0 - default operation, lStart/lEnd ignored
		// 			1 - lStart and lEnd specified as time (milliseconds)
		//				2 - lStart and lEnd specified as number of frames.
		short Play(short sMode = 0, long lStart = 0, long lEnd = 0);

		// Pause the current video.  This function must be used if you wish to pause the video.  Stop
		// is not the same as this function.
		short Pause(void);

		// Resume the current video.  The video must have been previously paused.
		short Resume(void);

		// Stop the current video.  This, in effective, will reset the position to the beginning of the
		// video.
		short Stop(void);

		// Get the current frame number of the video.
		long GetFrame(void);

		// Get the current position of the video (in milliseconds).
		long GetPosition(void);

		// The following few functions return status/progress information about the current video.
		// If the status requested is valid, TRUE will be returned - FALSE otherwise.
		short IsOpened(void);		// TRUE if a video is currently opened.
		short IsPlaying(void);		// TRUE if the current video is playing.
		short IsPaused(void);		// TRUE if the current video was paused.
		short IsStopped(void);		// TRUE if the current video was stopped but not paused.

	private:
		void Init(void);
		long TraceMCIError(char* szErrOrigin);


	// Data
	private:
		ULONG		m_ulDeviceID;
		long		m_lhwnd;
	};

#endif