Introduction

This is the programmer reference documentation for the Fidelity Pointwise Plugin SDK v0100r16.

To simplify plugin development, an SDK has been created that wraps the low-level API details behind a convienent set of data structures and C function calls. Or, if you prefer, you can implement your plugin using the C++ variant of the SDK.

This document uses various shorthand notations as listed below.

• ... - the folder containing the PluginSDK folder. For example, ".../PluginSDK/src" is shorthand for "/your/development/location/PluginSDK/src/".
• <platform> - The build machine. One of win64, linux_x86_64, or macosx.
• <build> - The build type. One of Debug, Release.

Additional Reference Materials

In addition to this Fidelity Pointwise Plugin SDK reference, there are other materials available that will help you understand plugin development.

• Webcasts
  • An Introduction to Pointwise Plugin Development
• PDF documents
  • CAE PluginSDK 101
  • UGM 2013 - Using Plugins to Streamline Your Process
• Blog posts
  • Dr. Strangegrid or: How I Learned to Stop Waiting and Write a CAE Plugin
  • Understanding the Pointwise Grid Model API (Part 1)
  • Understanding the Pointwise Grid Model API (Part 2)
  • Plugin How-To: Obtaining Face Counts
  • Plugin How-To: Adding Solver Attributes
  • Plugin How-To: Porting an existing Plugin to a New SDK
  • Search Fidelity Pointwise blog for all Plugin SDK related posts
• Other
  • The SDK Implementation.

How to Create a Plugin

You must first download the Fidelity Pointwise Plugin SDK from the Fidelity Pointwise website. To install, unzip/extract the contents of the downloaded archive to your development location. The archive will create a root folder named PluginSDK. The Introduction to Pointwise Plugin Development webcast contains details on downloading and setting up the Fidelity Pointwise Plugin SDK.

Follow the "quick list" below to build a Plugin using the SDK.

1. Create a plugin project
2. Configure the plugin
3. Implement the plugin
   • Implement using the CAE Plugin C API
   • Implement using the CAE Plugin C++ API
   • Implement using the Grid Import Plugin C API
4. Build the plugin

TIP: If you intend to build on linux_x86_64 or macosx machines, the execute permissions on SDK scripts will only be preserved if you extract from a tar.gz archive on unix or macosx.

TIP: A complete copy of this on-line documentation is bundled with the SDK download. To access the SDK documentation locally, open .../PluginSDK/docs/index.html in a web browser.

SDK Downloads

Download the Fidelity Pointwise Plugin SDK using one of the links below. Be careful to choose the SDK version that is compatible with your Fidelity Pointwise installation. See SDK Release Notes for change details.

Current distribution
SDK Version	Compatibility	Supported APIs	Downloads
1.0 R16	18.3R2 (or greater)	CAE Export (CAEP) Grid Import (GRDP)	PluginSDK-v0100r16.zip PluginSDK-v0100r16.tar.gz

Previous distributions
SDK Version	Compatibility	Supported APIs	Downloads
1.0 R15	18.3R2 (or greater)	CAE Export (CAEP) Grid Import (GRDP)	PluginSDK-v0100r15.zip PluginSDK-v0100r15.tar.gz
1.0 R14	18.3R2 (or greater)	CAE Export (CAEP) Grid Import (GRDP)	PluginSDK-v0100r14.zip PluginSDK-v0100r14.tar.gz
1.0 R13	18.3R1	CAE Export (CAEP) Grid Import (GRDP)	PluginSDK-v0100r13.zip PluginSDK-v0100r13.tar.gz
1.0 R11	18.1	CAE Export (CAEP) Grid Import (GRDP)	PluginSDK-v0100r11.zip PluginSDK-v0100r11.tar.gz
1.0 R10	17.1, 17.2, 17.3, and 18.0	CAE Export (CAEP)	PluginSDK-v0100r10.zip PluginSDK-v0100r10.tar.gz
1.0 R9	17.1, 17.2, 17.3, and 18.0	CAE Export (CAEP)	PluginSDK-v0100r9.zip PluginSDK-v0100r9.tar.gz
1.0 R8	17.1, 17.2, 17.3, and 18.0	CAE Export (CAEP)	PluginSDK-v0100r8.zip PluginSDK-v0100r8.tar.gz
1.0 R7	17.1 and 17.2	CAE Export (CAEP)	PluginSDK-v0100r7.zip PluginSDK-v0100r7.tar.gz
1.0 R6	17.1 and 17.2	CAE Export (CAEP)	PluginSDK-v0100r6.zip PluginSDK-v0100r6.tar.gz
1.0 R5	17.1	CAE Export (CAEP)	PluginSDK-v0100r5.zip PluginSDK-v0100r5.tar.gz
1.0 R4	17.1	CAE Export (CAEP)	PluginSDK-v0100r4.zip PluginSDK-v0100r4.tar.gz
1.0 R3	17.0	CAE Export (CAEP)	PluginSDK-v0100r3.zip PluginSDK-v0100r3.tar.gz
1.0 R2	16.4	CAE Export (CAEP)	PluginSDK-v0100r2.zip PluginSDK-v0100r2.tar.gz

SDK Release Notes

• Changes in 1.0 R16
  • Fixed memory leak in pwpCwdPush().
  • Reworked directory buffer allocation to use std::unique_ptr<> for lifetime management.
  • Added function pwpSetCurDir().
• Changes in 1.0 R15
  • Reworked CAE Plugin progress reporting API to eliminate extra step.
  • Added function caeuPublishHighOrderValueDefinitions() to publish attributes needed for HO export and eliminates duplicate, cut-paste code in plugins.
  • Added function caeuPublishMeshLinkValueDefinitions() and updated plugins and SDK accordingly.
  • Removed unused/undefined function PWP_BOOL caeuCombineAnisotropic().
  • Fixed invalid HO range from 1-5 to 1-4.
  • Added non-const version of PwpFile & runtimeFile().
  • Fixed doxygen issues in PwpFile.h.