Using DPF Context
Last update: 10.07.2023
Using DPF Context
Entry and Premium capabilities
Two main licensing states are available in DPF:
- Premium: default state. Allows DPF to perform license checkouts, allowing licensed DPF operators to run.
- Entry: does not allow DPF to perform any license checkout, meaning that licensed DPF operators' execution will fail.
Refer to the Operators section, select an operator and see the Scripting section to know if an operator requires a license to be checkout.
DPF context
The Context class defines the licensing logic a server starts with and should be provided to the LibraryHandle constructor.
The Context is composed of the following information:
- EDpfContext enum value: sets DPF default operator capabilities and defines whether DPF capabilities requiring a license checkout are allowed.
- setup_file_path string: is optional and sets DPF default operator capabilities (plugins that are defaultly loaded) if EpfContext::eUserDefined enum value is used.
For example:
- use "EDpfContext::eEntry" to prevent license checkout and have plugins defined in DataProcessingCore.xml loaded
- use "EDpfContext::eDefault" to allow license checkout (Premium) and have plugins defined in DataProcessingCore.xml loaded
- use "EDpfContext::eStandalone" to allow license checkout and have plugins defined in DpfCoreStandalone.xml loaded
Instantiate LibraryHandle with specific DPF context
The following code instantiates a LibraryHandle object using an Entry context:
ansys::dpf::LibraryHandle* lib = new ansys::dpf::LibraryHandle(ansys::dpf::Context::entryContext());
The following code instantiates a LibraryHandle object using a Premium state and using DpfCoreStandalone.xml to load the default plugins:
ansys::dpf::LibraryHandle* lib = new ansys::dpf::LibraryHandle(ansys::dpf::Context::premiumContext());
Refer to the Using DPF capabilities in an existing project section to learn more about the use the LibraryHandle to use DPF capabilities.