questions about GetDDescription [SOLVED]

  • On 03/11/2014 at 15:43, xxxxxxxx wrote:

    User Information:
    Cinema 4D Version:   13+ 
    Platform:   Windows  ;   
    Language(s) :     C++  ;

    I have checked _LookAtCamera example, and this thread

    I understand how it works to some extent, but got some questions:
    1- in _ _LookAtCamera example, there is this snippet:

    const DescID* singleid = description->GetSingleDescID();

    DescID cid = DescLevel(6001, DTYPE_GROUP, 0);
    if (!singleid || cid.IsPartOf(*singleid, nullptr)) // important to check for speedup c4d!
    {;//code here}

    _GetSingleDescID() is not documented, so correct me at these points:
    a- I consider if it succeeds , it returns a value to singleid
    b- this if statement is entered only once at the first creation of the description elements, so it fits ONLY to non-changeable descriptions "similar to creating GUI using text files instead of C++ functions" , and I expect it to create garbage for a truly dynamic GUI
    c- initial values are 0 (because they are not set in the init function), so why using _SetBool(DESC_DEFAULT, true)

    2- the seconds question is so simple, I want to put the GUI in columns, similar to when you startup Cinema 4D, in the Project settings:
    FPS.......................30          Project Time........... 0 f
    Minimum Time......0 f           Maximum Time ...... 90 f

    3- what if I want to create a whole command menu inside a "right click", so if the user did a right click on a specific "gui text" this command menu appears


  • On 04/11/2014 at 02:45, xxxxxxxx wrote:

    for the ( 1-c ) question, I understand now how it works, it is the value of "reset to default" , other questions still need answers

    about question ( 2 ) , I know how to do it now, from this example:\_-\_my_C%2B%2B_plugins\_-\_object_converter

  • On 04/11/2014 at 05:44, xxxxxxxx wrote:

    Sometimes, Cinema will ask you for the description of only a single element. If the singleid you get is not nullptr, you should fill the Description only for this DescID and leave everything else out (important for performance reasons)

  • On 04/11/2014 at 07:35, xxxxxxxx wrote:

    thanks Niklas for clarification, so this function won't change the behavior of anything, just a performance check "so I can put it there and forget about it without worries"

    what about question 3

  • On 04/11/2014 at 11:15, xxxxxxxx wrote:

    Hi Mohamed,
    sorry, I wanted to get to your issues way earlier...
    To be honest, I'm not sure about question 3. I know, you can have your own popup menu (I think, that's what it is called in SDK docs) on a GeUserArea, when programming your own CustomGUI. But I don't think this is possible in normal descriptions. And I don't recall having seen this anywhere. Could you give me a pointer, if (and if, where) this is already done somewhere in C4D.
    There is an option to extend the existing popup menus in the same way, as normal menus (see Windows->Customization->Customize Menus to get an idea of the existing menus). Be aware: In this case your change will appear in every occasion this menu is used. I think, there should be very good reasons to go this road. User may not like, getting there popup menus changed.

  • On 04/11/2014 at 11:38, xxxxxxxx wrote:

    Hi Andreas,
    I think with your reply I'm getting closer to what I need Smile
    I'm creating a node based material system for my render engine, this material system will have also a tree view representation, this tree view should be able to do "right click" , then add nodes depending on the right click menu

    I think you got now an idea about what I'm after, any simple example of GeUserArea and CustomGUI would be appreciated, plus your guidelines 😉

  • On 04/11/2014 at 13:37, xxxxxxxx wrote:

    I'll extend the asynctest SDK example tomorrow morning to have a small popup menu.

  • On 04/11/2014 at 23:00, xxxxxxxx wrote:


    in SDK examples AsyncTest.cpp add the following enumeration for some menu IDs (code for R15+) :


    Then in Bool SDKGradientArea::InputEvent(const BaseContainer& msg) add the following as last else if:

        else if (chn == BFM_INPUT_MOUSERIGHT)
          BaseContainer bcPopupMenu;
          BaseContainer bcSubmenu;
          Int32 mx = msg.GetInt32(BFM_INPUT_X); // of course you can use mouse position to have popup menu be position sensitive
          Int32 my = msg.GetInt32(BFM_INPUT_Y);
          Global2Local(&mx, &my);
          Local2Screen(&mx, &my);
          // instead of building the menu everytime, you may better have a prepared container ready
          bcPopupMenu.SetString(MY_POPUP_ID_FIRST, "First menu entry");
          bcSubmenu.SetString(1, "A submenu");
          bcSubmenu.SetString(MY_POPUP_ID_SUBMENU_FIRST, "Submenu entry");
          bcPopupMenu.SetContainer(MY_POPUP_ID_SUBMENU, bcSubmenu);
          const Int32 menuId = ShowPopupMenu(nullptr, mx, my, bcPopupMenu);
          switch (menuId)
          case MY_POPUP_ID_FIRST:
            GePrint("Execute first popupmenu entry");
            GePrint("Execute first submenu entry");
          case 0:
            GePrint("Menu got canceled");
            DebugStop("Popup Menu: Forgot a new enum value?");
          // maybe use SendParentMessage() if need be

    The docs on this topic aren't that bad either: R16 SDK Docs: c4d_gui.h

  • On 05/11/2014 at 02:54, xxxxxxxx wrote:

    thanks a lot  , will test tonight and come back to you

  • On 05/11/2014 at 14:25, xxxxxxxx wrote:

    Hi Andreas,

    I have checked it!! , it is a very interesting example 👏 , this is really very helpful, thanks again for your support, keep the good work up

  • On 06/11/2014 at 02:13, xxxxxxxx wrote:

    just need to confirm about question ( 1-a , 1-b ) , I use this if statement in all created description, or no need at all? need some discussion about what happens here

  • On 06/11/2014 at 02:17, xxxxxxxx wrote:

    Can you show me a piece of your code? Will make discussion easier.

  • On 06/11/2014 at 03:00, xxxxxxxx wrote:

    it is the example LookAtCamera ,  LookAtCamera::GetDDescription(), all of the written description are created the same way with a check for performance, need to understand how this works, if there is no specific explanation , is it safe to do the same with all created description? (so I just write them the same way and forget about them) , or this is written in specific situations

  • On 06/11/2014 at 03:43, xxxxxxxx wrote:

    You mean the

    if (!singleid ||...

    Yes, you should do it exactly like it is done in the lookatcamera example. As Niklas said, it's a performance optimization, in case C4D is asking for a single description only.

  • On 06/11/2014 at 04:13, xxxxxxxx wrote:

    ok thanks 🙂

  • On 17/11/2014 at 10:01, xxxxxxxx wrote:

    sorry for asking again, but I found that I didn't know yet how to adjust the format of data "question (2)" , the above link that I posted was for Dialogs, didn't notice this, so hope you may reply with a simple example to question (2)

    edit:I find that DESC_COLUMNS is doing the job, but what about putting stuff in an irregular way, like:

    button1    button2    button3
    button5    button6

    edit2: I would love to know how to create something similar to this Dialog
    in GetDDescription() , the combo box, the radio group, etc..

  • On 17/11/2014 at 14:05, xxxxxxxx wrote:

    Ah, you were too quick. I was just compiling an example for you...
    Nevertheless glad you found your solution.

  • On 11/01/2016 at 05:14, xxxxxxxx wrote:

    Hi Andreas,

    as this is related to  ShowPopupMenu()
    how to put icons in the menu?

Log in to reply