Regular API function

simHandleGraph / sim.handleGraph

Description Handles a graph object (i.e. records current values of registered data streams). Graphs and data streams can be added/registered while editing a scene. See also sim.resetGraph.
C synopsis simInt simHandleGraph(simInt graphHandle,simFloat simulationTime)
C parameters
graphHandle: handle of the graph object or sim_handle_all or sim_handle_all_except_explicit. (sim_handle_all will handle all graph objects, while sim_handle_all_except_explicit will only handle those that are not marked as "explicit handling")
simulationTime: simulation time. Usually you want to record data stream at the end of a simulation pass to record actualized value: then set simulationTime to simGetSimulationTime()+simGetSimulationTimeStep().
C return value
-1 if operation was not successful. In a future release, a more differentiated return value might be available
Lua synopsis number result=sim.handleGraph(number graphHandle,number simulationTime)
Lua parameters
Same as C-function
Lua return values
Same as C-function

All regular API functions on one page