Plugin Cafe Homepage
Forum Home Forum Home > Plugin Cafe > SDK Help
  New Posts New Posts
  FAQ FAQ  Forum Search   Register Register  Login Login

C++ SDK Documentation Update for R17

 Post Reply Post Reply
Author
Message
Andreas Block View Drop Down
Forum Moderator
Forum Moderator
Avatar

Joined: 2014 Oct 01
Location: Hannover
Online Status: Offline
Posts: 1497
Post Options Post Options   Quote Andreas Block Quote  Post ReplyReply Direct Link To This Post Topic: C++ SDK Documentation Update for R17
    Posted: 2016 Jul 01 at 5:35am

User Information:

Cinema 4D Version:    
Platform:      
Language(s):       

---------

Hello,

many of you have requested changes to the SDK documentation.
Today we uploaded an updated C++ SDK documentation for R17.

See the announcement here.

Not saying, everything is perfect, now. Actually this is only the beginning. But the update should demonstrate the strategy for future documentation versions, we decided on.

Feedback on the new Overview/Manuals strategy would be very much appreciated.

Cheers,
your SDK Team

Back to Top
kbar View Drop Down
Member
Member
Avatar

Joined: 2009 Feb 12
Location: New Zealand
Online Status: Offline
Posts: 64
Post Options Post Options   Quote kbar Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Jul 03 at 1:49pm
I would advise everyone to clear their web cache before looking at the new documentation otherwise the menus on the left will be completely wrong.

Its all looking great. Looking forward to seeing more examples.

Also, where is the documentation for R18?

Edited by kbar - 2016 Jul 03 at 1:54pm
Back to Top
Andreas Block View Drop Down
Forum Moderator
Forum Moderator
Avatar

Joined: 2014 Oct 01
Location: Hannover
Online Status: Offline
Posts: 1497
Post Options Post Options   Quote Andreas Block Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Jul 04 at 12:09am
Thanks, Kent. I'll add a note on the browser cache to the blog entry.

On R18: Patience a gift is, young padawan.

Cheers,
Andreas
SDK Support Engineer
Back to Top
Andreas Block View Drop Down
Forum Moderator
Forum Moderator
Avatar

Joined: 2014 Oct 01
Location: Hannover
Online Status: Offline
Posts: 1497
Post Options Post Options   Quote Andreas Block Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 09 at 6:07am
Hello C++ community,

in parallel to the release of Cinema 4D R17 SP3 (17.053) the C++ SDK documentation has been updated once more.

Here is the changelog.

As always the new docs are available for browsing online and as downloads in HTML format and Windows HTML help format (.chm).

Cheers,
Andreas
SDK Support Engineer
Back to Top
ScottA View Drop Down
Member
Member


Joined: 2011 Jan 07
Online Status: Offline
Posts: 2288
Post Options Post Options   Quote ScottA Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 09 at 7:40am
"The __LEGACY_API define is no longer available"

Does this mean that plugins written with things like Long & Real will no longer work?


-ScottA
Back to Top
NiklasR View Drop Down
Member
Member


Joined: 2010 Dec 13
Location: Germany
Online Status: Offline
Posts: 2549
Post Options Post Options   Quote NiklasR Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 09 at 7:47am
Scott, yes that's what it means. But you can copy the R16 legacy.h file into
your project and include it.
Back to Top
Andreas Block View Drop Down
Forum Moderator
Forum Moderator
Avatar

Joined: 2014 Oct 01
Location: Hannover
Online Status: Offline
Posts: 1497
Post Options Post Options   Quote Andreas Block Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 09 at 8:25am
By the way, that's nothing that changed with the current update to 17.053, but happened already, when R17 got released.

Cheers,
Andreas
SDK Support Engineer
Back to Top
ScottA View Drop Down
Member
Member


Joined: 2011 Jan 07
Online Status: Offline
Posts: 2288
Post Options Post Options   Quote ScottA Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 09 at 8:38am
That sucks. But I guess it was inevitable.

-ScottA
Back to Top
fused View Drop Down
Member
Member
Avatar

Joined: 2007 Feb 24
Location: Germany
Online Status: Offline
Posts: 142
Post Options Post Options   Quote fused Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 11 at 8:18am
Originally posted by ScottA

"The <code>__LEGACY_API</code> define is no longer available"Does this mean that plugins written with things like Long & Real will no longer work?-ScottA



I just recently got rid of the legacy API, i.e. using all the new typenames.

For older c4d versions I support, I added a compatibility layer. Mostly typedefs for the new names. Some defines for gNew, gDelete etc...


#pragma once



#if PLUGIN_C4D_VERSION < 1500

typedef LONG Int32;
typedef ULONG UInt32;
typedef LLONG Int64;
typedef LULONG UInt64;
typedef VLONG Int;
typedef VULONG UInt;
...

#define NewObjClear(x, ...) gNew x(__VA_ARGS__)
#define DeleteObj(x) gDelete(x)

#define SetInt32 SetLong
#define SetFloat SetReal

...


You get the idea. Can share the whole thing if you want.

edit: How to avoid all these extra lines in code blocks?

Edited by fused - 2016 Aug 11 at 8:20am
Back to Top
ScottA View Drop Down
Member
Member


Joined: 2011 Jan 07
Online Status: Offline
Posts: 2288
Post Options Post Options   Quote ScottA Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 11 at 9:10am
I think I'm misunderstanding how this legacy API stuff works.
If I write a plugin using R13. That version uses things like LONG & Real. But AFAIK this plugin will still work in R17.
So I'm guess that the dropped legacy stuff is only a concern if I'm writing a plugin in R17+.
Is that correct?

Basically, I'm concerned about whether or not plugins written and compiled in R13 will continue to run in R17 & R18.


-ScottA
Back to Top
Andreas Block View Drop Down
Forum Moderator
Forum Moderator
Avatar

Joined: 2014 Oct 01
Location: Hannover
Online Status: Offline
Posts: 1497
Post Options Post Options   Quote Andreas Block Quote  Post ReplyReply Direct Link To This Post Posted: 2016 Aug 12 at 2:25am
Hi Scott,

yes, in most cases a 64-Bit plugin compiled against R13 SDK will still work in R17 and also R18.
Even though we do not recommend this, we still try to maintain binary compatibility as much as possible.

It were mainly naming changes introduced with R15 (as you can also see in fused's legacy header), so for example the change from LONG to Int32 involves no change in binary, the underlying integer is still the same. But with the new naming you can rely on the width of the integer on all platforms.

And yes, you will need to pay attention to these name changes only, if writing and compiling plugins against R15+ SDKs (with the option to keep the old style via __LEGACY_API define in R15 and R16).

@fused: Regarding extra lines in code blocks. I do have no issues with this here, posting from a Windows machine. Are you using a Mac? In general, I think, it's related to different line ending styles on the various platforms (and the good old forum not correctly caring for these). Using some decent editor with configurable line endings could help solve these issues.

Cheers,
Andreas
SDK Support Engineer
Back to Top
 Post Reply Post Reply

Forum Jump Forum Permissions View Drop Down

Bulletin Board Software by Web Wiz Forums® version 9.61 [Free Express Edition]
Copyright ©2001-2009 Web Wiz

This page was generated in 0.094 seconds.