Public Delegate Function DMotionStudyEvents_ForceOutputTimeStepChangeNotifyEventHandler( _
   ByVal Time As Double, _
   ByVal ForceNames As Object, _
   ByVal Displacement As Object, _
   ByVal Velocity As Object, _
   ByVal Acceleration As Object, _
   ByVal ForceOrTorque As Object, _
   ByRef ForceTorqueValue As Object _
) As Integer

Dim instance As New DMotionStudyEvents_ForceOutputTimeStepChangeNotifyEventHandler(AddressOf HandlerMethod)

public delegate int DMotionStudyEvents_ForceOutputTimeStepChangeNotifyEventHandler( 
   double Time,
   object ForceNames,
   object Displacement,
   object Velocity,
   object Acceleration,
   object ForceOrTorque,
   ref object ForceTorqueValue
)

public delegate int DMotionStudyEvents_ForceOutputTimeStepChangeNotifyEventHandler( 
&   double Time,
&   Object^ ForceNames,
&   Object^ Displacement,
&   Object^ Velocity,
&   Object^ Acceleration,
&   Object^ ForceOrTorque,
&   Object^% ForceTorqueValue
)

Parameters

Time

Output time when the event is fired

ForceNames

Array of strings containing the names of the external forces

Displacement

Array of doubles indicating the position of each external force; the order of these values corresponds to the order of the names in ForceNames

Velocity

Array of doubles indicating the velocity of each external force; the order of these values corresponds to the order of the names in ForceNames

Acceleration

Array of doubles indicating the acceleration of each external force; the order of these values corresponds to the order of the names in ForceNames

ForceOrTorque

Array of doubles indicating if an external force is a linear force or a rotary force (torque); the order of these values corresponds to the order of the names in ForceNames

ForceTorqueValue

Array of doubles indicating the value of the force (position, velocity, or acceleration) at the next output time step; these values are used internally for doing interpolation during the integrator time steps; the order of these values corresponds to the order of the names in ForceNames

When the motion simulation is occurring, the solver takes two types of time steps:

• integrator
• output

Integrator time steps are taken during the solve; thus, it is not guaranteed that the solver will actually converge at that step. Output time steps are taken after the solver has converged. By default, the ForceOutputTimeStepChangeNotify event is fired at integrator time steps. If you want to fire this event at output time steps, then set IMotionStudy::SetFireOutputTimeStepEvents to true.

If developing a C++ application, then use swMotionStudyForceOutputTimeStepChangeNotify to register for this notification.