SpatializedSpeech : spatialisation du doublage

enum SpaSpeech_HearerType {
  eSpaSpeech_Player,
  eSpaSpeech_Character,
  eSpaSpeech_Object,
  eSpaSpeech_Point,
  eSpaSpeech_ScreenPoint
};
 
struct SpaSpeech {
 
  /// Sets the hearer (the player by default). Pass -1 as MAX_DISTANCE to only play on panning. If you specify a character or an object, pass its id as X and leave y blank
  import static void SetHearer(int max_distance, SpaSpeech_HearerType type = eSpaSpeech_Player, int x = -1, int y = 0);
  import static attribute bool Enabled;
  import static bool get_Enabled(); // $AUTOCOMPLETEIGNORE$
  import static void set_Enabled(bool enabled); // $AUTOCOMPLETEIGNORE$
 
};

AudioChannel* Channel; // The channel instance on which the speech is played (0)
int MaxDistance, DistX, DistY; // Distances to calculates the volumes
int HearerX, HearerY; // If the hearer is a point, its coordinates
Character* SpeakingChar; // The currently speaking character
bool Spatialized = true; // Enables/Disables adjusting volume and panning
bool NewChar; // If a new character starts to speak
SpaSpeech_HearerType Hearer; // The type of the hearer (character, object or point)
Character* HearerCharacter; // The hearer character
Object* HearerObject; // The hearer object
 
// Sets a new hearer (character, object or point)
//
//  The closer the distance between the hearer and the source gets to MAX_DISTANCE,
//  the more the volume decreases (down to 0 when distance>=MAX_DISTANCE).
//
//  If you only specify MAX_DISTANCE, the player character will stand as the hearer.
//
//  If you pass eSpaSpeech_Player as TYPE, just leave X and Y blank.
//  If you pass eSpaSpeech_Character as TYPE, just pass the character's id as X and leave Y blank.
//  If you pass eSpaSpeech_Object as TYPE, pass the object's id as X and leave Y blank.
//  If you pass eSpaSpeech_Point as TYPE, pass the fixed room coordinates as X and Y.
//  If you pass eSpaSpeech_ScreenPoint as TYPE, pass the screen coordinates as X and Y.
//
static void SpaSpeech::SetHearer(int max_distance, SpaSpeech_HearerType type, int x, int y) {
 
  HearerObject = null;
  HearerCharacter = null;
  MaxDistance = max_distance;
  Hearer = type;
  if (type == eSpaSpeech_Player) HearerCharacter = player;
  else if (type == eSpaSpeech_Character) {
    if (x < 0 || x >= Game.CharacterCount) HearerCharacter = player;
    else HearerCharacter = character[x];
  }
  else if (type == eSpaSpeech_Object) {
    if (x < 0 || x >= Room.ObjectCount) return;
    HearerObject = object[x];
  }
  else {
    HearerX = x;
    HearerY = y;
  }
 
}
static bool SpaSpeech::get_Enabled() { return Spatialized; }
static void SpaSpeech::set_Enabled(bool enabled) { Spatialized = enabled; }
 
/// Returns X's absolute value
float Abs(float x) {
  if (x < 0.0) return -1.0 * x;
  return x;
}
 
/// Gets the X coordinate of the hearer
int GetHearerX() {
  if ((Hearer == eSpaSpeech_Character || Hearer = eSpaSpeech_Player) && HearerCharacter != null) return HearerCharacter.x;
  else if (Hearer == eSpaSpeech_Object && HearerObject != null) return HearerObject.X;
  else if (Hearer == eSpaSpeech_Point) return HearerX;
  else if (Hearer == eSpaSpeech_ScreenPoint) return HearerX+GetViewportX();
  else return player.x;
}
/// Gets the Y coordinate of the hearer
int GetHearerY() {
  if ((Hearer == eSpaSpeech_Character || Hearer = eSpaSpeech_Player) && HearerCharacter != null) return HearerCharacter.y;
  else if (Hearer == eSpaSpeech_Object && HearerObject != null) return HearerObject.Y;
  else if (Hearer == eSpaSpeech_Point) return HearerY;
  else if (Hearer == eSpaSpeech_ScreenPoint) return HearerY+GetViewportY();
  else return player.y;
}
 
/// Gets the character that is currently speaking or NULL if there is no
Character* GetSpeakingCharacter() {
  int i = 0;
  while (i < Game.CharacterCount) {
    if (character[i].Speaking) {
      NewChar = true;
      return character[i];
    }
    i++;
  }
  return null;
}
 
/// Calculates the panning
int CalculatePanning() {
 
  if (SpeakingChar == null || SpeakingChar.Room != player.Room) return 0;
  int dx = SpeakingChar.x-GetHearerX(), dy = SpeakingChar.y-GetHearerY();
  if (dx == 0) return 0;
  // We make the panning in [0,100] proporitional to the ratio dY/dX
  float pan = 100.0/Maths.RaiseToPower(2.0, Abs(IntToFloat(dy)/IntToFloat(dx)));
  if (dx < 0) return -1*FloatToInt(pan);
  else return FloatToInt(pan);
 
}
 
/// Calculates the volume
int CalculateVolume() {
 
  if (SpeakingChar == null || MaxDistance <= 0 || SpeakingChar.Room != player.Room) return 100;
  int dx = SpeakingChar.x-GetHearerX(), dy = SpeakingChar.y-GetHearerY(),
    // We make the volume in [0,100] proportional to MaxDistance-distance
    volume = 100-100*FloatToInt(Maths.Sqrt(IntToFloat(dx*dx+dy*dy)))/MaxDistance;
  if (volume < 0) volume = 0;
  return volume;
 
}
 
/// Instanciates the channel with the channel 0, on which the system plays speech
function game_start() { Channel = System.AudioChannels[0]; }
 
function repeatedly_execute_always() {
   
  if (Spatialized) {
    // If the player character has changed while eSpaSpeech_Player, update the hearer character
    if (Hearer == eSpaSpeech_Player && player != HearerCharacter) HearerCharacter = player;
   
    // If some speech is being played
    if (Channel.IsPlaying) {
      int panning = Channel.Panning, volume = Channel.Volume;
      // If we have a new speaker
      if (SpeakingChar == null || !SpeakingChar.Speaking) SpeakingChar = GetSpeakingCharacter();
      else if (NewChar) NewChar = false;
      if (SpeakingChar != null) {
        // Calculates X and Y distances between the hearer and the source
        int dx = GetHearerX()-SpeakingChar.x, dy = GetHearerY()-SpeakingChar.y;
        // If the distance has changed, fix the volume and the panning
        if (NewChar || dx != DistX || dy != DistY) {
          panning = CalculatePanning();
          volume = CalculateVolume();
          DistX = dx; // Remember the
          DistY = dy; // new distances
        }
        Channel.Panning = panning;
        Channel.Volume = volume;
      }
    }
    // If no speech is currently playing
    else SpeakingChar = null;
  }
 
}

function on_event(EventType event, int data) {
 
  // If the player leaves a room where an object is the hearer, make it null
  if (event == eEventLeaveRoom && Hearer == eSpaSpeech_Object) HearerObject = null;
 
}