Version 1.0 Released: 8 August 2013 Web: www.fs2crew.

com

NOTES:
This SDK is for experienced developers only. To discuss RAAS licensing opportunities for your payware aircraft, please contact FS2Crew Admin at www.fs2crew.com.

SDK:
The RAAS module registers the following API variables: register_named_variable("RAAS_Volume_Adjust"); register_named_variable("RAAS_Enable"); register_named_variable("RAAS_Alert"); register_named_variable("RAAS_Mute");

Note: You may use these functions as detailed in the FSX C++ Panels and Gauges SDK to read and write into the RAAS variables:
register_named_variable(..) get_named_variable_value(..) set_named_variable_value(..)

API variables - Description: RAAS_Alert: You *MUST* type cast it to DWORD (32-bits, unsigned integer). It's a bitmask. See the Define ADVISORIES - Bitmask Flags section below. RAAS_Enable: RAAS master switch (0 = DISABLED, 1 = ENABLED) RAAS_Volume_Adjust: A value from 0.0 to 1.0 RAAS_Mute: Mute (0 = *NOT* mute, 1 = MUTE)

These values are read by the RAAS module *EVERY* frame: "RAAS_Volume_Adjust" "RAAS_Enable" "RAAS_Mute"

This value is updated by the RAAS module *EVERY* frame: "RAAS_Alert"

Define ADVISORIES - Bitmask Flags

(*DECIMAL* values) 1 2 4 8 16 32 64 128 256 512 1024 2048 4096 8192 16384 32768 65536 131072

#define ADVISORIES_BITMASK_APPROACHING_RWY_GROUND #define ADVISORIES_BITMASK_APPROACHING_RWY_AIR #define ADVISORIES_BITMASK_ON_RUNWAY #define ADVISORIES_BITMASK_RUNWAY_END #define ADVISORIES_BITMASK_TAXIWAY_TAKEOFF #define ADVISORIES_BITMASK_INSUFFICIENT_RWY_GROUND #define ADVISORIES_BITMASK_EXTENDED_HOLDING_ON_RWY #define ADVISORIES_BITMASK_APPROACHING_SHORT_RWY_AIR #define ADVISORIES_BITMASK_TAXIWAY_LANDING #define ADVISORIES_BITMASK_TAKEOFF_FLAP_MONITOR #define ADVISORIES_BITMASK_DISTANCE_REMAINING #define ADVISORIES_BITMASK_LANDING_FLAP_MONITOR #define ADVISORIES_BITMASK_EXCESSIVE_APPROACH_SPEED #define ADVISORIES_BITMASK_EXCESSIVE_APPROACH_ANGLE #define ADVISORIES_BITMASK_UNSTABLE_APPROACH #define ADVISORIES_BITMASK_ALTIMETER_SETTING #define ADVISORIES_BITMASK_LONG_LANDING #define ADVISORIES_BITMASK_CAUTION_OPTION

IMPORTANT Notes:

1- The "ON TAXIWAY, ON TAXIWAY" annunciation is heard when this bit is set: "ADVISORIES_BITMASK_TAXIWAY_TAKEOFF"

The C++ code would be like this: if ((dwSoundMask & ADVISORIES_BITMASK_TAXIWAY_TAKEOFF) == ADVISORIES_BITMASK_TAXIWAY_TAKEOFF)

2- The "CAUTION SHORT RUNWAY, SHORT RUNWAY" (IN AIR) annunciation is heard when these bits are set: "ADVISORIES_BITMASK_APPROACHING_SHORT_RWY_AIR" "ADVISORIES_BITMASK_CAUTION_OPTION"

The C++ code would be like this: if ((dwSoundMask & ADVISORIES_BITMASK_APPROACHING_SHORT_RWY_AIR) == ADVISORIES_BITMASK_APPROACHING_SHORT_RWY_AIR && (dwSoundMask & ADVISORIES_BITMASK_CAUTION_OPTION) == ADVISORIES_BITMASK_CAUTION_OPTION)

3- The "CAUTION SHORT RUNWAY, SHORT RUNWAY" (ON GROUND) annunciation is heard when these bits are set: "ADVISORIES_BITMASK_ON_RUNWAY" "ADVISORIES_BITMASK_INSUFFICIENT_RWY_GROUND" "ADVISORIES_BITMASK_CAUTION_OPTION"

The C++ code would be like this: if ((dwSoundMask & ADVISORIES_BITMASK_INSUFFICIENT_RWY_GROUND) == ADVISORIES_BITMASK_INSUFFICIENT_RWY_GROUND && (dwSoundMask & ADVISORIES_BITMASK_CAUTION_OPTION) == ADVISORIES_BITMASK_CAUTION_OPTION &&

(dwSoundMask & ADVISORIES_BITMASK_ON_RUNWAY) == ADVISORIES_BITMASK_ON_RUNWAY)

Other examples: If the ADVISORIES_BITMASK_TAXIWAY_TAKEOFF flag is *INSIDE!* of the dwSoundMask value: if ((dwSoundMask & ADVISORIES_BITMASK_TAXIWAY_TAKEOFF) == ADVISORIES_BITMASK_TAXIWAY_TAKEOFF) If the ADVISORIES_BITMASK_TAXIWAY_TAKEOFF flag is *NOT!* inside of the dwSoundMask value: if ((dwSoundMask & ADVISORIES_BITMASK_TAXIWAY_TAKEOFF) == 0)

-SDK END-