Jump to content
3DCoat Forums

Export/Import SDK


Recommended Posts

Hi all! This is 3D-Coat SDK. You can download it there:

For V2:

www.3d-coat.com/files/3D-CoatSDK-210.zip

For V3.7:

http://www.3d-coat.com/files/3D-CoatSDK-V37.zip

This is first version of 3D-Coat SDK. It allows to create plugins for export/import of different 3D-files. To start you should download and unpack 3DCoatSDK.zip . Then you shoud open soluton ExportImport.sln. It requires at least MS VisualStudio 2008 Standart Edition to be properly compiled. Compile project. It is better to use “Release” configuration. You will get Odj.DLL file on output. This simple plugin is a sample for importing OBJ files. Obj.DLL should be copied to

$3D-CoatInstallationFolder\Plugins\MeshCodecs\

To understand how plugins work open files cMeshObj.h. You will see there class that is derived from cMeshCodec (It is defined in cIO.h).

class cMeshCodec {

public:

cMeshCodec() {}

virtual ~cMeshCodec() {}

virtual cMeshContainer * Decode(const cData &Fm) = 0;

virtual void Encode(const cMeshContainer &Mesh, cData *To) = 0;

virtual bool CanEncode(){return true;}

virtual bool CanDecode(){return true;}

};

To create new codec you should derive your class from cMeshCodec and re-define functions Encode and Decode. Decode should return filled object cRawMesh and Encode should fill Data structure cData using cMeshContainer. You can look and discover objects cData and cMeshContainer. After redefining functions you should change class name in ExportImport.cpp. I think it is very easy. The only not so easy task is filling/reading structure cMeshContainer. It is mesh that consists of:

uv-sets (see GetUVSets() )

Matrials(surfaces) (see GetMaterials() )

Objects (see GetObjects() )

PositionVertices (see GetPositions() )

UV-vertices (see GetTexCoords() )

Normals (see GetNormals() )

Faces (see GetRaw() )

To understand how it works it is better to discover how cMeshObj.cpp encodes/decodes obj – files. I will explain slightly how Faces list is organised.

Faces are array of cVec3i – 3 integer values

Count, - amount of polygones in face

idMtl = MaterialIndex + (UV-set index<<16) – index of material and uv-set

idObj - index of object

Next “Count” values are 3-indices of vertices that are part of face

PositionIndex (index in array of position vertices)

TexturevertexIndex (index in array of texture vertices, can be -1)

NormalIndex (index in array of normals, can be -1)

The best method to learn is to ask in forum and discover how cMeshObj is done.

Good luck!

Edit:

Updated to be able to use with V3.7. New SDK link (includes 2 samples OBJ export/import and FBX import):

http://www.3d-coat.com/files/3D-CoatSDK-V37.zip

Link to comment
Share on other sites

  • 2 weeks later...
  • 3 months later...
  • Advanced Member

Hi, I tried really hard to get the SDK to work with v2.10.05 but I've failed :( . I get a crash in the example cMeshObj class because the original cData object passed to Decode is not filled with file data, it appears to be uninitialised memory (the file name is correct though).

To get this far I had to comment out the operator overrides in 'newmem.h' because calls to 3d-coat.lib require 3d-coat.exe, but now there's only 3d-coatDX & GL, so the DLL fails to load and if I rename 3d-coatDX -> 3d-coat.exe, the plug-in silently fails.

I've tried with Visual Studio 2005 and 2008 (professional) and also this problem happens on both XP and Vista.

Can you confirm whether the SDK is working at the moment? is it just me?

Link to comment
Share on other sites

I have updated the link to SDK.

www.3d-coat.com/files/3D-CoatSDK-210.zip

Now it will work with 2.10. But... special 2.10 version is required. It will be distributed soon among users. You can download 2.10 that accepts plugins properly there:

www.3d-coat.com/files/3d-Coat-2-10.09.exe

*edit: I have changed links to more recent.

Link to comment
Share on other sites

  • Advanced Member
I have updated the link to SDK.

www.3d-coat.com/files/3D-CoatSDK.zip

Now it will work with 2.10. But... special 2.10 version is required. It will be distributed soon among users. You can download 2.10 that accepts plugins properly there:

www.3d-coat.com/files/3d-Coat-2-10.08.exe

Great, thank you!

Link to comment
Share on other sites

  • Advanced Member

I managed to get this version to work! However I needed to disable 'newmem.h' or the DLL tried to import '3d-Coat.exe' which doesn't exist. I also made Visual Studio 2005 project files if that's helpful? :)

3D_CoatSDK_20080916.zip

Thanks for the rapid response in getting this SDK working again!

Link to comment
Share on other sites

When I add my plugin to the \Plugins\MeshCodecs folder and run 3D Coat, where exactly does the plugin information appear on the menus ?

Should cMeshIO::AddCodec() be called and displayed for my plugin in the log.txt file ?

Cheers.

If you add your codec for export/import new extension appears in Import and export dialogs.

Also, if loading codec is successful, you will finnd

cMeshIO::AddCodec(): Added "your_extension" mesh codec.

in Log.txt

Also, David, thanks for correcting! But it seems sometimes removing "newmem" can cause memory errors. I will try to correct it finally soon.

Link to comment
Share on other sites

  • Member
If you add your codec for export/import new extension appears in Import and export dialogs.

Also, if loading codec is successful, you will finnd

cMeshIO::AddCodec(): Added "your_extension" mesh codec.

in Log.txt

Thanks for the clarification. I compiled the Obj example that comes with the SDK and copied the Obj.dll into the respective location. When loading 3DC it complained that 3D-Coat.exe could not be found, so I renamed 3D-CoatGL.exe to 3D-Coat.exe. Is this correct ? If so, then my plugin is still not being loaded, has anyone got this working ?

Link to comment
Share on other sites

Thanks for the clarification. I compiled the Obj example that comes with the SDK and copied the Obj.dll into the respective location. When loading 3DC it complained that 3D-Coat.exe could not be found, so I renamed 3D-CoatGL.exe to 3D-Coat.exe. Is this correct ? If so, then my plugin is still not being loaded, has anyone got this working ?

If you will rename 3D-CoatGL or DX to 3D-Coat and rud 3D-Coat.exe it will work. It is one way to get it to work.

As David Walters mentioned, it tries to load 3D-Coat.exe . He has remade project to avoid this. But it can lead to some memory errors.

I will modify project to avoid all that problems.

Link to comment
Share on other sites

Ok, I have corrected problem with 3D-Coat.exe. Now DLL is independent and will use allocation functions form 3D-CoatDX or GL in dependence what is run. To get it to work pease:

1) Download SDK at www.3d-coat.com/files/3D-CoatSDK-210.zip

2) Download newest version of 3D-Coat at www.3d-coat.com/files/3d-Coat-2-10.09.exe

Link to comment
Share on other sites

  • Advanced Member
If so, then my plugin is still not being loaded, has anyone got this working ?

Don't forget that 'obj' is already supported by 3d-Coat, so if you want to make sure it's your code being run then change the extension to something else, "tst" or something.

I've also been able to run the plug-in through the Visual Studio debugger, then you can set breakpoints on the various API functions and watch as 3DC calls your code, to do this simply ensure appropriate debugging information has been built into the DLL and set [Properties] > [Debugging] > [Command] to 3d-coatDX.exe (or GL, and don't forget to set the working directory too). Then just hit 'run' like a normal executable project and Visual Studio make it all just work :lol:

I'm not sure how best to solve the memory errors, I assumed something bad would happen on deallocation if I didn't use the custom allocator defined by newmem.h - but it's the closest I got to success - renaming the EXE didn't work for me, the DLL loaded and then unloaded immediately .. I don't know why.

Regards,

Dave

Link to comment
Share on other sites

  • New Member
Quick feature request, nothing urgent, but would it be possible at some point to add the ability to create extra check boxes in the Export dialog from the SDK ?

I second this request. If it were also possible to add text boxes that could access metadata stored with the 3DC file, we could make use of the asset elements in Collada, to track authorship, copyright, licensing, and version/revision numbers.

There's also a field in the asset tag to specify the authoring tool, which would help to promote the fact that a given model was made with 3DC, but just as importantly, will lead to the ability to automatically re-import models when they are changed in 3DC, since the Collada asset element can point at the original 3DC file, making it possible for a third-party tool to check when it has been modified.

Link to comment
Share on other sites

  • 3 months later...
  • Member

Hi all! I have made 3D-Coat SDK v 1.0. It required at least 3D-Coat 2.10.09 (www.3d-coat.com/files/3d-Coat-2-10.09.exe) You can download it there:

www.3d-coat.com/files/3D-CoatSDK-210.zip

This is first version of 3D-Coat SDK. It allows to create plugins for export/import of different 3D-files. To start you should download and unpack 3DCoatSDK.zip . Then you shoud open soluton ExportImport.sln. It requires at least MS VisualStudio 2008 Standart Edition to be properly compiled. Compile project. It is better to use Release configuration. You will get Odj.DLL file on output. This simple plugin is a sample for importing OBJ files. Obj.DLL should be copied to

$3D-CoatInstallationFolder\Plugins\MeshCodecs\

To understand how plugins work open files cMeshObj.h. You will see there class that is derived from cMeshCodec (It is defined in cIO.h).

class cMeshCodec {

public:

cMeshCodec() {}

virtual ~cMeshCodec() {}

virtual cMeshContainer * Decode(const cData &Fm) = 0;

virtual void Encode(const cMeshContainer &Mesh, cData *To) = 0;

virtual bool CanEncode(){return true;}

virtual bool CanDecode(){return true;}

};

AAAAAaaaa it'sall greek to me. You guys are going to make me pull out what's left of this old farts hair.. Ecuse me while iI jump off the roof. LOL fishbelt

Link to comment
Share on other sites

  • 5 months later...
  • 3 months later...
  • Advanced Member

One thing im curious about the SDK is if there will be a more general version that allows for creating new tools and enhancements for the app. I think this and in app user scripting would be great but at the moment it seems like Export/Import features only.

Link to comment
Share on other sites

  • 1 year later...

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

 Share

×
×
  • Create New...