Introduction to EON SDK - Construction IT research at VTT

More documents

Recommendations

Info

User Guide Techniques Definition of a class derived from MFC's CpropertyPage. • PPNodetName.CPP Implements the EON properties page and the DataTransfer function. This function transfers data of those fields handled by the properties page to the appropriate node. Node C++ source file The wizard creates one source file for each node and one for the project, i.e., the DLL. Project IDL file The IDL file contains interface definitions and CoClass definitions. There is only one IDL file per DLL. All interfaces and classes implemented in a specific DLL are defined in the IDL file. Writing nodes in C++ Manipulating in- and out-fields by using logic operations and algorithms requires a minimum of programming experience. Use standard C++ programming to implement the desired functionality in any of the following functions: FieldChanged(), OnPreUpdate(), Update() or OnPostUpdate (), depending on when your code should execute. Remember that the execution model traverses all the way through the simulation tree when calling these functions; a child node is always called after its parent. When designing a new node, one has to decide how it shall interact with its surroundings. E.g., the EON Rotate node rotates its parent, while the KeyboardSensor uses eventOut fields and routes. With standard Windows programming, it is possible to incorporate hardware such as mice, printers or mass storage devices. If you need access to the graphics core of EON, you must use DirectX. Defining fields Define fields in the InitClass() function. The base class constructor calls this function the first time an instance of your node is created. Accessing field values Processing eventIn Generating events Loading and Saving (Serializing) Using DirectX The DirectX component that is useful when working with graphics is Direct3D. For example, you can get and set individual vertex positions by using the included mesh interface. This DirectX component also has several other interfaces for frames, viewports and textures. 24 EON SDK 2.53.0
User Guide Wizards If you use Direct3D functions within your node, you must obtain a COM (Component Object Model) interface using either QueryInterface() or CComQIPtr(). QueryInterface() requires you to release the interface when it is not needed. If you acquired an interface in the OnInitialize() function, release it in the OnReset() function. CComQIPtr() is used primarily when you will only use the interface temporarily, e.g., as in the OnInitialize() function below. An object of this class performs automatic reference counting through calls to AddRef and Release. Although all available DirectX functions are fully documented in the DirectX SDK, it might be worthwhile to obtain one of the many books on the topic. Interfaces The recommended procedure for accessing other nodes in EON Studio is by modifying their fields. However, some older nodes are still accessible via the interfaces they implement. See the Reference Guide for more information on how to query for a COM interface and to see a list of useful interfaces. A more complete description of interfaces is beyond the scope of this guide. Connection points in EON A connection point is a COM standard feature for sending outgoing events. Each connection point is exposed by an outgoing interface. Any client object may connect to an object exposing one or more connection points to receive events from that object. A client object implements the outgoing interface, a notify sink. • Implementing connection points improves simulation performance. In EON, a node implements a subset of all defined interfaces. If you use connection points with EON, use them with ATL and a help class CConnectionPointAdvisor; the procedure is otherwise quite complicated. Using the EON log EON’s log handling features provide the developer with improved functions for filtering out log messages that are irrelevant to the development process. Log messages can be sent from nodes (in the C++ code) and from Script nodes. Each log message has input arguments: LogType, Source, Description and Message. Adding an icon to a node You can easily add a specially designed icon to a new node created in Visual Studio. Choose Insert>Resource to add a new bitmap to your EON node project. In the resource editor, resize the drawing area to a 16x16 square. Visual Studio will give your bitmap a default name. If you want to rename it, click the icon name to view its properties. Open your node source file and replace ”IDB_DEFAULT_ICON” inside the GetIconID() function with a new bitmap name, for example, IDB_NODE. 2.5 25
Page 1 and 2: Introduction to EON SDK Jan 2002 ©
Page 3 and 4: User’s Guide Introduction Introdu
Page 5 and 6: User Guide Installation modules. By
Page 7 and 8: User Guide Wizards enhance function
Page 9 and 10: User Guide Wizards or multiple-valu
Page 11 and 12: User Guide Wizards EON SDK can also
Page 13 and 14: User Guide Wizards Although not fea
Page 15 and 16: User Guide Wizards • The name of
Page 17 and 18: User Guide Wizards lists based on t
Page 19 and 20: User Guide Wizards Studio are actua
Page 21 and 22: User Guide Wizards 9. Select which
Page 23: User Guide Wizards Node class defin
Page 27 and 28: User Guide Wizards disable licensin
Page 29 and 30: User Guide Wizards Writing modules
Page 31 and 32: User Guide Techniques when it goes
Page 33 and 34: User Guide Techniques the * and ->
Page 35 and 36: User Guide Techniques ); if (FAILED
Page 37 and 38: Reference Guide Introduction Introd
Page 39 and 40: Reference Guide Classes in EON SDK
Page 41 and 42: Reference Guide Modules Modules Int
Page 43 and 44: Reference Guide Interfaces IAgent U
Page 45 and 46: Reference Guide Interfaces SetDefau
Page 47 and 48: Reference Guide Interfaces GetIdOfN
Page 49 and 50: Reference Guide Interfaces SetStrin
Page 51 and 52: Reference Guide Interfaces GetInsta
Page 53 and 54: Reference Guide Interfaces GetJoyst
Page 55 and 56: Reference Guide Interfaces GetRefer
Page 57 and 58: Reference Guide Interfaces UseLogTy
Page 59 and 60: Reference Guide Interfaces ISimulat
Page 61 and 62: Reference Guide Interfaces Index Ac
Page 63: Reference Guide Interfaces LockRend

Introduction to EON SDK - Construction IT research at VTT

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?