Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

This sample plugin was developed using Visual Basic 2005. You need to do the following steps to enable this plugin in SAP2000:

Expand

FAQ

How do I compile the plugin?

Draft Answer

IMPORTANT NOTE: This example is not compatible with ETABS v22.0.0 , SAFE v22.0.0 , SAP2000 v26.0.0 , and CSiBridge v26.0.0 (or any later versions of these programs) . Please refer to the updated example here: NET 8 Plugin Example - All Products


On this page:

Table of Contents

Overview

CSI Sample Plugin 1 is a simple example, created using Visual Basic 2012, which demonstrates the development of SAP2000 plugins. The plugin creates a new model, converts a line of text into frame objects, then adds these objects to the model. For testing purposes, if the text 'crash' is entered, an error message will be generated.

The following sections provide the zipped plugin project file for different target CSI programs (SAP2000, ETABS) and for different plugin types (COM, .NET).

SAP2000 .NET Plugin

Note

Plugin zipped project file: SAP2000_Example_Plugin_NET.zip

SAP2000 COM Plugin

Note

Plugin zipped project file: SapPlugin1720_FramesFromText.zip (Microsoft Visual Studio 2012 Zipped Project)

To enable the COM plugin in SAP2000, necessary steps include:

FAQ

How is the plugin compiled?

Answer: The plugin is already compiled as the following DLL library which follows:

Code Block

obj/Release/Sap2000PluginSapPlugin1720_CSI_Sample1FramesFromText.dll

Once

...

compiled, does the plugin

...

need to

...

be registered with the operating system

...

,

...

See registering plugins

...

and how is this done?

Answer: Please see the Registering COM plugins article for response.

How is the regsvr32 error, shown below, resolved when registering the plugin

...

?

Image Removed


Register the plugin using regasm instead of regsvr32. RunImage Added

Figure 1 - regsvr32 error


Answer: The plugin should be registered using regasm, instead of regsvr32, by running the following command:

Code Block

c:\windows\Microsoft.NET\Framework\v2v4.0.5072730319\regasm /codebase /tlb /verbose  Sap2000PluginSapPlugin1720_CSI_Sample1FramesFromText.dll

...

Warning RA0000, shown below, occurs when using regasm to register the plugin

...

. How is this resolved?


Image Modified

Figure 2 - RA0000 warning


Answer: The RA0000 warning message can may be ignored and since the plugin will still work.

Attachments

  • File | filename = Sap2000Plugin CSI Sample1.zip | title = SAP2000 Plugin CSI Sample1 (ZIP File, 0.5 MB)

Pluginfunction properly.

ETABS .NET Plugin

Note

Plugin zipped project file: ETABS_NETonly_ExamplePlugin.zip (Visual Studio 2012 VB.NET)

Please refer to the "Information for Plugin Developers" page in theĀ CSi API ETABS 2015.chm help file that is present in the ETABS 2015 program directory.