EditableMesh

EditableMesh altera a malha visual aplicada quando vinculada a um MeshPart, permitindo a busca e modificação da malha tanto no Studio quanto na experiência.

Habilitando Experiências Publicadas

Para fins de segurança, usar EditableMesh falha por padrão para experiências publicadas.Para habilitar o uso, você deve ter idade 13+ verificada e ID verificada.Depois de verificado, abra as Configurações de Jogo do Studio, selecione Segurança e ative o botão Permitir APIs de Malha/Imagem .

Permissões

Para evitar o uso indevido, AssetService:CreateEditableMeshAsync() só permitirá que você carregue e edite recursos de malha:

• Que são de propriedade do criador da experiência (se a experiência for de propriedade de um indivíduo).
• Que pertencem a um grupo (se a experiência for de propriedade do grupo).
• Que são de propriedade do usuário do Studio logado (se o arquivo do lugar ainda não foi salvo ou publicado no Roblox).

Limites de Memória

Recursos editáveis são atualmente caros para uso de memória.Para minimizar seu impacto no desempenho do cliente, EditableMesh tem orçamentos de memória rigorosos do lado do cliente, embora o servidor, o Studio e os plugins operem com memória ilimitada.Usar FixedSize pode ajudá-lo a permanecer dentro do orçamento de memória e, em alguns cenários, ligar um EditableMesh a vários MeshParts (multiresposta) pode ajudar com a otimização de memória.

Criação e Exibição

Um EditableMesh pode ser criado a partir de um existente Content de um MeshPart ou um ID de malha usando AssetService:CreateEditableMeshAsync() , ou um vazio EditableMesh pode ser criado com AssetService:CreateEditableMesh() .Então, pode ser exibido, modificado e seu modelo de colisão atualizado.Nem todos os passos são necessários; por exemplo, você pode querer criar um EditableMesh apenas para raycast sem nunca exibi-lo.

local AssetService = game:GetService("AssetService")

-- Criar malha editável vazia
local editableMesh = AssetService:CreateEditableMesh()

-- Criar EditableMesh a partir do ID do recurso
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

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

-- Criar Modelo Editável a partir de MeshPart
local editableMeshFromMeshPart = nil
local success, errorMessage = pcall(function()
	editableMeshFromMeshPart = AssetService:CreateEditableMeshAsync(MESH_PART.MeshContent)
end)

Um EditableMesh é exibido quando está ligado a um novo MeshPart , através de AssetService:CreateMeshPartAsync() .Você pode criar mais instâncias que referenciam o mesmo , ou vincular a uma existente através de .

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

-- Criar EditableMesh a partir do ID do recurso
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Crie uma nova MeshPart ligada ao EditableMesh
local newMeshPart = nil
local success, errorMessage = pcall(function()
	newMeshPart = AssetService:CreateMeshPartAsync(Content.fromObject(editableMeshFromAsset))
end)

-- Alternativamente, vincule a nova MeshPart criada acima a uma MeshPart existente
local existingMeshPart = Workspace:FindFirstChild("EXISTING_MESH_PART")
existingMeshPart:ApplyMesh(newMeshPart)

Para recalcular a colisão e a geometria do fluido após a edição, você pode novamente chamar AssetService:CreateMeshPartAsync() e MeshPart:ApplyMesh() para atualizar um MeshPart existente.Geralmente é recomendado fazer isso no final de uma edição conceitual, não após chamadas individuais a métodos que manipulam geometria.As alterações visuais na malha sempre serão refletidas imediatamente pelo motor, sem a necessidade de chamar AssetService:CreateMeshPartAsync().

Malhas de Tamanho Fixo

Ao criar um EditableMesh a partir de um recurso de malha existente (via AssetService:CreateEditableMeshAsync() ), o resultante mesh editável é de tamanho fixo por padrão.Malhas de tamanho fixo são mais eficientes em termos de memória, mas você não pode alterar o número de vértices, faces ou atributos.Apenas os valores de atributos de vértice e posições podem ser editados.

local AssetService = game:GetService("AssetService")

-- Criar EditableMesh sem padrão de tamanho fixo
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID), {FixedSize = false})
end)

ID de Vetor/Rosto Estável

Muitos métodos EditableMesh de muitos vértice , normal , UV , cor e rosto IDs.Estes são representados como inteiros em Luau, mas requerem algum manuseio especial.A principal diferença é que os IDs são estáveis e permanecem os mesmos mesmo se outras partes da malha mudarem.Por exemplo, se um EditableMesh tiver cinco vértices {1, 2, 3, 4, 5} e você remover o vértice 4 , os novos vértices serão {1, 2, 3, 5} .

Observe que os IDs não são garantidos de estar em ordem e pode haver buracos na numeração, então, ao iterar por vértices ou faces, você deve iterar pela tabela retornada por GetVertices() ou GetFaces().

Atributos do vértice dividido

Um vértice é um canto de um rosto e conecta topologicamente rostos juntos.Vérteces podem ter vários atributos: posição, normal, coordenada UV, cor e transparência.

Às vezes, é útil para todos os rostos que tocarem um vértice usar os mesmos valores de atributo, mas às vezes você vai querer que rostos diferentes usem valores de atributo diferentes no mesmo vértice.Por exemplo, em uma esfera lisa, cada vértice terá apenas um normal.Em contraste, no canto de um cubo, o vértice terá 3 normais diferentes (um para cada face adjacente).Você também pode ter costuras nas coordenadas UV ou mudanças súbitas nas cores do vértice.

Ao criar rostos, cada vértice terá por padrão um de cada atributo: um normal, uma coordenada UV e uma cor/transparência.Se você quiser criar uma junta, deve criar novos atributos e defini-los no rosto.Por exemplo, este código criará um cubo afiado:

local AssetService = game:GetService("AssetService")

-- Dada 4 identidades de vértice, adiciona um novo normal e 2 triângulos, fazendo um quadrado afiado
local function addSharpQuad(editableMesh, vid0, vid1, vid2, vid3)
	local nid = editableMesh:AddNormal()  -- Isso cria um ID normal que é automaticamente calculado

	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

-- Cria um cubo com bordas irregulares entre os 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)  -- Frente
	addSharpQuad(editableMesh, v1, v3, v4, v2)  -- Voltar
	addSharpQuad(editableMesh, v1, v5, v7, v3)  -- Esquerda
	addSharpQuad(editableMesh, v2, v4, v8, v6)  -- Direita
	addSharpQuad(editableMesh, v1, v2, v6, v5)  -- Inferior
	addSharpQuad(editableMesh, v3, v7, v8, v4)  -- Primeiro

	editableMesh:RemoveUnused()
	return editableMesh
end

Enrolamento

Rostos de malha têm um lado frontal e um lado traseiro.Ao desenhar malhas, apenas a frente das faces é desenizada por padrão, embora você possa alterar isso definindo a propriedade da malha para .

A ordem dos vértices ao redor do rosto determina se você está olhando para a frente ou para trás.A frente do rosto é visível quando os vértices vão em sentido contrário ao redor dela.

Poses de FACS

Cabeças animáveis usam o Sistema de Codificação de Ação Facial (FACS).Veja a referência de poses FACS para informações úteis ao usar GetFacsPoses() e métodos semelhantes.

Cada posição FACS é especificada por um valor Enum.FacsActionUnit .Para a posa FACS, os ossos virtuais podem cada um ter um CFrame que transforma os ossos iniciais CFrame na posa de ligação do mesh para a posa CFrame daquela unidade de ação do FACS.Todo os ossos CFrames estão no espaço local da malha.

Essas poses FACS são misturadas durante a animação.Às vezes, a mistura das poses de base produz resultados ruins.Nesses casos, você pode anular a mistura de combinações específicas de poses de base com uma postura corretiva que seja mais agradável.Uma posição corretiva é especificada por 2 ou 3 valores Enum.FacsActionUnit corretos.Como uma posição FACS de base, para uma posição corretiva, os ossos virtuais podem cada um ter um CFrame que transforma o CFrame inicial dos ossos na posição de ligação do mesh para o CFrame para aquele FACS corretivo.

Limitações

EditableMesh atualmente tem um limite de 60.000 vértices e 20.000 triângulos. Tentar adicionar muitos vértices ou triângulos causará um erro.