Public Member Functions
	__init__ (self)

	__init__ (self, Model source)

	__init__ (self, Mesh source)

Model	__assign__ (self, Model source)

Model	__assign__ (self, Mesh source)

Model	__iadd__ (self, Model source)

Model	__iadd__ (self, Mesh source)

Model	transform (self, mat4 m)
	transform the whole Model with the matrix

Model	MakeCopy (self)
	make a copy of the source mesh.

	__init__ (self)

	displayOptions (self, bool showWireframe=True, bool showColored=True, bool showSeams=True, bool showSharpEdges=True, bool smoothView=False)
	Set the display options for the retopo/modeling/uv meshes.

int	getObjectsCount (self)
	get the retopo groups count

int	getCurrentObject (self)
	get the index of the current group

	setCurrentObject (self, int index)
	set the current group index

str	getObjectName (self, int group_index)
	get the retopo group name

	removeObject (self, int group_index)
	remove the group by index

	setObjectName (self, int index, str name)
	rename the group by index

	setObjectVisibility (self, int index, bool visible)
	set the group visibility

bool	getObjectVisibility (self, int index)
	get the group visibility

int	addObject (self, str name)
	add new retopo group

int	addMaterial (self, str name)
	add the new UV set/Material

	removeUnusedMaterials (self)
	remove all unused UV sets (not referred within the mesh)

vec4	getObjectReferenceColor (self, int group_index)
	get the group reference color

	setObjectReferenceColor (self, int group_index, vec4 color)
	set the group reference color

	selectedToObject (self, int group_index)
	move the selected faces to the group

Mesh	getWholeMesh (self)
	get the whole mesh from the retopo room

Mesh	selectedToMesh (self)
	get the selected faces as the Mesh object

Mesh	visibleToMesh (self)
	get the visible faces as the Mesh object

	addTransformed (self, Mesh mesh, mat4 Transform=mat4.Identity, BoolOpType b=BoolOpType.BOOL_MERGE, bool select=False, bool snap_to_existing=False)
	insert the mesh to the retopo/modeling room, each object of the mesh treated as the new retopo layer

Mesh	getObjectMesh (self, int group_index)
	get the mesh from some retopo group

	setObjectMesh (self, int group_index, Mesh mesh, mat4 transform=mat4.Identity)
	replace the retopo layer with mesh

int	duplicateObject (self, int group_index, str name=None, mat4 transform=mat4.Identity, bool select=False)
	duplicate the object (retopo group)

str	generateName (self, str base)
	generate unique name for the object, it will start as the string in base base

	clearObjectMesh (self, int group_index)
	remove all faces from the group

	clear (self)
	clear the whole mesh

	dropUndo (self)
	Drop the whole mesh to the undo queue, it is important if you want allow the user to undo your mesh changes, call it before your changes.

list	getSelectedFaces (self)
	get the list of selected faces

	setSelectedFaces (self, list faces)
	set the selected faces list

	selectFace (self, int face)
	select the face by index

	selectObject (self, int group_index, bool add_to_selected=True)
	select all feces in the group

list	getObjectFaces (self, int group_index)
	get the list of faces in the group

bool	isFaceSelected (self, int face)
	check if the face selected

	unselectAllFaces (self)
	unselect all faces

	expandSelection (self)
	expand the faces/vertices/edges selection to the connected geometry

	contractSelection (self)
	contract the faces/vertices/edges selection to the connected geometry

	selectedToEdges (self)
	convert faces/vertices selection to edges selection

	selectedToFaces (self)
	convert edges/vertices selection to faces selection

	selectedToVertices (self)
	convert faces/edges selection to vertices selection

list	getSelectedEdges (self)
	returns even amount of vertex indices, pairs os start and end vertices of the selected edges

	setSelectedEdges (self, list edges)
	set the selected edges list

	selectEdge (self, int vertex1, int vertex2)
	select the edge by vertex indices (add to selection)

bool	isEdgeSelected (self, int vertex1, int vertex2)
	check if the edge is selected, order of vertices has no matter

	unselectAllEdges (self)
	unselect all edges

list	getSelectedVertices (self)
	get the list of selected vertices

list	getSelectedVerticesWeights (self)
	get the soft selection weights of the selected vertices, 1 is maximum value

	setSelectedVertices (self, list vertices, list weights)
	set the selected vertices list

	selectVertex (self, int vertex, float weight=1.0)
	add the vertex to the selection

bool	isVertexSelected (self, int vertex)
	check if the vertex is selected

	unselectAllVertices (self)
	unselect all vertices

int	facesCount (self)
	get the faces count

int	vertsCount (self)
	get the positional vertices count

int	vertsUvCount (self)
	get the uv vertices count

	removeFace (self, int face)
	remove the face by index

int	createNewFace (self, int Group, int UVSet)
	create empty face, you need to call setFaceVertices to set the vertices, setFaceUVVerts to set the UV vertices

int	getFaceVertsCount (self, int face)
	get the vertices count over the face

int	getFaceVertex (self, int face, int vertex_index)
	get the vertex index over the face

list	getFaceVerts (self, int face)
	get the list of UV vertex indices over the face, pay attention UV vertices are not same as position vertices

	setFaceVerts (self, int face, list vertices)
	set the list of positional vertex indices over the face

bool	getFaceVisibility (self, int face)
	get the face visibility

	setFaceVisibility (self, int face, bool visibility)
	set the face visibility

float	getFaceSquare (self, int face)
	get the face square

float	getFaceUVSquare (self, int face)
	get the face square in UV space

vec3	getFaceNormal (self, int face)
	get the face normal

int	getFaceObject (self, int face)
	get the group index of the face

	setFaceObject (self, int face, int group)
	set the group index of the face

int	getFaceMaterial (self, int face)
	get the UV set index for the face

	setFaceMaterial (self, int face, int uv_set)
	set the UV set for the face

int	getFaceUvVertsCount (self, int face)
	get the amount of UV vertices over the face

int	getFaceUvVertex (self, int face, int vertex_index)
	get the UV vertex index over the face

list	getFaceUvVerts (self, int face)
	get the list of UV vertices indices over the face

	setFaceUvVerts (self, int face, list vertices)
	set the UV vertices for the face

vec3	getVertex (self, int vertex)
	get the vertex position in space

	setVertex (self, int vertex, vec3 position)
	set the vertex position in space

int	createNewVertex (self, vec3 position)
	create the positional vertex

vec2	getVertexUV (self, int uv_vertex)
	get the UV coordinates of the UV vertex

	setVertexUV (self, int uv_vertex, vec2 uv)
	set the UV for the UV vertex

int	createNewUvVertex (self, vec2 uv)
	create new UV vertex to be used for faces

vec3	getVertexNormal (self, int vertex)
	get vertex normal, calculated as average of adjacent faces normals

	updateNormals (self, bool for_snapping=True)
	update the vertex normals

	updateTopology (self)
	update the connectivity information, it should be called sometimes if you feel that the connectivity information lost due to some heavy operations

	cleanup (self)
	complete cleanul from non-manifolds or other problems, some faces may be removed

list	getVertsNearVertex (self, int vertex)
	get the list of vertices that are adjacent to the vertex

list	getFacesNearVertex (self, int vertex)
	get the list of faces that are adjacent to the vertex

list	getFaceNeighbors (self, int face)
	get the list of faces that are adjacent to the face

list	getFacesNearEdge (self, int vertex1, int vertex2)
	get the list of faces that are adjacent to the edge

bool	isOpenEdge (self, int vertex1, int vertex2)
	check if the edge is open

bool	isSharpEdge (self, int vertex1, int vertex2)
	check if the edge is sharp

	setEdgeSharpness (self, int vertex1, int vertex2, bool sharp)
	set the sharpness state for the edge

bool	isSeam (self, int vertex1, int vertex2)
	check if edge is seam

	setEdgeSeam (self, int vertex1, int vertex2, bool seam)
	set or clear the seam state for the edge

	collapseEdge (self, int vertex1, int vertex2)
	collapse the edge to the middle of the edge

int	islandsCount (self, int uv_set)
	get the islands count over the current uv-set

Mesh	islandToMesh (self, int uv_set, int island_index)
	get the mesh that contains the island, xy of each point is the UV coordinate.

Mesh	islandToMeshInSpace (self, int uv_set, int island_index)
	get the mesh that contains the island, each point is the coordinate in space (not the uv coordinate!).

list	getIslandVertexMapping (self, int uv_set, int island_index)
	get the mapping from the vertex index in the mesh that was got by islandToMesh to the vertex index in the original mesh

list	getIslandBorder (self, int uv_set, int island_index)
	get unsorted list of edges on the border of the island

list	getBorderBetweenIslands (self, int uv_set1, int island_index1, int uv_set2, int island_index2)
	get the border between two islands

vec2	getIslandVertexUv (self, int uv_set, int island_index, int vertex_index)
	get the uv coordinate of the positional vertex in the island

	meshToIsland (self, Mesh mesh, int uv_set, int island_index)
	use the mesh (that was previously got by islandToMesh) to replace the island in the current uv-set

	pack (self, int uv_set, bool rotate, bool shuffle)
	pack the islands in the current uv-set

	unwrap (self, int uv_set)
	unwrap the current uv-set

	toAbf (self, int uv_set, int island_index)
	unwrap the island using the ABF approach

	toLscm (self, int uv_set, int island_index)
	unwrap the island using the LSCM approach

	toGu (self, int uv_set, int island_index)
	unwrap the island using the GU (Globally Uniform) approach

	toPlanar (self, int uv_set, int island_index)
	unwrap the island using the Planar approach

	toStripe (self, int uv_set, int island_index)
	try to uwrap the island as the regular stripe

	extrudeSelected (self)
	Extrude the selected edges or selected faces without the actual moving of the extruded elements.

	moveSelectedFacesAlongFacesNormals (self, float displacement)
	move selected faces along the faces normals, trying to keep faces parallel to the original direction

	moveSelectedFacesAlongVertexNormals (self, float displacement)
	move selected faces along the vertex normals, each vertex displace on the same distance

	subdivideSelectedFaces (self, bool apply_catmull_clark=False)
	subdivide the selected faces

	subdivide (self, bool apply_catmull_clark=True)
	subdivide the whole mesh

	transformSelected (self, mat4 transform, bool apply_symmetry)
	apply the transformation to the selected elements

	scaleSelectedFacesClusters (self, float scale, ClusterScale method=ClusterScale.Uniform_Scaling)
	scale each selection cluster separately, to own center mass

	bevelOverSelectedVertices (self, float size)
	perform the bevel over the selected vertices.

	bevelOverSelectedEdges (self, float size, int segments=1, bool OldVariant=False)
	perform the bevel over the selected edges.

int	splitEdge (self, int vertex1, int vertex2, float position)
	split existing edge somewhere between vertices.

bool	connect (self, int vertex1, int vertex2)
	split existing edge somewhere between vertices.

bool	checkConnectivity (self, int vertex1, int vertex2)
	check if connecting the two vertices is possible

	connectSelectedVerts (self)
	connect selected vertices in smart way

	invertSelectedFacesTopoplogically (self)
	invert selected faces only within the connective area, if some objects has no selected faces, the selection there will not change

	inset (self, float distance)
	perform the inset over the selected faces

	shell (self)
	perform the shell operation over the selected faces.

	intrude (self)
	perform the intrude operation over the selected faces.

	relaxSelected (self)
	relax selected vergtices

	selectPath (self, int vertex1, int vertex2)
	select all edges on the path from vertex1 to vertex2 (add to existing edges selection)

list	getPath (self, int vertex1, int vertex2)
	get all vertices on the path from vertex1 to vertex2

Static Public Member Functions
Model	fromRetopo ()
	get the reference to the mesh in the retopo room

Model	fromModeling ()
	get the reference to the mesh in the modeling room, currently it is the same mesh as in the retopo room

Model	fromUv ()
	get the reference to the mesh in the uv room, pay attention that topology changes to that mesh may lead to instability!

Mesh	flattenSingleIsland (Mesh mesh, int method, bool optimize_rotation=True, bool scale_to_geometry=True)
	Flatten the mesh that consists of the single island.

Constructor & Destructor Documentation

◆ init() [1/4]

coat.Model.__init__ ( self )

◆ init() [2/4]

coat.Model.__init__	(		self,
		Model	source )

◆ init() [3/4]

coat.Model.__init__	(		self,
		Mesh	source )

◆ init() [4/4]

coat.Model.__init__ ( self )

Member Function Documentation

◆ assign() [1/2]

Model coat.Model.__assign__	(		self,
		Mesh	source )

◆ assign() [2/2]

Model coat.Model.__assign__	(		self,
		Model	source )

◆ iadd() [1/2]

Model coat.Model.__iadd__	(		self,
		Mesh	source )

◆ iadd() [2/2]

Model coat.Model.__iadd__	(		self,
		Model	source )

◆ addMaterial()

int coat.Model.addMaterial	(		self,
		str	name )

add the new UV set/Material

Parameters

name the name

Returns: the new UV set/Material index

◆ addObject()

int coat.Model.addObject	(		self,
		str	name )

add new retopo group

Parameters

name	the group name

Returns: the index of new group

◆ addTransformed()

coat.Model.addTransformed	(		self,
		Mesh	mesh,
		mat4	Transform = mat4.Identity,
		BoolOpType	b = BoolOpType.BOOL_MERGE,
		bool	select = False,
		bool	snap_to_existing = False )

insert the mesh to the retopo/modeling room, each object of the mesh treated as the new retopo layer

Parameters

mesh	the Mesh object
Transform	the transformation matrix
b	the boolean operation type
select	the flag that indicates if we need to select faces of the the inserted mesh, used only if b is BOOL_MERGE
snap_to_existing	the flag that indicates if we need to snap the mesh to the existing sculpt/paint objects

◆ bevelOverSelectedEdges()

coat.Model.bevelOverSelectedEdges	(		self,
		float	size,
		int	segments = 1,
		bool	OldVariant = False )

perform the bevel over the selected edges.

Parameters

size	the bevel width
OldVariant	if true the older variant of the bevel (splits edges in strightforward way), in some cases it works more stable.

◆ bevelOverSelectedVertices()

coat.Model.bevelOverSelectedVertices	(		self,
		float	size )

perform the bevel over the selected vertices.

As result, new faces will be selected

Parameters

size	the bevel size

◆ checkConnectivity()

bool coat.Model.checkConnectivity	(		self,
		int	vertex1,
		int	vertex2 )

check if connecting the two vertices is possible

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

Returns: true if connection is possible

◆ cleanup()

coat.Model.cleanup ( self )

complete cleanul from non-manifolds or other problems, some faces may be removed

◆ clear()

coat.Model.clear ( self )

clear the whole mesh

◆ clearObjectMesh()

coat.Model.clearObjectMesh	(		self,
		int	group_index )

remove all faces from the group

Parameters

group_index the group index

◆ collapseEdge()

coat.Model.collapseEdge	(		self,
		int	vertex1,
		int	vertex2 )

collapse the edge to the middle of the edge

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

◆ connect()

bool coat.Model.connect	(		self,
		int	vertex1,
		int	vertex2 )

split existing edge somewhere between vertices.

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

Returns: true if succeeed to connect

◆ connectSelectedVerts()

coat.Model.connectSelectedVerts ( self )

connect selected vertices in smart way

◆ contractSelection()

coat.Model.contractSelection ( self )

contract the faces/vertices/edges selection to the connected geometry

◆ createNewFace()

int coat.Model.createNewFace	(		self,
		int	Group,
		int	UVSet )

create empty face, you need to call setFaceVertices to set the vertices, setFaceUVVerts to set the UV vertices

Parameters

Group	the face group index
UVSet	the UV set index

Returns: the new face index

◆ createNewUvVertex()

int coat.Model.createNewUvVertex	(		self,
		vec2	uv )

create new UV vertex to be used for faces

Parameters

uv	the texture coordinates

Returns: the index

◆ createNewVertex()

int coat.Model.createNewVertex	(		self,
		vec3	position )

create the positional vertex

Parameters

position the position

Returns: the positional vertex index

◆ displayOptions()

coat.Model.displayOptions	(		self,
		bool	showWireframe = True,
		bool	showColored = True,
		bool	showSeams = True,
		bool	showSharpEdges = True,
		bool	smoothView = False )

Set the display options for the retopo/modeling/uv meshes.

Parameters

showWireframe	show the wireframe
showColored	show colored clusters
showSeams	show seams
showSharpEdges	show sharp edges
smoothView	smooth view

◆ dropUndo()

coat.Model.dropUndo ( self )

Drop the whole mesh to the undo queue, it is important if you want allow the user to undo your mesh changes, call it before your changes.

It works for UV room too.

◆ duplicateObject()

int coat.Model.duplicateObject	(		self,
		int	group_index,
		str	name = None,
		mat4	transform = mat4.Identity,
		bool	select = False )

duplicate the object (retopo group)

Parameters

group_index	the object/group index
name	the new name, if not passed the name will be generated automatically
transform	the additional transformation matrix
select	the flag that indicates if we need to select the new object's faces (in addition to existing selection)

Returns: the new object index

◆ expandSelection()

coat.Model.expandSelection ( self )

expand the faces/vertices/edges selection to the connected geometry

◆ extrudeSelected()

coat.Model.extrudeSelected ( self )

Extrude the selected edges or selected faces without the actual moving of the extruded elements.

They stay selected, so you amy apply some transform to the selected elements

◆ facesCount()

int coat.Model.facesCount ( self )

get the faces count

Returns: the faces count

◆ flattenSingleIsland()

Mesh coat.Model.flattenSingleIsland	(	Mesh	mesh,
		int	method,
		bool	optimize_rotation = True,
		bool	scale_to_geometry = True )

static

Flatten the mesh that consists of the single island.

Parameters

mesh	the mesh that consists of the single island
method	the flattening method. 0 - flatten to the plane, 1 - LSCM, 2 - ABF, 3 - GU, 4 - Stripe (if possible)
optimize_rotation	optimize the rotation of the island, place it approximately horizontally or vertically
scale_to_geometry	scale the island to keep average edge length equal to the average edge length of the original mesh

Returns: the flat mesh

◆ fromModeling()

Model coat.Model.fromModeling ( )

static

get the reference to the mesh in the modeling room, currently it is the same mesh as in the retopo room

Returns: the reference to the mesh

◆ fromRetopo()

Model coat.Model.fromRetopo ( )

static

get the reference to the mesh in the retopo room

Returns: the reference to the mesh

◆ fromUv()

Model coat.Model.fromUv ( )

static

get the reference to the mesh in the uv room, pay attention that topology changes to that mesh may lead to instability!

Returns: the reference to the mesh

◆ generateName()

str coat.Model.generateName	(		self,
		str	base )

generate unique name for the object, it will start as the string in base base

Parameters

base	the base name

Returns: the unique name

◆ getBorderBetweenIslands()

list coat.Model.getBorderBetweenIslands	(		self,
		int	uv_set1,
		int	island_index1,
		int	uv_set2,
		int	island_index2 )

get the border between two islands

Parameters

uv_set1	the uv set index of the first island
island_index1	the island index within the uv set of the first island
uv_set2	the uv set index of the second island
island_index2	the island index within the uv set of the second island

Returns: the list of edges that are common for both islands, even amount of elements, each pair of elements is the positional vertex indices of the original mesh

◆ getCurrentObject()

int coat.Model.getCurrentObject ( self )

get the index of the current group

Returns: the index

◆ getFaceMaterial()

int coat.Model.getFaceMaterial	(		self,
		int	face )

get the UV set index for the face

Parameters

face	the face index

Returns: the UV set index, -1 if out of range

◆ getFaceNeighbors()

list coat.Model.getFaceNeighbors	(		self,
		int	face )

get the list of faces that are adjacent to the face

Parameters

face	the face index

Returns: the list of adjacent faces

◆ getFaceNormal()

vec3 coat.Model.getFaceNormal	(		self,
		int	face )

get the face normal

Parameters

face	the face index

Returns: the face normal

◆ getFaceObject()

int coat.Model.getFaceObject	(		self,
		int	face )

get the group index of the face

Parameters

face	the face index

Returns: the group index

◆ getFacesNearEdge()

list coat.Model.getFacesNearEdge	(		self,
		int	vertex1,
		int	vertex2 )

get the list of faces that are adjacent to the edge

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

Returns: the list of adjacent faces

◆ getFacesNearVertex()

list coat.Model.getFacesNearVertex	(		self,
		int	vertex )

get the list of faces that are adjacent to the vertex

Parameters

vertex the vertex index

Returns: the list of adjacent faces

◆ getFaceSquare()

float coat.Model.getFaceSquare	(		self,
		int	face )

get the face square

Parameters

face	the face index

Returns: the square

◆ getFaceUVSquare()

float coat.Model.getFaceUVSquare	(		self,
		int	face )

get the face square in UV space

Parameters

face	the face index

Returns: the square

◆ getFaceUvVertex()

int coat.Model.getFaceUvVertex	(		self,
		int	face,
		int	vertex_index )

get the UV vertex index over the face

Parameters

face	the face index
vertex_index	the vertex index over the face

Returns: the UV vertex index, -1 if the vertex/face index is out of range

◆ getFaceUvVerts()

list coat.Model.getFaceUvVerts	(		self,
		int	face )

get the list of UV vertices indices over the face

Parameters

face	the face index

Returns: the list of UV vertices indices

◆ getFaceUvVertsCount()

int coat.Model.getFaceUvVertsCount	(		self,
		int	face )

get the amount of UV vertices over the face

Parameters

face	the face index

Returns: amount of vertices over the face, 0 if UV-s not assigned

◆ getFaceVertex()

int coat.Model.getFaceVertex	(		self,
		int	face,
		int	vertex_index )

get the vertex index over the face

Parameters

face	the face index
vertex_index	the vertex index over the face

Returns: the vertex index, -1 if the vertex/face index is out of range

◆ getFaceVerts()

list coat.Model.getFaceVerts	(		self,
		int	face )

get the list of UV vertex indices over the face, pay attention UV vertices are not same as position vertices

Parameters

face	the face index

Returns: the list of vertex indices

◆ getFaceVertsCount()

int coat.Model.getFaceVertsCount	(		self,
		int	face )

get the vertices count over the face

Parameters

face	the face index

Returns: the vertices count

◆ getFaceVisibility()

bool coat.Model.getFaceVisibility	(		self,
		int	face )

get the face visibility

Parameters

face	the face index

Returns: the visibility state

◆ getIslandBorder()

list coat.Model.getIslandBorder	(		self,
		int	uv_set,
		int	island_index )

get unsorted list of edges on the border of the island

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

Returns: the list of edges, even amount of elements, each pair of elements is the positional vertex indices of the original mesh

◆ getIslandVertexMapping()

list coat.Model.getIslandVertexMapping	(		self,
		int	uv_set,
		int	island_index )

get the mapping from the vertex index in the mesh that was got by islandToMesh to the vertex index in the original mesh

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

Returns: the list of the positional vertex indices of the original mesh in same order as the vertices in the mesh that was got by islandToMesh

◆ getIslandVertexUv()

vec2 coat.Model.getIslandVertexUv	(		self,
		int	uv_set,
		int	island_index,
		int	vertex_index )

get the uv coordinate of the positional vertex in the island

Parameters

uv_set	the uv set index
island_index	the island index within the uv set
vertex_index	the positional vertex index

Returns: the uv coordinate of the vertex, vec2(0,0) if the vertex is not in the island

◆ getObjectFaces()

list coat.Model.getObjectFaces	(		self,
		int	group_index )

get the list of faces in the group

Parameters

group_index the group index

Returns: the list of faces

◆ getObjectMesh()

Mesh coat.Model.getObjectMesh	(		self,
		int	group_index )

get the mesh from some retopo group

Parameters

group_index the group index

Returns: the Mesh object

◆ getObjectName()

str coat.Model.getObjectName	(		self,
		int	group_index )

get the retopo group name

Parameters

group_index the group index

Returns: the name

◆ getObjectReferenceColor()

vec4 coat.Model.getObjectReferenceColor	(		self,
		int	group_index )

get the group reference color

Parameters

group_index the group index

Returns: the (r,g,b,a) vector, 0..255

◆ getObjectsCount()

int coat.Model.getObjectsCount ( self )

get the retopo groups count

Returns: the amount

◆ getObjectVisibility()

bool coat.Model.getObjectVisibility	(		self,
		int	index )

get the group visibility

Parameters

index the group index

Returns: the visibility state

◆ getPath()

list coat.Model.getPath	(		self,
		int	vertex1,
		int	vertex2 )

get all vertices on the path from vertex1 to vertex2

Parameters

vertex1	the first vertex
vertex2	the second vertex

◆ getSelectedEdges()

list coat.Model.getSelectedEdges ( self )

returns even amount of vertex indices, pairs os start and end vertices of the selected edges

Returns: the list of vertex indices (pairs)

◆ getSelectedFaces()

list coat.Model.getSelectedFaces ( self )

get the list of selected faces

Returns: the list of selected faces

◆ getSelectedVertices()

list coat.Model.getSelectedVertices ( self )

get the list of selected vertices

Returns: the list of selected vertices

◆ getSelectedVerticesWeights()

list coat.Model.getSelectedVerticesWeights ( self )

get the soft selection weights of the selected vertices, 1 is maximum value

Returns: the list of weights, the size of the list is equal to the size of the selected vertices list

◆ getVertex()

vec3 coat.Model.getVertex	(		self,
		int	vertex )

get the vertex position in space

Parameters

vertex the vertex index

Returns: the position

◆ getVertexNormal()

vec3 coat.Model.getVertexNormal	(		self,
		int	vertex )

get vertex normal, calculated as average of adjacent faces normals

Parameters

vertex the vertex index

Returns: the normal

◆ getVertexUV()

vec2 coat.Model.getVertexUV	(		self,
		int	uv_vertex )

get the UV coordinates of the UV vertex

Parameters

uv_vertex the uv vertex index

Returns: teh UV coordinates

◆ getVertsNearVertex()

list coat.Model.getVertsNearVertex	(		self,
		int	vertex )

get the list of vertices that are adjacent to the vertex

Parameters

vertex the vertex index

Returns: the list of adjacent vertices

◆ getWholeMesh()

Mesh coat.Model.getWholeMesh ( self )

get the whole mesh from the retopo room

Returns: the Mesh object

◆ inset()

coat.Model.inset	(		self,
		float	distance )

perform the inset over the selected faces

◆ intrude()

coat.Model.intrude ( self )

perform the intrude operation over the selected faces.

After calling the intrude() you should call the moveSelectedFacesAlongFacesNormals or moveSelectedFacesAlongVertexNormals to give some thickness to the resulting figure

◆ invertSelectedFacesTopoplogically()

coat.Model.invertSelectedFacesTopoplogically ( self )

invert selected faces only within the connective area, if some objects has no selected faces, the selection there will not change

◆ isEdgeSelected()

bool coat.Model.isEdgeSelected	(		self,
		int	vertex1,
		int	vertex2 )

check if the edge is selected, order of vertices has no matter

Parameters

vertex1	the first vertex index
vertex2	the second vertex index

Returns: true if the edge is selected

◆ isFaceSelected()

bool coat.Model.isFaceSelected	(		self,
		int	face )

check if the face selected

Parameters

face	the face index

Returns: the selection state

◆ islandsCount()

int coat.Model.islandsCount	(		self,
		int	uv_set )

get the islands count over the current uv-set

Parameters

uv_set the uv-set index

Returns: teh islands count

◆ islandToMesh()

Mesh coat.Model.islandToMesh	(		self,
		int	uv_set,
		int	island_index )

get the mesh that contains the island, xy of each point is the UV coordinate.

The mesh contains only one island

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

Returns: the flat mesh

◆ islandToMeshInSpace()

Mesh coat.Model.islandToMeshInSpace	(		self,
		int	uv_set,
		int	island_index )

get the mesh that contains the island, each point is the coordinate in space (not the uv coordinate!).

The mesh contains only one island. The faces correspond to the faces of the mesh that was got by islandToMesh

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

Returns: s mesh the 3D mesh

◆ isOpenEdge()

bool coat.Model.isOpenEdge	(		self,
		int	vertex1,
		int	vertex2 )

check if the edge is open

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

Returns: true if open

◆ isSeam()

bool coat.Model.isSeam	(		self,
		int	vertex1,
		int	vertex2 )

check if edge is seam

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

Returns: true if seam

◆ isSharpEdge()

bool coat.Model.isSharpEdge	(		self,
		int	vertex1,
		int	vertex2 )

check if the edge is sharp

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)

Returns: true if sharp

◆ isVertexSelected()

bool coat.Model.isVertexSelected	(		self,
		int	vertex )

check if the vertex is selected

Parameters

vertex the vertex index

Returns: true if the vertex is selected

◆ MakeCopy()

Model coat.Model.MakeCopy ( self )

make a copy of the source mesh.

Pay attention, if you taken it from the retopo/uv context, it will no longer refer to the retopo/uv mesh, it will be independent copy

◆ meshToIsland()

coat.Model.meshToIsland	(		self,
		Mesh	mesh,
		int	uv_set,
		int	island_index )

use the mesh (that was previously got by islandToMesh) to replace the island in the current uv-set

Parameters

mesh	the mesh that was previously got by islandToMesh
uv_set	the uv set index
island_index	the island index within the uv set

◆ moveSelectedFacesAlongFacesNormals()

coat.Model.moveSelectedFacesAlongFacesNormals	(		self,
		float	displacement )

move selected faces along the faces normals, trying to keep faces parallel to the original direction

Parameters

displacement the displacement value

◆ moveSelectedFacesAlongVertexNormals()

coat.Model.moveSelectedFacesAlongVertexNormals	(		self,
		float	displacement )

move selected faces along the vertex normals, each vertex displace on the same distance

Parameters

displacement the displacement value

◆ pack()

coat.Model.pack	(		self,
		int	uv_set,
		bool	rotate,
		bool	shuffle )

pack the islands in the current uv-set

Parameters

uv_set	the uv set index
rotate	allow rotation while packing
shuffle	shuffle the identical islands to avoid the exact overlapping

◆ relaxSelected()

coat.Model.relaxSelected ( self )

relax selected vergtices

◆ removeFace()

coat.Model.removeFace	(		self,
		int	face )

remove the face by index

Parameters

face	the face index

◆ removeObject()

coat.Model.removeObject	(		self,
		int	group_index )

remove the group by index

◆ removeUnusedMaterials()

coat.Model.removeUnusedMaterials ( self )

remove all unused UV sets (not referred within the mesh)

◆ scaleSelectedFacesClusters()

coat.Model.scaleSelectedFacesClusters	(		self,
		float	scale,
		ClusterScale	method = ClusterScale.Uniform_Scaling )

scale each selection cluster separately, to own center mass

Parameters

scale the scale coefficient

◆ selectEdge()

coat.Model.selectEdge	(		self,
		int	vertex1,
		int	vertex2 )

select the edge by vertex indices (add to selection)

Parameters

vertex1	the first vertex index
vertex2	the second vertex index

◆ selectedToEdges()

coat.Model.selectedToEdges ( self )

convert faces/vertices selection to edges selection

◆ selectedToFaces()

coat.Model.selectedToFaces ( self )

convert edges/vertices selection to faces selection

◆ selectedToMesh()

Mesh coat.Model.selectedToMesh ( self )

get the selected faces as the Mesh object

Returns: the Mesh

◆ selectedToObject()

coat.Model.selectedToObject	(		self,
		int	group_index )

move the selected faces to the group

Parameters

group_index the group index

◆ selectedToVertices()

coat.Model.selectedToVertices ( self )

convert faces/edges selection to vertices selection

◆ selectFace()

coat.Model.selectFace	(		self,
		int	face )

select the face by index

Parameters

face	the face index

◆ selectObject()

coat.Model.selectObject	(		self,
		int	group_index,
		bool	add_to_selected = True )

select all feces in the group

Parameters

group_index the group index

◆ selectPath()

coat.Model.selectPath	(		self,
		int	vertex1,
		int	vertex2 )

select all edges on the path from vertex1 to vertex2 (add to existing edges selection)

Parameters

vertex1	the first vertex
vertex2	the second vertex

◆ selectVertex()

coat.Model.selectVertex	(		self,
		int	vertex,
		float	weight = 1.0 )

add the vertex to the selection

Parameters

vertex	the vertex index
weight	the soft selection weight, 1 is maximum value

◆ setCurrentObject()

coat.Model.setCurrentObject	(		self,
		int	index )

set the current group index

Parameters

index the index

◆ setEdgeSeam()

coat.Model.setEdgeSeam	(		self,
		int	vertex1,
		int	vertex2,
		bool	seam )

set or clear the seam state for the edge

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)
seam	the seam state

◆ setEdgeSharpness()

coat.Model.setEdgeSharpness	(		self,
		int	vertex1,
		int	vertex2,
		bool	sharp )

set the sharpness state for the edge

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)
sharp	the sharpness state

◆ setFaceMaterial()

coat.Model.setFaceMaterial	(		self,
		int	face,
		int	uv_set )

set the UV set for the face

Parameters

face	the face index
uv_set	the UV set index

◆ setFaceObject()

coat.Model.setFaceObject	(		self,
		int	face,
		int	group )

set the group index of the face

Parameters

face	the face index
group	the group index

◆ setFaceUvVerts()

coat.Model.setFaceUvVerts	(		self,
		int	face,
		list	vertices )

set the UV vertices for the face

Parameters

face	the face index
vertices	the UV vertices list

◆ setFaceVerts()

coat.Model.setFaceVerts	(		self,
		int	face,
		list	vertices )

set the list of positional vertex indices over the face

Parameters

face	the face index
vertices	the list of vertex indices

◆ setFaceVisibility()

coat.Model.setFaceVisibility	(		self,
		int	face,
		bool	visibility )

set the face visibility

Parameters

face	the face index
visibility	the visibility state

◆ setObjectMesh()

coat.Model.setObjectMesh	(		self,
		int	group_index,
		Mesh	mesh,
		mat4	transform = mat4.Identity )

replace the retopo layer with mesh

Parameters

group_index	the group index
mesh	the Mesh object to insert
transform	the transformation matrix

◆ setObjectName()

coat.Model.setObjectName	(		self,
		int	index,
		str	name )

rename the group by index

Parameters

index	the group index to rename
name	the new name

◆ setObjectReferenceColor()

coat.Model.setObjectReferenceColor	(		self,
		int	group_index,
		vec4	color )

set the group reference color

Parameters

group_index	the group index
color	the (r,g,b,a) vector, 0..255

◆ setObjectVisibility()

coat.Model.setObjectVisibility	(		self,
		int	index,
		bool	visible )

set the group visibility

Parameters

index	the group index
visible	the visibility state

◆ setSelectedEdges()

coat.Model.setSelectedEdges	(		self,
		list	edges )

set the selected edges list

Parameters

edges the edges indices list (should be even amount of indices)

◆ setSelectedFaces()

coat.Model.setSelectedFaces	(		self,
		list	faces )

set the selected faces list

Parameters

faces the faces indices list

◆ setSelectedVertices()

coat.Model.setSelectedVertices	(		self,
		list	vertices,
		list	weights )

set the selected vertices list

Parameters

vertices	the list of vertices indices
weights	the list of soft selection weights, the size of the list should be zero or equal to the size of the vertices list. If it is empty, the vertices will be selected with the maximal weight

◆ setVertex()

coat.Model.setVertex	(		self,
		int	vertex,
		vec3	position )

set the vertex position in space

Parameters

vertex	the vertex index
position	the position

◆ setVertexUV()

coat.Model.setVertexUV	(		self,
		int	uv_vertex,
		vec2	uv )

set the UV for the UV vertex

Parameters

uv_vertex	the uv vertex index
uv	the UV coordinates

◆ shell()

coat.Model.shell ( self )

perform the shell operation over the selected faces.

After calling the shell() you should call the moveSelectedFacesAlongFacesNormals or moveSelectedFacesAlongVertexNormals to give some thickness to the resulting figure

◆ splitEdge()

int coat.Model.splitEdge	(		self,
		int	vertex1,
		int	vertex2,
		float	position )

split existing edge somewhere between vertices.

Parameters

vertex1	the positional vertex index (1)
vertex2	the positional vertex index (2)
position	the position to split the edge, [0..1], 0 - near the vertex1, 1 - near the vertex2

Returns: the new vertex index

◆ subdivide()

coat.Model.subdivide	(		self,
		bool	apply_catmull_clark = True )

subdivide the whole mesh

Parameters

apply_catmull_clark apply the catmull-clark subdivision

◆ subdivideSelectedFaces()

coat.Model.subdivideSelectedFaces	(		self,
		bool	apply_catmull_clark = False )

subdivide the selected faces

Parameters

apply_catmull_clark apply the catmull-clark subdivision

◆ toAbf()

coat.Model.toAbf	(		self,
		int	uv_set,
		int	island_index )

unwrap the island using the ABF approach

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

◆ toGu()

coat.Model.toGu	(		self,
		int	uv_set,
		int	island_index )

unwrap the island using the GU (Globally Uniform) approach

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

◆ toLscm()

coat.Model.toLscm	(		self,
		int	uv_set,
		int	island_index )

unwrap the island using the LSCM approach

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

◆ toPlanar()

coat.Model.toPlanar	(		self,
		int	uv_set,
		int	island_index )

unwrap the island using the Planar approach

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

◆ toStripe()

coat.Model.toStripe	(		self,
		int	uv_set,
		int	island_index )

try to uwrap the island as the regular stripe

Parameters

uv_set	the uv set index
island_index	the island index within the uv set

◆ transform()

Model coat.Model.transform	(		self,
		mat4	m )

transform the whole Model with the matrix

Parameters

m	the transformation matrix

Returns: the reference to the Model

◆ transformSelected()

coat.Model.transformSelected	(		self,
		mat4	transform,
		bool	apply_symmetry )

apply the transformation to the selected elements

Parameters

transform	the transformation matrix
apply_symmetry	apply the global symmetry

◆ unselectAllEdges()

coat.Model.unselectAllEdges ( self )

unselect all edges

◆ unselectAllFaces()

coat.Model.unselectAllFaces ( self )

unselect all faces

◆ unselectAllVertices()

coat.Model.unselectAllVertices ( self )

unselect all vertices

◆ unwrap()

coat.Model.unwrap	(		self,
		int	uv_set )

unwrap the current uv-set

Parameters

uv_set the uv set index

◆ updateNormals()

coat.Model.updateNormals	(		self,
		bool	for_snapping = True )

update the vertex normals

Parameters

for_snapping if true, the normals will lay in the middle of faces, ne respecting the faces square.

◆ updateTopology()

coat.Model.updateTopology ( self )

update the connectivity information, it should be called sometimes if you feel that the connectivity information lost due to some heavy operations

◆ vertsCount()

int coat.Model.vertsCount ( self )

get the positional vertices count

Returns: the vertices count

◆ vertsUvCount()

int coat.Model.vertsUvCount ( self )

get the uv vertices count

Returns: the uv vertices count

◆ visibleToMesh()

Mesh coat.Model.visibleToMesh ( self )

get the visible faces as the Mesh object

Returns: teh Mesh

The documentation for this class was generated from the following file:

doxy/src/coat.py

Public Member Functions

Static Public Member Functions

Constructor & Destructor Documentation

◆ __init__() [1/4]

◆ __init__() [2/4]

◆ __init__() [3/4]

◆ __init__() [4/4]

Member Function Documentation

◆ __assign__() [1/2]

◆ __assign__() [2/2]

◆ __iadd__() [1/2]

◆ __iadd__() [2/2]

◆ addMaterial()

◆ addObject()

◆ addTransformed()

◆ bevelOverSelectedEdges()

◆ bevelOverSelectedVertices()

◆ checkConnectivity()

◆ cleanup()

◆ clear()

◆ clearObjectMesh()

◆ collapseEdge()

◆ connect()

◆ connectSelectedVerts()

◆ contractSelection()

◆ createNewFace()

◆ createNewUvVertex()

◆ createNewVertex()

◆ displayOptions()

◆ dropUndo()

◆ duplicateObject()

◆ expandSelection()

◆ extrudeSelected()

◆ facesCount()

◆ flattenSingleIsland()

◆ fromModeling()

◆ fromRetopo()

◆ fromUv()

◆ generateName()

◆ getBorderBetweenIslands()

◆ getCurrentObject()

◆ getFaceMaterial()

◆ getFaceNeighbors()

◆ getFaceNormal()

◆ getFaceObject()

◆ getFacesNearEdge()

◆ getFacesNearVertex()

◆ getFaceSquare()

◆ getFaceUVSquare()

◆ getFaceUvVertex()

◆ getFaceUvVerts()

◆ getFaceUvVertsCount()

◆ getFaceVertex()

◆ getFaceVerts()

◆ getFaceVertsCount()

◆ getFaceVisibility()

◆ getIslandBorder()

◆ getIslandVertexMapping()

◆ getIslandVertexUv()

◆ getObjectFaces()

◆ getObjectMesh()

◆ getObjectName()

◆ getObjectReferenceColor()

◆ getObjectsCount()

◆ getObjectVisibility()

◆ getPath()

◆ getSelectedEdges()

◆ getSelectedFaces()

◆ getSelectedVertices()

◆ getSelectedVerticesWeights()

◆ getVertex()

◆ getVertexNormal()

◆ getVertexUV()

◆ getVertsNearVertex()

◆ getWholeMesh()

◆ inset()

◆ intrude()

◆ invertSelectedFacesTopoplogically()

◆ isEdgeSelected()

◆ isFaceSelected()

◆ init() [1/4]

◆ init() [2/4]

◆ init() [3/4]

◆ init() [4/4]

◆ assign() [1/2]

◆ assign() [2/2]

◆ iadd() [1/2]

◆ iadd() [2/2]