tfg.geometry.representation.mesh.normals.vertex_normals

Computes vertex normals from a mesh.

tfg.geometry.representation.mesh.normals.vertex_normals(
    vertices: type_alias.TensorLike,
    indices: type_alias.TensorLike,
    clockwise: bool = True,
    name: str = 'normals_vertex_normals'
) -> type_alias.TensorLike

This function computes vertex normals as the weighted sum of the adjacent face normals, where the weights correspond to the area of each face. This function supports planar convex polygon faces. For non-triangular meshes, this function converts them into triangular meshes to calculate vertex normals.

In the following, A1 to An are optional batch dimensions.

vertices A tensor of shape [A1, ..., An, V, 3], where V is the number of vertices.
indices A tensor of shape [A1, ..., An, F, M], where F is the number of faces and M is the number of vertices per face.
clockwise Winding order to determine front-facing faces. The order of vertices should be either clockwise or counterclockwise.
name A name for this op. Defaults to "normals_vertex_normals".

A tensor of shape [A1, ..., An, V, 3] containing vertex normals. If vertices and indices have different batch dimensions, this function broadcasts them into the same batch dimensions and the output batch dimensions are the broadcasted.

ValueError If the shape of vertices, indices is not supported.