Public API Reference

isndsys/ss_filter.h

Go to the documentation of this file.

/*
    Copyright (C) 2005 by Andrew Mann

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library 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
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_SNDSYS_FILTER_H__
#define __CS_SNDSYS_FILTER_H__

#include "csutil/scf.h"
#include "isndsys/ss_structs.h"

class csSourceParameters3D;
class csListenerProperties;
struct iReporter;


struct iSndSysSoftwareFilter3DProperties
{
  csSoundSample *clean_buffer;
  csSoundSample *work_buffer;
  size_t buffer_samples;
  csSourceParameters3D *source_parameters;
  csListenerProperties *listener_parameters;
  csSndSysSoundFormat *sound_format;

  float closest_speaker_distance;
  float *speaker_distance;
  float *speaker_direction_cos;
  size_t channel;
};


struct iSndSysSoftwareFilter3D : public virtual iBase
{
  SCF_INTERFACE(iSndSysSoftwareFilter3D,0,1,0);

  virtual void Apply(iSndSysSoftwareFilter3DProperties &properties) = 0;

  virtual bool AddSubFilter(iSndSysSoftwareFilter3D *filter,
        int chain_idx=0) = 0;

  virtual iSndSysSoftwareFilter3D *GetSubFilter(int chain_idx=0) = 0;

  virtual iSndSysSoftwareFilter3D *GetPtr() = 0;
};



//
//  This will be used by the renderer after all mixing is complete.
//  This filter interface allows the renderer to hand off a copy of the
//   completed sound data to an application processing function as it 
//   is delivered to the lower level.
struct iSndSysSoftwareOutputFilter : public virtual iBase
{
  SCF_INTERFACE(iSndSysSoftwareOutputFilter,0,1,0);

  //   should stay.  Return FALSE if the filter should not be used.
  virtual bool FormatNotify(const csSndSysSoundFormat *pSoundFormat) = 0;

  virtual void DeliverData(const csSoundSample *SampleBuffer, size_t Frames) = 0;
};


typedef enum 
{
  // Render Output location - This is the final mix buffer before it goes to the driver
  SS_FILTER_LOC_RENDEROUT=0,
  // Source Output location - This is the final output from a source after all mutation filters
  SS_FILTER_LOC_SOURCEOUT,
  // Source Input location - This is the data the source receives from the stream before any mutation filters are applied
  SS_FILTER_LOC_SOURCEIN
} SndSysFilterLocation;



#endif // __CS_SNDSYS_FILTER_H__

---