TriangleMesh<T> Class


TriangleMeshT Class

TriangleMesh class defines the mesh that is created from triangles. Triangles are defined using the data from the TriangleIndices to combine three vertices (defined in Vertices).

Inheritance Hierarchy

SystemObject
  Ab4d.SharpEngine.CoreComponentBase
    Ab4d.SharpEngine.CoreInitializedSceneComponent
      Ab4d.SharpEngine.MeshesMesh
        Ab4d.SharpEngine.MeshesTriangleMeshT
          Ab4d.SharpEngine.MeshesStandardMesh

Namespace: Ab4d.SharpEngine.Meshes
Assembly: Ab4d.SharpEngine (in Ab4d.SharpEngine.dll) Version: 3.0.9208+3b2441d6a11f923f2600f40f4296bdc3d8b46035

Syntax

Copy

public class TriangleMesh<T> : Mesh, 
	IRayHitTestedObject, ITriangularMesh
where T : struct, new(), Object

Type Parameters

T

The TriangleMeshT type exposes the following members.

Constructors

	Name	Description
	TriangleMeshT(String)	Constructor
	TriangleMeshT(T, Int32, String)	Constructor
	TriangleMeshT(T, Int32, BoundingBox, String)	Constructor that also gets boundingBox.

Top

Properties

	Name	Description
	TriangleIndices	Array of integers that define the triangles (3 consecutive integers defined 3 indexes in the Vertices array that define a triangle). When the data in the TriangleIndices array are changed and if this mesh was already initialized (IsInitialized is true) then you need to call UpdateMesh or UpdateMesh(BoundingBox) method for the changes to take effect. When the TriangleIndices property is changed to another array, then UpdateMesh is called automatically.
	TrianglesCount	Gets the number of triangles that are used to define this mesh.
	Vertices	Array of vertices of the specified type T. When the data in the Vertices array are changed and if this mesh was already initialized (IsInitialized is true) then you need to call UpdateMesh or UpdateMesh(BoundingBox) method for the changes to take effect. When the Vertices property is changed to another array, then UpdateMesh is called automatically. Changing Vertices also calculates the new BoundingBox.

Top

Methods

	Name	Description
	GetClosestHitResult	GetClosestHitResult method returns a RayHitTestResult with the closest triangle hit by the specified ray. When no triangle is hit, null is returned.
	GetDataChannel	GetDataChannel returns an object with the data from the specified channel. For example, for Positions an array of Vector3 is returned with positions defined by this mesh. Executing this method may take some time because the method may need to create new array objects and copy data from some other data structure (for example an array of PositionNormalTextureVertex values). (Overrides MeshGetDataChannel(MeshDataChannelTypes))
	GetDetailsText	GetDetailsText method gets string with values of individual vertices and triangle indices of this mesh. (Overrides MeshGetDetailsText(Boolean, Boolean, Boolean, Int32, Int32, Int32))
	GetNextHitResult	GetNextHitResult method continues hit testing from the previously returned hit test and returns a RayHitTestResult with the next hit triangle (not necessary the next closest triangle) or null if no other triangle is hit. This method can be used to get all hit results.
	GetNormals	Returns an array of Vector3 that define the normals of this mesh. Executing this method may take some time because the method will need to create new array objects and copy data from the original vertices data structure (for example an array of PositionNormalTextureVertex values).
	GetPositions	Returns an array of Vector3 that define the positions of this mesh. Executing this method may take some time because the method will need to create new array objects and copy data from the original vertices data structure (for example an array of PositionNormalTextureVertex values).
	GetTextureCoordinates	Returns an array of Vector2 that define the texture coordinates of this mesh. Executing this method may take some time because the method will need to create new array objects and copy data from the original vertices data structure (for example an array of PositionNormalTextureVertex values).
	GetTrianglePositions	GetTrianglePositions sets the 3 positions that define the triangle with the specified index (max allowed triangleIndex is TrianglesCount - 1).
	HitTest	HitTest method test the triangles defined in this mesh for hitting with the specified ray. When getOnlyNextHitTest is false, then the closest hit result is returned, else the next hit result is returned. When no hit is found, null is returned.
	OnInitializeSceneResources	Initializes resources with the specified Scene and GpuDevice. This method can be overriden and is called from InitializeSceneResources(Scene) method. (Overrides MeshOnInitializeSceneResources(Scene, VulkanDevice))
	OnUpdateMesh	OnUpdateMesh (Overrides MeshOnUpdateMesh(Boolean))
	RecreateIndexBuffer	RecreateIndexBuffer recreates the index buffer from the mesh's TriangleIndices array. This method can be called only after the mesh and its Scene are initialized (Scene.GpuDevice is not null).
	RecreateIndexBuffer(BoundingBox)	RecreateIndexBuffer recreates the index buffer from the mesh's TriangleIndices array. It also sets the BoundingBox to a new value. This method can be called only after the mesh and its Scene are initialized (Scene.GpuDevice is not null).
	RecreateVertexBuffer(Boolean)	RecreateVertexBuffer recreates the vertex buffer from the mesh's Vertices array. It can also update the BondingBox of the mesh (when updateBoundingBox is true). This method can be called only after the mesh and its Scene are initialized (Scene.GpuDevice is not null).
	RecreateVertexBuffer(BoundingBox)	RecreateVertexBuffer recreates the vertex buffer from the mesh's Vertices array. It also sets the BoundingBox to a new value. This method can be called only after the mesh and its Scene are initialized (Scene.GpuDevice is not null).
	SetCustomIndexBuffer(Int32, GpuBuffer, Int32, Int32, IndexType)	Sets the TriangleIndices and a custom index buffer that is used to render the mesh.
	SetCustomIndexBuffer(Int32, GpuBuffer, BoundingBox, Int32, Int32, IndexType)	Sets the TriangleIndices and a custom index buffer that is used to render the mesh.
	SetCustomVertexBuffer(T, GpuBuffer, VertexBufferDescription)	SetCustomVertexBuffer can be used to change the Vertices and the vertex buffer that is used to render the mesh. This method also recalculates the bounding box of the mesh based on the new vertices. To prevent this, also pass the existing bounding box as a parameter.
	SetCustomVertexBuffer(T, GpuBuffer, BoundingBox, VertexBufferDescription)	SetCustomVertexBuffer can be used to change the Vertices and the vertex buffer that is used to render the mesh.
	SetTriangleIndices	Sets the TriangleIndices and controls if indexBuffer is updated and if NotifyMeshChange is called.
	SetVertices(T, BoundingBox)	SetVertices can be used to change the Vertices without calculating the new bounding box (the passes boundingBox is used instead).
	SetVertices(T, Boolean, Boolean, Boolean)	Sets the Vertices and controls what other operations will happen.
	UpdateBoundingBox	UpdateBoundingBox method calculates the BoundingBox from the Vertices.

Top

Reference

Ab4d.SharpEngine.Meshes Namespace

TriangleMeshT Class

Type Parameters

Reference