c4d.modules.character – module for characters

Class

• CAWeightTag
• CAJointObject

Functions

• IdentifyImage()
• PainterActivateChannel()
• BPSetupWizardWithParameters()

c4d.modules.character.IdentifyImage(texpath)

Identifies the image’s file format.

Parameter:

texpath (str) – The path to the image.

Return type:

int

Returns:

The image’s file format, stored in c4d.bitmaps:

FILTER_TIF	TIF
FILTER_TGA	TGA
FILTER_BMP	BMP
FILTER_IFF	IFF
FILTER_JPG	JPG
FILTER_PICT	PICT
FILTER_PSD	PSD
FILTER_RLA	RLA
FILTER_RPF	RPF
FILTER_B3D	B3D
FILTER_TIF_B3D	TIFF B3D.
FILTER_AVI	AVI movie
FILTER_MOVIE	QuickTime movie.
FILTER_QTVRSAVER_PANORAMA	QTVR panorama
FILTER_QTVRSAVER_OBJECT	QTVR object
FILTER_HDR	HDR
FILTER_PNG	PNG

c4d.modules.character.PainterActivateChannel(channel, multi, enable)

Activation/deactivation of paint channels.

Parameters:

• channel (int) –

  The paint channel, stored in c4d:

  CHANNEL_COLOR	The color channel of the material.
  CHANNEL_LUMINANCE	The luminance channel of the material.
  CHANNEL_TRANSPARENCY	The transparency channel of the material.
  CHANNEL_REFLECTION	The reflection channel of the material.
  CHANNEL_ENVIRONMENT	The environment channel of the material.
  CHANNEL_FOG	The fog channel of the material.
  CHANNEL_BUMP	The bump channel of the material.
  CHANNEL_ALPHA	The alpha channel of the material.
  CHANNEL_SPECULAR	The specular channel of the material.
  CHANNEL_SPECULARCOLOR	The specular color channel of the material.
  CHANNEL_GLOW	The glow channel of the material.
  CHANNEL_DISPLACEMENT	The displacement channel of the material.
  CHANNEL_DIFFUSION	The diffusion channel of the material.
  CHANNEL_NORMAL	The normal channel of the material.
  CHANNEL_ANY	This specifies an unlabeled plugin channel.

• multi (bool) – True for multi channel painting, False for single channel painting.
• enable (bool) – True to activate the paint channel, False to deactivate the paint channel.

c4d.modules.character.BPSetupWizardWithParameters(doc, settings, objects, material)

Run the character 3D paint wizard.

Parameters:

• doc (BaseDocument) – The document
• settings (BaseContainer) –

  The container with the settings for the paint wizard, stored in c4d.modules.bitmaps:

  AMSI_CREATE_MISSING_MATERIALS	bool	Create materials and texturetag if they are missing.
  AMSI_CREATE_MISSING_CHANNELS	bool	Create missing texture channels.
  AMSI_AUTOSELECT_MATERIALS	bool	Autoselect materials from object selection.
  AMSI_AUTOSELECT_OBJECTS	bool	Autoselect objects from materials selection.
  AMSI_DELETE_BROKENMATERIALTAGS	bool	Delete material tags with broken material links.
  AMSI_ENABLEMATERIALS	bool	Enable all materials for painting.
  AMSI_SINGLEMATERIAL	bool	Enable all materials for painting.
  CREATE_CHANNEL	bool	Create missing texture channels (CREATE_CHANNEL + CHANNEL_ID).
  CREATE_CHANNEL_C	Vector	Channel color (CREATE_CHANNEL_C + CHANNEL_ID).
  AMSI_ENABLED	bool	Enable automatic mapsize interpolation, otherwise minimum size == texsize.
  AMSI_TEXW	int	Fixed texture size width.
  AMSI_TEXH	int	Fixed texture size height.
  AMSI_TEXMIN	int	Minimum texture size (width and height).
  AMSI_TEXMAX	int	Maximum texture size (width and height).
  AMSI_QUANTIZE	int	Quantize.
  AMSI_RESCALE_EXISTING	bool	Rescale existing material channels.
  AMSI_USE_SAME_RES	bool	Use the same texture size if already one channel exists.
  AMSI_UV_CALC_METHOD	int	Calculation mode:

  UV_CALC_METHOD_OPTIMAL1	Optimal Cube Mapping.
  UV_CALC_METHOD_OPTIMAL2	Optimal Angle Mapping.
  UV_CALC_METHOD_REALIGN	Realign.

  AMSI_UV_CALC_EXISTING	bool	Calculate UVs.
  AMSI_UV_RELAXATION	bool	Relax UVs.

• objects (any) – Any iteratable object, e.g: list, tuple.
• material (any) – Any iteratable object, e.g: list, tuple.

Return type:

bool

Returns:

Returns True if successfull, otherwise False.