Variable subscribe

From Sim Innovations Wiki
Revision as of 11:11, 4 December 2016 by Admin (talk | contribs) (→‎Example)
Jump to navigation Jump to search

Description

variable_subscribe(source,variable_name,type,...,callback_function)

variable_subscribe is used to subscribe to more different data sources (such as X-plane, FSX and AM varables).

Return value

This function won't return any value.

Arguments

# Argument Type Description
1 .. n source String Can be "XPLANE", "FSX", "PREPAR3D" or "AM"
2 .. n variable_name String The name of the variable. This name depends on the source used.
3 .. n data_type String Data type of the variable. This depends on the source used. In general it can be INT,FLOAT,DOUBLE,INT[n],FLOAT[n],DOUBLE[n], BYTE[n] or STRING.
last callback_function String The function to call when new data is available

Example

-- Note that the order in which the variables are given to the variable_subscribe function determines the order in which the variables will enter this function

 -- In our case 
 -- "sim/cockpit2/gauges/indicators/altitude_ft_pilot" maps to "altitude"
 -- "TIME ZULU" maps to "time_seconds"
 -- "MY_CUSTOM_VARIABLE" maps to "my_custom_variable"
 function callback_function(altitude, time_seconds, my_custom_variable)
   print("Altitude from X-plane=" .. altitude)
   print("Time seconds from FSX=" .. time_seconds)
   print("My Custom variable from AM=" .. my_custom_variable)
 end

 -- multi subscribe
 variable_subscribe("XPLANE", "sim/cockpit2/gauges/indicators/altitude_ft_pilot",  "FLOAT",
                    "FSX", "TIME ZULU", "Seconds",
                    "AM", "MY_CUSTOM_VARIABLE", "INT", callback_function)