IDs and information for Omograph_tracer

Omograph_tracer

Attributes

• ENGLISH NAME : MotionGraphicsTracerObject
• NAME : Omograph_tracer
• INCLUDE : Obase
• PATH : mograph/description/omograph_tracer.res
• PLUGIN : mograph
• MAXON online help (may not exist): OMOGRAPH_TRACER

Elements

ID	UI Name	Type	Parameters	Cycle
MGTRACEROBJECT_OBJECTLIST	TraceLink	IN_EXCLUDE
MGTRACEROBJECT_MODE	TracingMode	LONG	FIT_H	MGTRACEROBJECT_MODE_TRACE TracePaths MGTRACEROBJECT_MODE_LINK ConnectAllObjects MGTRACEROBJECT_MODE_SEGLINK ConnectElements
MGTRACEROBJECT_SAMPLESTEP	SampleStep	LONG	MIN
MGTRACEROBJECT_ACTIVE	TraceActive	BOOL
MGTRACEROBJECT_USEPOINTS	TraceVertices	BOOL
MGTRACEROBJECT_USETPSUBGROUPS	UseTPSubgroups	BOOL
MGTRACEROBJECT_MGMODE	HandleCloners	LONG	FIT_H	MGTRACEROBJECT_MGMODE_SINGLE NodesOnly MGTRACEROBJECT_MGMODE_CHILDS ImmediateClones MGTRACEROBJECT_MGMODE_ACHILDS ClonesofClones
MGTRACEROBJECT_INCLUDECLONER	IncludeCloner	BOOL
MGTRACEROBJECT_SPACE	Space	LONG		MGTRACEROBJECT_SPACE_GLOBAL Global MGTRACEROBJECT_SPACE_LOCAL Local
MGTRACEROBJECT_LIMITMODE	Limit	LONG		MGTRACEROBJECT_LIMITMODE_NONE None MGTRACEROBJECT_LIMITMODE_START FromStart MGTRACEROBJECT_LIMITMODE_END FromEnd
MGTRACEROBJECT_LIMITMODE_AMMOUNT	Amount	LONG	MIN
MGTRACEROBJECT_REVERSESPLINE	ReverseSequence	BOOL

Example Code

The following code does not use the correct values when setting the data. You should check directly in C4D for the correct values that you should use in place of the ones that are shown. This code is just to show you how to access the values for getting and setting the parameters.

Python

import c4d
from c4d import gui
def main():
    obj = c4d.BaseObject(c4d.Omograph_tracer)
    doc.InsertObject(obj)
    c4d.EventAdd(c4d.EVENT_FORCEREDRAW)
    
    #You can set parameters two different ways. 
    #First way              
    obj[c4d.MGTRACEROBJECT_MODE] = c4d.MGTRACEROBJECT_MODE_TRACE
    obj[c4d.MGTRACEROBJECT_SAMPLESTEP] = 1
    obj[c4d.MGTRACEROBJECT_ACTIVE] = True
    obj[c4d.MGTRACEROBJECT_USEPOINTS] = True
    obj[c4d.MGTRACEROBJECT_USETPSUBGROUPS] = True
    obj[c4d.MGTRACEROBJECT_MGMODE] = c4d.MGTRACEROBJECT_MGMODE_SINGLE
    obj[c4d.MGTRACEROBJECT_INCLUDECLONER] = True
    obj[c4d.MGTRACEROBJECT_SPACE] = c4d.MGTRACEROBJECT_SPACE_GLOBAL
    obj[c4d.MGTRACEROBJECT_LIMITMODE] = c4d.MGTRACEROBJECT_LIMITMODE_NONE
    obj[c4d.MGTRACEROBJECT_LIMITMODE_AMMOUNT] = 1
    obj[c4d.MGTRACEROBJECT_REVERSESPLINE] = True
    
    #Second way, using the base container.
    bc = obj.GetDataInstance()
    bc.SetInt32(c4d.MGTRACEROBJECT_MODE,c4d.MGTRACEROBJECT_MODE_TRACE)
    bc.SetInt32(c4d.MGTRACEROBJECT_SAMPLESTEP,1)
    bc.SetBool(c4d.MGTRACEROBJECT_ACTIVE,True)
    bc.SetBool(c4d.MGTRACEROBJECT_USEPOINTS,True)
    bc.SetBool(c4d.MGTRACEROBJECT_USETPSUBGROUPS,True)
    bc.SetInt32(c4d.MGTRACEROBJECT_MGMODE,c4d.MGTRACEROBJECT_MGMODE_SINGLE)
    bc.SetBool(c4d.MGTRACEROBJECT_INCLUDECLONER,True)
    bc.SetInt32(c4d.MGTRACEROBJECT_SPACE,c4d.MGTRACEROBJECT_SPACE_GLOBAL)
    bc.SetInt32(c4d.MGTRACEROBJECT_LIMITMODE,c4d.MGTRACEROBJECT_LIMITMODE_NONE)
    bc.SetInt32(c4d.MGTRACEROBJECT_LIMITMODE_AMMOUNT,1)
    bc.SetBool(c4d.MGTRACEROBJECT_REVERSESPLINE,True)

if __name__=='__main__':
    main()
             

C++

#include "c4d.h"
#include "../mograph/description/omograph_tracer.h"
void SampleFunction()
{
    BaseDocument *pDoc = GetActiveDocument();
    BaseObject *pObject = BaseObject::Alloc(Omograph_tracer);
    pDoc->InsertObject(pObject);
    pDoc->StartUndo();
    pDoc->AddUndo(UNDO_NEW,pObject);
    pDoc->EndUndo();
    EventAdd(EVENT_FORCEREDRAW);
    
    //You can set parameters two different ways. 

    //First way              
    //Some objects do not store all their data in the container. You need to use GetParameter()/SetParameter() instead. 

    DESCFLAGS_SET flags = DESCFLAGS_SET_PARAM_SET;
    pObject->SetParameter(DescID(MGTRACEROBJECT_MODE),GeData(MGTRACEROBJECT_MODE_TRACE),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_SAMPLESTEP),GeData(1),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_ACTIVE),GeData(true),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_USEPOINTS),GeData(true),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_USETPSUBGROUPS),GeData(true),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_MGMODE),GeData(MGTRACEROBJECT_MGMODE_SINGLE),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_INCLUDECLONER),GeData(true),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_SPACE),GeData(MGTRACEROBJECT_SPACE_GLOBAL),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_LIMITMODE),GeData(MGTRACEROBJECT_LIMITMODE_NONE),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_LIMITMODE_AMMOUNT),GeData(1),flags);
    pObject->SetParameter(DescID(MGTRACEROBJECT_REVERSESPLINE),GeData(true),flags);
    pObject->Message(MSG_UPDATE);            

    //Second way, using the base container.
    BaseContainer *bc =     pObject->GetDataInstance();
    bc->SetInt32(MGTRACEROBJECT_MODE,MGTRACEROBJECT_MODE_TRACE);
    bc->SetInt32(MGTRACEROBJECT_SAMPLESTEP,1);
    bc->SetBool(MGTRACEROBJECT_ACTIVE,true);
    bc->SetBool(MGTRACEROBJECT_USEPOINTS,true);
    bc->SetBool(MGTRACEROBJECT_USETPSUBGROUPS,true);
    bc->SetInt32(MGTRACEROBJECT_MGMODE,MGTRACEROBJECT_MGMODE_SINGLE);
    bc->SetBool(MGTRACEROBJECT_INCLUDECLONER,true);
    bc->SetInt32(MGTRACEROBJECT_SPACE,MGTRACEROBJECT_SPACE_GLOBAL);
    bc->SetInt32(MGTRACEROBJECT_LIMITMODE,MGTRACEROBJECT_LIMITMODE_NONE);
    bc->SetInt32(MGTRACEROBJECT_LIMITMODE_AMMOUNT,1);
    bc->SetBool(MGTRACEROBJECT_REVERSESPLINE,true);
    pObject->Message(MSG_UPDATE);                                                      
}