EditableMesh

EditableMesh cambia la malla visual aplicada cuando se enlaza a una MeshPart, permitiendo la búsqueda y la modificación de la malla tanto en Studio como en la experiencia.

Activación para experiencias publicadas

Para fines de seguridad, el uso de EditableMesh falla por defecto para las experiencias publicadas.Para habilitar el uso, debe tener 13 años o más verificados y verificado el ID.Después de verificarse, abra las Configuraciones de juego de Studio, seleccione Seguridad y habilite el botón Permitir API de malla / imagen .

Permisos

Para evitar el mal uso, AssetService:CreateEditableMeshAsync() solo te permitirá cargar y editar recursos de malla:

• Que son propiedad del creador de la experiencia (si la experiencia es propiedad de un individuo).
• Que son propiedad de un grupo (si la experiencia es propiedad del grupo).
• Que son propiedad del usuario de Studio iniciado de sesión (si el archivo del lugar aún no se ha guardado o publicado en Roblox).

Límites de memoria

Los recursos editables son actualmente costosos para el uso de memoria.Para minimizar su impacto en el rendimiento del cliente, EditableMesh tiene presupuestos estrictos de memoria del lado del cliente, aunque el servidor, Studio y los plugins operan con memoria ilimitada.El uso de FixedSize puede ayudarle a mantenerse dentro del presupuesto de memoria y, en algunos escenarios, vincular uno EditableMesh a múltiples MeshParts (multirespaldo) puede ayudar con la optimización de la memoria.

Creación y visualización

Un EditableMesh se puede crear a partir de un existente Content de un MeshPart o una ID de malla usando AssetService:CreateEditableMeshAsync() , o un vacío EditableMesh se puede crear con AssetService:CreateEditableMesh() .Luego se puede mostrar, modificar y actualizar su modelo de colisión.No todos los pasos son necesarios; por ejemplo, quizás quieras crear un EditableMesh sólo para raycast sin mostrarlo nunca.

local AssetService = game:GetService("AssetService")

-- Crear malla editable vacía
local editableMesh = AssetService:CreateEditableMesh()

-- Crear EditableMesh a partir de la ID del activo
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Crear EditableMesh a partir de otro EditableMesh
local editableMeshFromAnother = nil
local success, errorMessage = pcall(function()
	editableMeshFromAnother = AssetService:CreateEditableMeshAsync(Content.fromObject(OTHER_EDITABLE_MESH))
end)

-- Crear EditableMesh a partir de MeshPart
local editableMeshFromMeshPart = nil
local success, errorMessage = pcall(function()
	editableMeshFromMeshPart = AssetService:CreateEditableMeshAsync(MESH_PART.MeshContent)
end)

Un EditableMesh se muestra cuando está vinculado a un nuevo MeshPart , a través de AssetService:CreateMeshPartAsync() .Puedes crear más instancias que hagan referencia al mismo , o enlazar a una existente a través de .

local AssetService = game:GetService("AssetService")
local Workspace = game:GetService("Workspace")

-- Crear EditableMesh a partir de la ID del activo
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Crear una nueva pieza de malla vinculada a la EditableMesh
local newMeshPart = nil
local success, errorMessage = pcall(function()
	newMeshPart = AssetService:CreateMeshPartAsync(Content.fromObject(editableMeshFromAsset))
end)

-- Alternativamente, enlaza la nueva pieza de malla creada anteriormente a una pieza de malla existente
local existingMeshPart = Workspace:FindFirstChild("EXISTING_MESH_PART")
existingMeshPart:ApplyMesh(newMeshPart)

Para recalcular la geometría de colisión y fluidos después de editar, puedes volver a llamar AssetService:CreateMeshPartAsync() y MeshPart:ApplyMesh() para actualizar un MeshPart existente.Generalmente se recomienda hacer esto al final de una edición conceptual, no después de llamadas individuales a métodos que manipulan la geometría.Los cambios visuales en la malla siempre se reflejarán inmediatamente por el motor, sin la necesidad de llamar AssetService:CreateMeshPartAsync() .

Mallas de tamaño fijo

Al crear un EditableMesh desde un recurso de malla existente (a través de AssetService:CreateEditableMeshAsync() ), el resultante malla editable se fija de tamaño predeterminado por defecto.Las mallas de tamaño fijo son más eficientes en términos de memoria, pero no puedes cambiar el número de vértices, caras o atributos.Solo se pueden editar los valores de los atributos y posiciones de vértice.

local AssetService = game:GetService("AssetService")

-- Crear EditableMesh sin predeterminado de tamaño fijo
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID), {FixedSize = false})
end)

ID de vértice/cara estable

Muchos métodos EditableMesh toman vértice , normal , UV , color y cara IDs.Estos se representan como enteros en Luau, pero requieren un manejo especial.La diferencia principal es que las identidades son estables y se mantienen iguales incluso si cambian otras partes de la malla.Por ejemplo, si un EditableMesh tiene cinco vértices {1, 2, 3, 4, 5} y eliminas el vértice 4 , los nuevos vértices serán {1, 2, 3, 5} .

Tenga en cuenta que los ID no se garantizan que estén en orden y puede haber agujeros en la numeración, por lo que al iterar a través de vértices o caras, debe iterar a través de la tabla devuelta por GetVertices() o GetFaces() .

Atributos de vértice dividido

Un vértice es una esquina de una cara y se conecta topológicamente caras juntas.Los vértices pueden tener varios atributos: posición, normal, coordenada UV, color y transparencia.

A veces es útil para todas las caras que tocan un vértice usar los mismos valores de atributo, pero a veces querrás que diferentes caras usen diferentes valores de atributo en el mismo vértice.Por ejemplo, en una esfera lisa, cada vértice solo tendrá un normal.En contraste, en la esquina de un cubo, el vértice tendrá 3 normales diferentes (uno por cada cara adyacente).También puedes tener costuras en las coordenadas UV o cambios bruscos en los colores del vértice.

Al crear caras, cada vértice tendrá por defecto uno de cada atributo: uno normal, una coordenada UV y un color/transparencia.Si quieres crear una costura, deberás crear nuevos atributos y ponerlos en la cara.Por ejemplo, este código creará un cubo afilado:

local AssetService = game:GetService("AssetService")

-- Dados 4 ID de vértice, añade un nuevo normal y 2 triángulos, haciendo un cuadrado afilado
local function addSharpQuad(editableMesh, vid0, vid1, vid2, vid3)
	local nid = editableMesh:AddNormal()  -- Esto crea una identificación normal que se calcula automáticamente

	local fid1 = editableMesh:AddTriangle(vid0, vid1, vid2)
	editableMesh:SetFaceNormals(fid1, {nid, nid, nid})

	local fid2 = editableMesh:AddTriangle(vid0, vid2, vid3)
	editableMesh:SetFaceNormals(fid2, {nid, nid, nid})
end

-- Hace un cubo con bordes rebajados entre los 6 lados
local function makeSharpCube()
	local editableMesh = AssetService:CreateEditableMesh()

	local v1 = editableMesh:AddVertex(Vector3.new(0, 0, 0))
	local v2 = editableMesh:AddVertex(Vector3.new(1, 0, 0))
	local v3 = editableMesh:AddVertex(Vector3.new(0, 1, 0))
	local v4 = editableMesh:AddVertex(Vector3.new(1, 1, 0))
	local v5 = editableMesh:AddVertex(Vector3.new(0, 0, 1))
	local v6 = editableMesh:AddVertex(Vector3.new(1, 0, 1))
	local v7 = editableMesh:AddVertex(Vector3.new(0, 1, 1))
	local v8 = editableMesh:AddVertex(Vector3.new(1, 1, 1))

	addSharpQuad(editableMesh, v5, v6, v8, v7)  -- Delante
	addSharpQuad(editableMesh, v1, v3, v4, v2)  -- Volver
	addSharpQuad(editableMesh, v1, v5, v7, v3)  -- Izquierda
	addSharpQuad(editableMesh, v2, v4, v8, v6)  -- Derecha
	addSharpQuad(editableMesh, v1, v2, v6, v5)  -- Inferior
	addSharpQuad(editableMesh, v3, v7, v8, v4)  -- Superior

	editableMesh:RemoveUnused()
	return editableMesh
end

Enrollado

Las caras de malla tienen un lado frontal y un lado trasero.Cuando se dibujan mallas, solo se dibuja el frente de las caras por defecto, aunque puedes cambiar esto al establecer la propiedad de malla DoubleSided en true.

El orden de los vértices alrededor de la cara determina si estás mirando al frente o a la espalda.La frente del rostro es visible cuando los vértices van en sentido contrario alrededor de ella.

Posiciones de FACS

Las cabezas animables usan el Sistema de codificación de acciones faciales (FACS).Vea la referencia de poses de FACS para información útil al usar GetFacsPoses() y métodos similares.

Cada posición de FACS se especifica por un valor Enum.FacsActionUnit .Para la postura FACS, las huesos virtuales pueden tener cada una un CFrame que transforma el inicial CFrame de los huesos en la postura de enlazamiento de la malla en la postura de CFrame para la unidad de acción de FACS para esa postura.Todo el hueso CFrames está en el espacio local de la malla.

Estas poses de FACS se mezclan durante la animación.A veces, la mezcla de las poses base produce malos resultados.En esos casos, puedes anular la mezcla de combinaciones específicas de poses de base con una postura correctora que sea más agradable.Una postura correctiva se especifica por 2 o 3 valores Enum.FacsActionUnit correctivos.Al igual que una posa de FACS de base, para una posa correctiva, los huesos virtuales pueden tener cada uno un CFrame que transforme el CFrame inicial de los huesos en la posa de enlazamiento del modelo en el CFrame para ese corrector de FACS.

Limitaciones

EditableMesh actualmente tiene un límite de 60,000 vértices y 20,000 triángulos. Intentar agregar demasiados vértices o triángulos causará un error.