There are examples throughout the documentation and some provided as part of the Softimage installation. This section provides some links to notable examples, along with a brief description of them:
There is also a Custom Property Wizard which you can use to quickly generate the code for a custom property. Examining this generated code is a good way to learn about custom properties.
Examples from the C# and Scripting Reference guide
The following custom property page examples are provided in the Commands and Scripting Reference for the object, method or property indicated. Most of the scripting examples can be run in the Script Editor, unless otherwise noted:
PPGItem—demonstrates how to set labels.
PPGLayout.AddEnumControl—demonstrates how to work with various Enum controls.
PPGLayout.AddFCurve—demonstrates how to work with FCurve controls.
Also, see Examples Installed in the Softimage SDK Workgroup for where you can get a VBScript example of a self-installing plug-in that implements a custom property.
PluginRegistrar.RegisterProperty—demonstrates how to create a self-installing plug-in based custom property.
PPG.CurrentTab—demonstrates how to work with tab controls.
PPG.PPGLayout—demonstrates how to build a simple Script viewer using the Folder widget, Drop-Down List/Combo Box control and a Multi-line Text control.
PPG.Close—demonstrates how to create a non-modal dialog box that cleans itself up using SPDL logic.
PPGItem—demonstrates how to create a dialog with two Path controls.
PPGItem.UIItems—demonstrates how to build a dialog with two list boxes containing items that can be moved back and forth between them.
PPGLayout—two JScript examples demonstrating how to use a property page to collect information from a user and how to work with different number controls.
PPGLayout.AddColor—demonstrates how to use the layout controls with proxy parameters to build a simplified version of a property page.
PPGLayout.AddFCurve—demonstrates how to work with FCurve controls.
PPGLayout.Logic—demonstrates how to use logic to create dynamic controls, to interact with the user and how to use the user's response to build a simple skeleton.
GridData—two examples both demonstrating how to display GridData data on a property page.
View— the second JScript example demonstrates how to use logic make a property page resize and close itself.
Examples from the C++ API Reference guide
The following examples are available in the C++ API Reference:
PPGItem —two examples demonstrating how to tweak the layout of the property page and how to work with Path controls.
PPGLayout —demonstrates how to create a temporary dialog to get some information from the user.
PluginRegistrar::RegisterProperty —demonstrates how to implement a custom property as a self-installing plug-in using various Enum controls.
Also, see Examples Installed in the Softimage SDK Workgroup for where you can get a C++ example of a self-installing plug-in that implements a custom property.
Examples Installed in the Softimage SDK Workgroup
If you connect to the Softimage SDK Examples workgroup, you'll find these examples:
—a C++ API example demonstrating how to create a custom property with various PPG controls.
—JScript and VBScript examples that show how to build property pages (most of the examples from the Commands and Scripting Reference are included in this sample).