Povratne informacije Uredi

Meshes

  • Članak
  • 2 min. za čitanje

Mesh resource

Meshes are an immutable shared resource, that can only be created through model conversion. Meshes contain one or multiple submeshes along with a physics representation for raycast queries. Each submesh references a material with which it should be rendered by default. To place a mesh in 3D space, add a MeshComponent to an Entity.

Mesh resource properties

The Mesh class properties are:

  • Materials: An array of materials. Each material is used by a different submesh. Multiple entries in the array may reference the same material. This data cannot be modified at runtime.

  • Bounds: A local-space axis-aligned bounding box (AABB) of the mesh vertices.

MeshComponent

The MeshComponent class is used to place an instance of a mesh resource. Each MeshComponent references a single mesh. It may override which materials are used to render each submesh.

MeshComponent properties

  • Mesh: The mesh resource that is used by this component.

  • Materials: The array of materials specified on the mesh component itself. The array will always have the same length as the Materials array on the mesh resource. Materials that shall not be overridden from the mesh default, are set to null in this array.

  • UsedMaterials: The array of actually used materials for each submesh. Will be identical to the data in the Materials array, for non-null values. Otherwise it contains the value from the Materials array in the mesh instance.

Sharing of meshes

A Mesh resource can be shared across multiple instances of mesh components. Furthermore, the Mesh resource that is assigned to a mesh component can be changed programmatically at any time. The code below demonstrates how to clone a mesh:

Entity CloneEntityWithModel(RenderingConnection api, Entity sourceEntity)
{
    MeshComponent meshComp = sourceEntity.FindComponentOfType<MeshComponent>();
    if (meshComp != null)
    {
        Entity newEntity = api.CreateEntity();
        MeshComponent newMeshComp = api.CreateComponent(ObjectType.MeshComponent, newEntity) as MeshComponent;
        newMeshComp.Mesh = meshComp.Mesh; // share the mesh
        return newEntity;
    }
    return null;
}

ApiHandle<Entity> CloneEntityWithModel(ApiHandle<RenderingConnection> api, ApiHandle<Entity> sourceEntity)
{
    if (ApiHandle<MeshComponent> meshComp = sourceEntity->FindComponentOfType<MeshComponent>())
    {
        ApiHandle<Entity> newEntity = *api->CreateEntity();
        ApiHandle<MeshComponent> newMeshComp = api->CreateComponent(ObjectType::MeshComponent, newEntity)->as<RemoteRendering::MeshComponent>();
        newMeshComp->SetMesh(meshComp->GetMesh()); // share the mesh
        return newEntity;
    }
    return nullptr;
}

API documentation

Next steps