#include <lib_modeling.h>

Detailed Description

With previous versions of Cinema 4D it was a hard to update plugin tags after modeling operations. They all had to be done manually per tool (at least in theory, not many plugins bothered!).

A solution to this problem are the tag translation messages. During Modeling::Commit() there are two points at which translations of tags can be done:

PRETRANSLATE: This is done before any changes to the object happen. It can be useful to use the old tag/polygon data to translate or to store this info for the translate;
e.g. edge selections and UVs both need to store old tag data and polygon data ready for the translation after the object is changed.
TRANSLATE: This is done after the object is changed.

Note: If Modeling::Commit() fails then TRANSLATE is called with nullptr so that any data stored from PRETRANSLATE can be released.

The TranslationMaps pointer is passed for the translation message data.
A simple example is the vertex map tag. Points are the easiest to translate. Polygons are pretty much the same too. Edges are much harder since they do not have any representation.
In the modeling library they are handled by storing (in PRETRANSLATE) information about the points/polygons that form the edges and use this in TRANSLATE to match up any edge changes.

Bool VertexMapTag::Message(Int32 type, void *data)
  {
    switch (type)
    {
      ...
    case MSG_TRANSLATE_POINTS:
      RemapVertexMap((Float*)t_data,(TranslationMaps*)data);
      break;
    }
    return SUPER::Message(type,data);
  }
 
  static void RemapVertexMap(Float *vmap, TranslationMaps *map)
  {
    if (map && map->m_pPointMap && map->m_nPointCount && vmap)
    {
      Int32 i,l,s;
      TransPointInterData *ipnt;
 
      // Processed any interpolated points
 
      for (i=0;i<map->m_mPointCount;i++)
      {
        if (!(map->m_pPointMap[i].lFlags & TRANSMAP_PNTFLAG_INTER)) continue;
        ipnt=&map->m_pInterpolatedPoints[map->m_pPointMap[i].mIndex];
        vmap[map->m_pPointMap[i].nIndex]=Mix(vmap[ipnt->p1],vmap[ipnt->p2],ipnt->t);
      }
 
      // Merge any welds
 
      for (i=0;i<map->m_mWeldCount;)
      {
        l=map->m_pWeldMap[i].nIndex; s=0;
 
        Float sum=0.0;
 
        while (i<map->m_mWeldCount && map->m_pWeldMap[i].nIndex==l)
        {
          if (map->m_pWeldMap[i].oIndex>=0)
          {
            sum+=vmap[map->m_pWeldMap[i].oIndex];
            s++;
          }
 
          i++;
        }
 
        if (s>0) sum=sum/Float(s);
 
        vmap[l]=sum;
      }
 
      // Remap any changes
 
      for (i=0;i<map->m_mPointCount;i++)
      {
        if (map->m_pPointMap[i].lFlags & (TRANSMAP_PNTFLAG_INTER|TRANSMAP_FLAG_DELETED)) continue;
 
        if (map->m_pPointMap[i].lFlags & TRANSMAP_FLAG_NEW)
          vmap[map->m_pPointMap[i].nIndex]=0.0;
        else if (map->m_pPointMap[i].nIndex!=map->m_pPointMap[i].oIndex)
          vmap[map->m_pPointMap[i].nIndex]=vmap[map->m_pPointMap[i].oIndex];
      }
    }
  }

Public Member Functions
	TranslationMaps ()

Int32	FindOriginalPoint (Int32 index)

Int32	FindOriginalPolygon (Int32 index)

Int32	FindOriginalPgon (Int32 index)

Int32	FindOriginalSegment (Int32 index)

Int32	FindNewPoint (Int32 index)

Int32	FindNewPolygon (Int32 index)

Int32	FindNewPgon (Int32 index)

Int32	FindNewSegment (Int32 index)

Int32	FindWeldPoint (Int32 index)

Int32	FindMeltPolygon (Int32 index)

Constructor & Destructor Documentation

◆ TranslationMaps()

TranslationMaps ( )

Constructor.

Member Function Documentation

◆ FindOriginalPoint()

Int32 FindOriginalPoint ( Int32 index )

Searches for the original (i.e old) index based on the new index. (A pure helper. The source for this function is available in lib_modeling.cpp.)

Parameters

[in] index The new index.

Returns: The old index.

◆ FindOriginalPolygon()

Int32 FindOriginalPolygon ( Int32 index )

Searches for the original (i.e old) index based on the new index. (A pure helper. The source for this function is available in lib_modeling.cpp.)

Parameters

[in] index The new index.

Returns: The old index.

◆ FindOriginalPgon()

Int32 FindOriginalPgon ( Int32 index )

Searches for the original (i.e old) index based on the new index. (A pure helper. The source for this function is available in lib_modeling.cpp.)

Parameters

[in] index The new index.

Returns: The old index.

◆ FindOriginalSegment()

Int32 FindOriginalSegment ( Int32 index )

Searches for the original (i.e old) index based on the new index. (A pure helper. The source for this function is available in lib_modeling.cpp.)

Parameters

[in] index The new index.

Returns: The old index.