About

NodeData based Cinema API plugin classes can implement NodeData::CopyTo(). This is usually only needed if internal data is not stored in the element's BaseContainer. If implemented, this function is called when Cinema 4D copies the element. Implementing this function is also needed to correctly support the undo system.

Note: If NodeData::CopyTo() is implemented typically also NodeData::Read() and NodeData::Write() should be implemented.

NodeData::CopyTo() corresponds to C4DAtom::CopyTo().

Usage

NodeData::CopyTo() is called when Cinema 4D copies the element. This can happen for various reasons and multiple times.

  Bool CopyTo(NodeData* dest, const GeListNode* snode, GeListNode* dnode, COPYFLAGS flags, AliasTrans* trn) const
  {
    ExampleGenerator* const destObject = static_cast<ExampleGenerator*>(dest);
    if (destObject == nullptr)
      return false;
 
    // copy internal data
    if (_branchHead)
    {
      GeListHead* destBranchHead = destObject->_branchHead;
      _branchHead->CopyTo(destBranchHead, flags, trn);
    }
 
    destObject->_value = this->_value;
 
    return SUPER::CopyTo(dest, snode, dnode, flags, trn);
  }

The arguments of the function are:

The destination plugin object as the base NodeData object.
The source node.
The destination node.
The flags for copy.
The AliasTrans object.

The copy-flags are:

COPYFLAGS::NO_HIERARCHY : Copy without children.
COPYFLAGS::NO_ANIMATION : Copy without tracks, sequences or keys.
COPYFLAGS::NO_BITS : Do not copy BaseList2D bits.
COPYFLAGS::NO_MATERIALPREVIEW : Do not create a new material preview.
COPYFLAGS::NO_BRANCHES : Do not copy branches, for example tags on an object. Automatically implies NO_ANIMATION, as animation is a branch.
COPYFLAGS::DOCUMENT : This is a read-only flag that is set when a complete document is copied.
COPYFLAGS::NO_NGONS : Do not copy N-gons.
COPYFLAGS::CACHE_BUILD : This is a read-only flag that is set when a cache is built.
COPYFLAGS::RECURSIONCHECK : Checks and avoids instances to cause recursions.

Table of Contents

About

Usage

Further Reading