Changes in Cineware SDK 20.0

Table of Contents

• New Features Support
• Added Features Support
• Node-Based Materials
• API Changes
  • customgui_field.h
  • customgui_gradient.h
  • c4d_operatordata.h
  • gv_node.h
  • gv_nodemaster.h
  • gv_port.h
  • c4d_basebitmap.h
  • c4d_baselist2d.h
  • c4d_basematerial.h
  • c4d_expressotagdata.h
  • c4d_filename.h
  • c4d_fracturevoronoidata.h
  • c4d_instanceobjectdata.h
  • c4d_parameter_ids.h
  • c4d_pointgenerator.h
  • c4d_renderconnection.h
  • c4d_string.h
  • c4d_system.h
  • c4d_volumebuilderdata.h
  • c4d_volumegroupdata.h

New Features Support

• Instance Object can be created and tweaked. Its matrix and color arrays can be set for multi-instance mode. See InstanceObjectData.

• Only Read/Copy/Write data:
  • Fields: FieldLayer, FieldList, iFieldCustomDatatype
  • Volume Builder and Group: VolumeBuilderData, cineware::VolumeGroupData VolumeGroupData

Added Features Support

• Only Read/Copy/Write data:
  • Fracture Voronoi and Point Generator: MoGraphFractureVoronoiObject, PointGenerator
  • XPresso Tag and Node Operators: GvExpressionData, GvOperatorData

Node-Based Materials

The Cineware SDK 20 does not give access to the node-based materials API so it is not possible to create node materials.

API Changes

customgui_field.h

// New header
 
using namespace cineware;
 
class FieldLayer;
class FieldList;
class iFieldCustomDatatype;

customgui_gradient.h

using namespace cineware;
 
GRADIENTPROPERTY_ALPHA_WITH_COLOR
GRADIENTPROPERTY_ALPHA
GRADIENTPROPERTY_NOEDITCOLOR
GRADIENTPROPERTY_NOPRESETS
GRADIENTPROPERTY_NOINTERPOLATION
GRADIENTPROPERTY_NOKNOTPOSITION
GRADIENTPROPERTY_NOBIASPOSITION
GRADIENTPROPERTY_NOBRIGHTNESS
 
enum GRADIENT_INTERPOLATION_TYPE;
 
class Gradient : public CustomDataType
{
  Bool CopyFrom(const Gradient* src);
 
  void ConvertToAlphaGradient();
  static void ConvertToAlphaGradient(BaseContainer* bc, Int32 id);
};

c4d_operatordata.h

// New header
 
using namespace cineware;
 
class GvOperatorData

gv_node.h

// New header
 
using namespace cineware;
 
enum GvNodeFlags;
enum GvOperatorType;
 
 
class GvRealNodeData;
class GvRealGroupData;
class GvRealNode;

gv_nodemaster.h

// New header
 
using namespace cineware;
 
class GvRealNodeMasterData;
class GvRealNodeMaster;

gv_port.h

// New header
 
using namespace cineware;
 
enum GvPortIO;
enum GvPortFlags;
 
class GvRealPort;

c4d_basebitmap.h

using namespace cineware;
 
class BaseBitmap
{
  static BaseBitmap* Alloc();
  static void Free(BaseBitmap*& bm);
};

c4d_baselist2d.h

using namespace cineware;
 
class BaseList2D : public GeListNode
{
  BaseContainer& GetDataInstanceRef();
};

c4d_basematerial.h

using namespace cineware;
 
class BaseMaterial : public BaseList2D
{
  Bool HasNimbusRef() const;
};

c4d_expressotagdata.h

// New header
 
using namespace cineware;
 
class GvExpressionData;

c4d_filename.h

using namespace cineware;
 
class Filename
{
  Bool Content() const;
  // Renamed
  Bool IsPopulated() const;
};

c4d_fracturevoronoidata.h

// New header
 
using namespace cineware;
 
class MoGraphFractureVoronoiObject;

c4d_instanceobjectdata.h

// New header
 
using namespace cineware;
 
class InstanceObjectData;

c4d_parameter_ids.h

using namespace cineware;
 
Ofield
 
Ovolumebuilder
Ovolumemesher
Ovolumegroup
 
Ovoronoipointgenerator
ID_MOTIONFRACTUREVORONOI
 
Talembicmorphtag
Tmeshattribute
Tvolumebuilder
 
VPpositionpass
VPnormalpass
VPPhLensDistortion
 
// Removed VPdemowatermark
VPwatermark

c4d_pointgenerator.h

// New header
 
using namespace cineware;
 
class PointGenerator;

c4d_renderconnection.h

using namespace cineware;
 
RENDERCONNECTION_COMMAND_RENDERMATERIALS
 
class IpCommunicationThread : public BaseCommunicationThread
{
  BaseDocument* RenderMaterials(BaseDocument* doc);
};

c4d_string.h

using namespace cineware;
 
class String
{
  Bool Content() const;
  // Renamed
  Bool IsPopulated() const;
};

c4d_system.h

using namespace cineware;
 
// Removed EPSILON90
// Removed EPSILON12
// Removed EPSILON16
 
EPSILON2
EPSILON3

c4d_volumebuilderdata.h

// New header
 
using namespace cineware;
 
class VolumeBuilderData;

c4d_volumegroupdata.h

// New header
 
using namespace cineware;
 
class VolumeGroupData;