rojo/.cursor/rules/roblox/reference/engine/classes/FileMesh.yaml
2026-02-02 12:08:47 -06:00

107 lines
3.6 KiB
YAML

# This file is automatically generated. Please don't edit it manually.
# To submit a bug report on the content, see
# https://devforum.roblox.com/c/bug-reports/documentation-issues/72
name: FileMesh
type: class
memory_category: BaseParts
summary: |
The FileMesh object applies a mesh to a `Class.BasePart` when parented to it.
Its properties are inherited by the `Class.SpecialMesh` object.
description: |
The FileMesh object applies a textured mesh to a `Class.BasePart` when
parented to it. Its properties are inherited by the `Class.SpecialMesh`
object.
## What is a FileMesh?
FileMeshes allow user uploaded meshes to be applied to a `Class.BasePart`. The
mesh that is applied is dependent on the `Class.FileMesh.MeshId` property. A
texture can also be applied to this mesh using `Class.FileMesh.TextureId`.
Although it is not an abstract class, and can be used by developers, all
`Class.FileMesh` properties are inherited by the `Class.SpecialMesh` object. A
`Class.SpecialMesh` behaves identically to the FileMesh object when its
`Class.SpecialMesh.MeshType` is set to 'FileMesh'. Although both objects are
functional, the `Class.SpecialMesh` object is the official supported class.
For more information on using meshes, please see the `Class.SpecialMesh` page.
code_samples:
- FileMesh-Offset-and-Scale
inherits:
- DataModelMesh
descendants:
- SpecialMesh
tags: []
deprecation_message: ''
properties:
- name: FileMesh.MeshId
summary: |
The MeshId is the content ID of the mesh that is to be displayed.
description: |
The MeshId is the content ID of the mesh that is to be displayed.
The content ID for a mesh is generated when a developer uploads a mesh to
Roblox.
code_samples:
- Mesh-VertexColor
type: ContentId
tags: []
deprecation_message: ''
security:
read: None
write: None
thread_safety: ReadSafe
category: Data
serialization:
can_load: true
can_save: true
capabilities:
- Basic
- name: FileMesh.TextureId
summary: |
The TextureId is the content ID of the texture that is to be applied to
the mesh.
description: |
The TextureId is the content ID of the image that is to be applied to used
for the meshes texture. When the TextureId property is set to an empty
string, no texture will be applied to the mesh.
#### How can I change the texture of a mesh?
Using the TextureId property, the texture of a mesh can be changed without
having to reupload the mesh. To do this, a new image will need to be
uploaded to Roblox with the desired texture. The original texture image
file can be obtained by exporting the mesh using the 'Export Selection'
option in Roblox Studio. The image file will be saved alongside the
exported .obj file.
The new texture can then be re-uploaded to Roblox as a Decal and its
content ID can be applied to the mesh using the TextureId property.
#### How can I make a textured mesh?
A mesh can only be textured if the mesh has been UV mapped. UV mapping
refers to the practice of projecting a texture map onto a mesh. This
cannot be done using Roblox Studio and has to be done using an external 3D
modelling application such as [Blender][1].
[1]: https://www.blender.org/
code_samples:
- Mesh-VertexColor
type: ContentId
tags: []
deprecation_message: ''
security:
read: None
write: None
thread_safety: ReadSafe
category: Data
serialization:
can_load: true
can_save: true
capabilities:
- Basic
methods: []
events: []
callbacks: []