This project has moved. For the latest updates, please go here.

Where to Put Plugin

- plugin/ : import/export plugin
- plugin/cmd/ : modify cmd plugin

How to Name Plugin

plugin extension :
- .dll : Win32
- .dylib : MacOS

for import/export plugin, name the plugin as :
- formatExtension.dll ( example : obj.dll )

How to Use Plugin

1. for export plugin :
- type pluginName in Edit->Export->plugin textfield ( example : "obj" )
- type "o pluginName" in command line ( example "o obj" )
- pluginName is without .dll or .dylib extension

then, the exported file will be automatically named as :
- Export/modelName.formatExtension ( example : Export/box.obj )

2. for import plugin :
- drop a file to editView, it will be imported by a plugin with the extension name
- drop a file to Export->extension button or textfield, it will be forced imported by that certain plugin

3. for cmd plugin :
- type "c pluginName" in command line ( example : "c bw" )

How to Deal with the Formats with Same Extensions

name the plugin as :
- softwareName.formatExtension.dll ( example : slab.vox.dll )

1. for export, the file will be automatically named as :
- Export/modelName.formatExtension ( example : Export/box.vox )

2. for import, you have to use "force import", for example :
- type slab.vox in Edit->Export->plugin textfield;
- drag file on the textfield to force it imported by 'slab.vox.dll'

How to Program Plugin

Download Sample Code Here:
Win32( VS10 ) : https://voxel.codeplex.com/downloads/get/781359

you need to include these two headers :
#include "mvx.h" // model, color, voxel classes
#include "mvx_dll.h" // dll api

and implement at least one of the following apis in your plugin :
// import model
MVX_DLL_API bool mvx_import_model(
    const char *path, const char *args, MVX_Model *model );

// export model
MVX_DLL_API bool mvx_export_model(
    const char *path, const char *args, const MVX_Model *model );

// cmd
MVX_DLL_API bool mvx_cmd(
    const char *args, MVX_Model *model );

Last edited Jan 23, 2014 at 6:48 AM by glkasumi, version 10

Comments

mojovski Nov 19, 2014 at 9:24 PM 
where to get the headers from?