STK AgAsHpopPluginSend comments on this topic.
IAgAsHpopPlugin Interface

Description

A user implements this interface to create a COM component that can be called during the HPOP propagation.


The COM component can be created using compiled code (C++, C#, Visual Basic, etc.) or using a Windows Script Component created using a script language (VBScript, JScript, PerlScript, etc.). Each function of the interface must be implemented, though functions are not required to do anything other than return an error status (either true or false). Once created, the user must register the component in the Windows Registry. After creation and registration, the user may choose to use this plugin component during HPOP propagation (using the standard GUI interface).


The plugin component will be called at certain event times defined by the interface (see the members of the interface). During these calls, the component may request input values and set output values that can affect the computation. Inputs and outputs are accessed through an interface component (either IAgAsHpopPluginResult or IAgAsHpopPluginResultEval as defined by the interface function calls) . The interface component is sent to the plugin component as the lone argument to the function calls.

Public Methods

Public Method EvaluateTriggered on every force model evaluation during the propagation of a step. Use the input interface to access force model settings. Returning false will turn this callback off.
Public Method FreeTriggered just before the plugin is freed from use to allow for any additional cleanup.
Public Method InitTriggered when the plugin is initialized to allow for any additional needed initialization. Must return true to turn on use of plugin.
Public Method PostEvaluateTriggered on every force model evaluation during the propagation of a step, but after the individual force model components have been computed. The components can be obtained from the input interface. Returning false will turn this callback off.
Public Method PostPropagateTriggered just after the last propagation step has been taken. Use the input interface to access force model settings.
Public Method PreNextStepTriggered just before the next propagation step is attempted. Use the input interface to access force model settings. Returning false will turn this callback off.
Public Method PrePropagateTriggered just before propagation starts. Use the input interface to access force model settings. Set initial values for parameters and variables in this method.

Public Properties

Public Property NameTriggered after initialization to set the name of the plugin used in messages.

CoClasses that Implement IAgAsHpopPlugin

© 2024 Analytical Graphics, Inc. All Rights Reserved.