就业培训     下载中心     Wiki     联络 登录   注册

---

◆  GenerateSplinePrimitive()

Creates a built-in Cinema 4D primitive spline objects.

参数

[in]	doc	The document for the spline primitive object. The caller owns the pointed document.
[in]	type	The spline primitive type: Spline Primitive Types
[in]	bc	The settings for the spline primitive.
[in]	lod	The level of detail to use for the primitive.
[in]	bt	The thread to test for a break or nullptr . The caller owns the pointed thread.

返回

The primitive spline object or nullptr if failed. The caller owns the pointed object.

◆  CalcFaceNormal()

Calculates the normal of a polygon.

参数

[in]	padr	The points array.
[in]	v	The polygon.

返回

The face's normal.

◆  CalcLOD()

Helper function to modify a user chosen subdivision value.
范例：

参数

[in]	val	The user chosen LOD value.
[in]	lod	The LOD value, from BaseDocument::GetLOD() .
[in]	min	The minimum LOD.
[in]	max	The maximum LOD.

返回

The level of detail.

◆  DisjointMesh()

Separates the mesh of the object to make each polygon/line segment independent.
Each polygon/line will be given its own points thereby separating them so they can be moved independently, such as the Explosion object.

参数

[in]

op

The Point object to disjoint. The caller owns the pointed Point object.

返回

true if the mesh was disjointed successfully, otherwise false .

◆  FitCurve()

Creates a Spline object that has the best fit through the given points.

参数

[in]	padr	The points to fit a curve to. The caller owns the pointed array.
[in]	pcnt	The number of points in the point array padr .
[in]	error	Sets how closely the curve must match the passed points. The range for this is 0 to MAXRANGE . The lower the value then the closer the curve will match.
[in]	bt	The current thread, or nullptr for the main Cinema 4D thread. The caller owns the pointed thread.

返回

A Spline object that fits the given points, or nullptr if failed. The caller owns the pointed Spline object.

◆  Triangulate()

Turns the polygon mesh into triangles.

参数

[in]	padr	The points of the object to triangulate. The caller owns the pointed array.
[in]	pcnt	The number of points in the points array padr .
[out]	vadr	The polygons for the object. Assigned the triangulated polygons. The caller owns the pointed array. Can be assigned nullptr , always check.
[out]	vcnt	Assigned the triangulated count i.e. the number of polygons in the returned polygons array vadr .

返回

true if turning the polygons into triangles was successful, otherwise false .

◆  TriangulateStandard()

Triangulates the spline described by ( padr , pcnt ) and ( list , lcnt ) returning the result in ( vadr , vcnt ).

警告

The returned data vadr must be freed with DeleteMem()

参数

[in]	padr	The input points. The caller owns the pointed array.
[in]	pcnt	The number of input points in padr .
[in]	list	The input segments. A list with a Int32 for each segment, telling its length within the point array padr . The caller owns the pointed array.
[in]	lcnt	The number of input segments in list .
[out]	vadr	Assigned the output polygon array. The caller owns the pointed array.
[out]	vcnt	The number of polygons in vadr .
[in]	thread	The current thread, or nullptr for the main Cinema 4D thread. The caller owns the pointed thread.

返回

true if the spline was triangulated successfully, otherwise false .

◆  TriangulateRegular()

Triangulates the spline described by ( pinp , pinp_cnt ) and ( list , lcnt ) returning the result in ( padr , pcnt ) and ( vadr , vcnt ). Generates new points in a regular mesh specified by regular_width .

警告

The returned data ( padr , vadr ) must be freed with DeleteMem() .

参数

[in]	pinp	The input points. The caller owns the pointed array.
[in]	pinp_cnt	The number of input points in pinp .
[in]	list	The input segments. A list with a Int32 for each segment, telling its length within the point array padr . The caller owns the pointed array.
[in]	lcnt	The number of input segments in list .
[out]	padr	Assigned the output point array. The caller owns the pointed array.
[out]	pcnt	The number of output points in padr .
[out]	vadr	Assigned the output polygon array. The caller owns the pointed array.
[out]	vcnt	The number of output polygons in vadr .
[in]	regular_width	The width of the regular mesh.
[in]	thread	The current thread, or nullptr for the main Cinema 4D thread. The caller owns the pointed thread.

返回

true if the spline was triangulated successfully, otherwise false .

◆  GenerateText()

Creates a text object.

参数

[in]	cp	The container with settings for the text object.
[in]	bt	The current thread, or nullptr for the main Cinema 4D thread. The caller owns the pointed thread.
[in]	separate	true if the letters should be separate, otherwise false .

返回

The created text object or nullptr if failed. The caller owns the pointed object.

◆  CheckDisplayFilter()

Checks if an object is covered by a display filter.
范例：

// Get the BaseDraw's display filter DISPLAYFILTER filter = bd-> GetDisplayFilter (); if ( CheckDisplayFilter (op, filter)) { // Use object }

参数

[in]	op	The object to check. The caller owns the pointed object.
[in]	filter	The filter bitmask: DISPLAYFILTER

返回

true if the object is included in a display filter, otherwise false .

◆  CheckEditorVisibility()

Checks if an object is visible in the viewport including evaluation of parent hierarchies and layers. Combine with CheckDisplayFilter() to get the visibility in a certain BaseDraw .

由于

R16.050

参数

[in]

op

The object to check.

返回

true if the object state is visible, otherwise false .

◆  IntersectionTest()

Checks for a polygon intersection at position ( x / y ) in the view bd with object op and global matrix mg .
The resulting Z depth is assigned to z .

参数

[in]	op	The polygon object to check. The caller owns the pointed polygon object.
[in]	bd	The base draw to check the intersection in. The caller owns the pointed base draw.
[in]	x	The X coordinate to check.
[in]	y	The Y coordinate to check.
[in]	mg	The global matrix of the object.
[out]	z	Assigned the Z coordinate of the intersection if found.
[in]	mode	The intersection mode: MODELINGCOMMANDMODE 若 MODELINGCOMMANDMODE::POLYGONSELECTION only the selected polygons will be checked. 若 MODELINGCOMMANDMODE::POINTSELECTION only the polygons with at least one selected point in the passed array pPointselect will be checked. 若 MODELINGCOMMANDMODE::ALL everything will be checked.
[in]	pPointSelect	An optional point selection. The caller owns the pointed array.
[in]	lSelectCount	The number of points in pPointselect .

返回

The intersection result.

◆  ComputeLightColor()

Computes the color of a light source. Private .

◆  GetVirtualLineObject()

Gets a LineObject or SplineObject from a spline generator.

参数

[in]	op	The spline object. The caller owns the pointed base object.
[in]	hh	The HierarchyHelp usually passed from ObjectData::GetVirtualObjects() . The caller owns the pointed hierarchy help.
[in]	mloc	The local matrix of the spline object.
[in]	keep_spline	true to generate a SplineObject or false for a LineObject .
[in]	recurse	若 true and the object op itself did not generate a line object then Cinema 4D will search through all children and caches of op if any of those objects generates the line form.

注意

The caches are always searched.
If a spline is placed in An array object and the array under the generator then GetVirtualLineObject() will return the first "arrayed" spline.
For example, a Spline is put into a Null object placed under the generator.
With recurse == false then GetVirtualLineObject() return nullptr , if recurse == true then it would find the first child Spline of the Null object.

参数

[out]	mres	Assigned the local matrix of the object that created the line form.
[out]	dirty	Assigned true if the object that generated the spline was modified. In this case the generator knows that it must rebuild its cache.

返回

The LineObject or SplineObject from a spline generator. The caller owns the pointed base object.

◆  GenerateUVW()

Generates a UVW tag for an object.

参数

[in]	op	The object to generate the UVW coordinates for. The caller owns the pointed base object.
[in]	opmg	The object's global matrix.
[in]	tp	The texture tag to generate the UVW coordinates from. The caller owns the pointed texture tag.
[in]	texopmg	The global matrix of the object that carries the texture tag.
[in]	view	The current view or nullptr . The caller owns the pointed base view.

返回

The created UVW tag or nullptr if the texture type is already UV or if failed. If nullptr then the UVW tag must retrieved from the object itself. The caller owns the pointed UVW tag.

◆  CutReal()

Limits the float value with the specified id in the container data between min and max .

参数

[in]	data	The container with the value.
[in]	id	The ID of the float value.
[in]	min	The minimum value.
[in]	max	The maximum value.

◆  CutVector()

Limits the vector value with the specified id in the container data between min and max .

参数

[in]	data	The container with the value.
[in]	id	The ID of the vector value.
[in]	min	The minimum value.
[in]	max	The maximum value.

◆  CalculateVisiblePoints()

Checks which points in the points array padr of op are visible in the view bd .

参数

[in]	bd	The base draw to check. The caller owns the pointed base draw.
[in]	op	The polygon object to check. The caller owns the pointed polygon object.
[in]	padr	The points array. The caller owns the pointed points array.
[in]	pset	Assigned an array of size PointObject::GetPointCount() with the visibility status for each point: 1 if the point is visible otherwise 0 .
[in]	select_visibonly	若 true only points that are truly visible are included, otherwise e.g. points from the back of an object are included.

返回

true if successful, otherwise false .

• cinema.framework
• source
• c4d_baseobject.h