DLL Import (User DLL)

General

With DLL interface, EBSILON^®Professional offers an access to its data by other programs. This interface can be used for reading and writing EBSILON^®Professional data.

The procedure of DLL creation and handling is the same for data export and import. It is described in the chapter DLL Export.

When the User-DLL is called, EBSILON^®Professional gives a copy of its data to the User-DLL. The user can read this data and perform additional operation with these data. As it is just a copy, generally nothing happens if you perform modifications.

There are special settings that cause EBSILON^®Professional to hand modified data back to EBSILON^®Professional.

It is possible to modify,

specification values of components
characteristic lines of components
calculation parameters

It is not possible to modify,

names, types and descriptions of objects
the topology of the model

All changes made with the help of the User-DLL apply to the active profile only.

Settings for Import

If you want to change EBSILON^®Professional data in your User-DLL, it is not sufficient to overwrite the entries in the EBS_USER_DATA structure you get fromEBSILON^®Professional. You have to set certain flags to tell EBSILON^®Professional which data you want to modify.

General Import - Settings

There is one flag in the EBS_USER_INTERFACE_CONTROL structure called "breadback" (for details of the structures, see the DLL Export description or the header file "userDll.h"). This is a general switch to enable or disable data import completely:

breadback = 0

Export only. EBSILON^®Professionaldoes not change any data.

(FALSE)

breadback = 1 (TRUE)

Export and Import. EBSILON^®Professionalwrites certain modified data back to its internal structures. Which data are written back, is determined by special import flags.

Be sure that the breadback flag is active when you want to write any data back to EBSILON^®Professional.

Specification values

For each specification value of each component, there is a EBS_USER_SPECITEM structure. If you want to change the corresponding specification value, you have to set the "writeback" flag:

writeback = EBS_USER_WRITEBACK_NOCHANGE	Ebsilon does not change this specification value.
writeback = EBS_USER_WRITEBACK_WRITE	Ebsilon changes this specification value to the value that is specified in this EBS_USER_SPECITEM structure as longvalue or doublevalue.
writeback = EBS_USER_WRITEBACK_CLEARINSUBPROF	Ebsilon clears this specification value in the active profile, i.e. the value inherited from the parent profile will be used for calculations
writeback = EBS_USER_WRITEBACK_SETEMPTY	Ebsilon sets this specification value to empty in the active profile, i.e. "empty" is used for calculations, not the value from the parent profile.

Do not use the "bempty" flag to set a value to "empty". This flag is used for export only (to tell you that the value is empty), it is not written back to EBSILON^®Professional.

Characteristic lines

For each characteristic line of each component, there is a EBS_USER_CHARLINE structure. If you want to change the corresponding characteristic line, you have to set the "writeback" flag in this structure. The values for the flag are the same as for the specification values above. Note that all points of the characteristic line and the parameter are handled in the same way: either all are discarded or all are written back or all are cleared. It is not possible to set a characteristic line to "empty".

Calculation parameters

If the "readback" flag is set, the calculation parameters are imported automatically. You do not need to specify an additional flag.

This affects the settings for the simulation, the validation and the coefficients for the user-defined fluid. The information about the last calculation is not written back.

Impressum Disclaimer