Contents

Contributing

Contributions to Maverick Model 3D are encouraged. There are several ways (both coding and non-coding) that you can help this project continue. The easiest thing is simply to send me an encouraging email. Bug reports and feature requests are also appreciated.

Source code patches for bugs or new features are also welcome. In the case of patches, there are a few guidelines to follow which will help expedite the integration process.

You can also make contributions in the form of plugins. You can create new tools, commands, texture filters, and model filters through the plugin system. I am willing to host quality plugins on the main website, or even consider integration into the core codebase.

Non-coding contributions could come in the form of documentation or artwork; or possibly even in forms I have not considered. If you have the desire and means to contribute, contact me and I will be happy to help you get started.

Plugins

Plugins can be created to add new tools, commands, texture filters and model filters. Maverick Model 3D development is done in C++. If you have a compelling reason to implement a plugin in another language, contact me and I may be able to arrange C bindings which can be extended to support other languages.

The details of the plugin system may change. The discussion below details the plugin system as of 1.4, but the development source code is always the most up-to-date source of documentation. Check the Misfit Model 3D plugins webpage for examples. The ImLib2 Texture plugin contains a documented, non-trivial example.

A Maverick Model 3D plugin is a dynamic library which contains three required functions and two optional functions, declared as PLUGIN_API (defined in src/mm3dcore/pluginapi.h). Functions marked with a * are optional.

The contents of the init and uninit functions will depend on what the purpose of the plugin is. In most cases it will register a new tool, command, or filter through the appropriate manager singleton. The version and description functions are optional, but are useful in providing information to the end user about the version and purpose of the plugin. These details can be viewed from the Plugins Window.

The plugin_mm3d_version function should return the VERSION_STRING constant that is defined in src/mm3dcore/version.h.

See the ImLib2 Texture plugin for an introduction to writing a plugin. The example also contains pointers to other files in the codebase which contain classes to derive from and documentation on how to use the manager singletons. The source code for the latest stable or development release is always the authoritative reference. I try to keep documentation in the relevant header files current.


[ Contents | Introduction | Tools | Geometry Menu ]
Copyright © 2004-2008, Kevin Worcester
Copyright © 2015-2023, Zack Middleton