This repository has been archived on 2025-02-27. You can view files and clone it, but cannot push or open issues or pull requests.
CnC_Renegade/Code/WWAudio/SoundBuffer.h

181 lines
7.4 KiB
C
Raw Permalink Normal View History

/*
** Command & Conquer Renegade(tm)
** Copyright 2025 Electronic Arts Inc.
**
** This program is free software: you can redistribute it and/or modify
** it under the terms of the GNU General Public License as published by
** the Free Software Foundation, either version 3 of the License, or
** (at your option) any later version.
**
** 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, see <http://www.gnu.org/licenses/>.
*/
/***********************************************************************************************
*** C O N F I D E N T I A L --- W E S T W O O D S T U D I O S ***
***********************************************************************************************
* *
* Project Name : WWAudio *
* *
* $Archive:: /Commando/Code/WWAudio/SoundBuffer.h $*
* *
* Author:: Patrick Smith *
* *
* $Modtime:: 8/17/01 11:12a $*
* *
* $Revision:: 7 $*
* *
*---------------------------------------------------------------------------------------------*
* Functions: *
* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
#if defined(_MSC_VER)
#pragma once
#endif
#ifndef __SOUNDBUFFER_H
#define __SOUNDBUFFER_H
#pragma warning (push, 3)
#include "Mss.H"
#pragma warning (pop)
#include "RefCount.H"
// Forward declarations
class FileClass;
/////////////////////////////////////////////////////////////////////////////////
//
// SoundBufferClass
//
// A sound buffer manages the raw sound data for any of the SoundObj types
// except for the StreamSoundClass object.
//
class SoundBufferClass : public RefCountClass
{
public:
//////////////////////////////////////////////////////////////////////
// Public constructors/destructors
//////////////////////////////////////////////////////////////////////
SoundBufferClass (void);
virtual ~SoundBufferClass (void);
//////////////////////////////////////////////////////////////////////
// Public operators
//////////////////////////////////////////////////////////////////////
operator unsigned char * (void) { return Get_Raw_Buffer (); }
//////////////////////////////////////////////////////////////////////
// File methods
//////////////////////////////////////////////////////////////////////
virtual bool Load_From_File (const char *filename);
virtual bool Load_From_File (FileClass &file);
//////////////////////////////////////////////////////////////////////
// Memory methods
//////////////////////////////////////////////////////////////////////
virtual bool Load_From_Memory (unsigned char *mem_buffer, unsigned long size);
//////////////////////////////////////////////////////////////////////
// Buffer access
//////////////////////////////////////////////////////////////////////
virtual unsigned char * Get_Raw_Buffer (void) const { return m_Buffer; }
virtual unsigned long Get_Raw_Length (void) const { return m_Length; }
//////////////////////////////////////////////////////////////////////
// Information methods
//////////////////////////////////////////////////////////////////////
virtual const char * Get_Filename (void) const { return m_Filename; }
virtual void Set_Filename (const char *name);
virtual unsigned long Get_Duration (void) const { return m_Duration; }
virtual unsigned long Get_Rate (void) const { return m_Rate; }
virtual unsigned long Get_Bits (void) const { return m_Bits; }
virtual unsigned long Get_Channels (void) const { return m_Channels; }
virtual unsigned long Get_Type (void) const { return m_Type; }
//////////////////////////////////////////////////////////////////////
// Type methods
//////////////////////////////////////////////////////////////////////
virtual bool Is_Streaming (void) const { return false; }
protected:
//////////////////////////////////////////////////////////////////////
// Protected methods
//////////////////////////////////////////////////////////////////////
virtual void Free_Buffer (void);
virtual void Determine_Stats (unsigned char *buffer);
//////////////////////////////////////////////////////////////////////
// Protected member data
//////////////////////////////////////////////////////////////////////
unsigned char * m_Buffer;
unsigned long m_Length;
char * m_Filename;
unsigned long m_Duration;
unsigned long m_Rate;
unsigned long m_Bits;
unsigned long m_Channels;
unsigned long m_Type;
};
/////////////////////////////////////////////////////////////////////////////////
//
// StreamSoundBufferClass
//
// A sound buffer manages the raw sound data for any of the SoundObj types
// except for the StreamSoundClass object.
//
class StreamSoundBufferClass : public SoundBufferClass
{
public:
//////////////////////////////////////////////////////////////////////
// Public constructors/destructors
//////////////////////////////////////////////////////////////////////
StreamSoundBufferClass (void);
virtual ~StreamSoundBufferClass (void);
//////////////////////////////////////////////////////////////////////
// File methods
//////////////////////////////////////////////////////////////////////
virtual bool Load_From_File (const char *filename);
virtual bool Load_From_File (FileClass &file);
//////////////////////////////////////////////////////////////////////
// Memory methods
//////////////////////////////////////////////////////////////////////
virtual bool Load_From_Memory (unsigned char *mem_buffer, unsigned long size) { return false; }
//////////////////////////////////////////////////////////////////////
// Type methods
//////////////////////////////////////////////////////////////////////
virtual bool Is_Streaming (void) const { return true; }
protected:
//////////////////////////////////////////////////////////////////////
// Protected methods
//////////////////////////////////////////////////////////////////////
virtual void Free_Buffer (void);
virtual bool Load_From_File (HANDLE hfile, unsigned long size, unsigned long offset);
//////////////////////////////////////////////////////////////////////
// Protected member data
//////////////////////////////////////////////////////////////////////
};
#endif //__SOUNDBUFFER_H