EditableMesh

EditableMesh zmienia zastosowaną sieć wizualną po połączeniu z MeshPart, umożliwiając zapytanie i modyfikację siatki zarówno w Studio, jak i w doświadczeniu.

Aktywacja dla opublikowanych doświadczeń

Ze względów bezpieczeństwa używanie EditableMesh nie powoduje błędu domyślnie dla opublikowanych doświadczeń.Aby włączyć użycie, musisz mieć 13+ lat zweryfikowane i zweryfikowane ID.Po weryfikacji otwórz Ustawienia gry w Studio, wybierz Bezpieczeństwo i włącz przełącznik Pozwolenie na API siatki/obrazu .

Uprawnienia

Aby zapobiec nadużyciu, AssetService:CreateEditableMeshAsync() pozwoli tylko na ładowanie i edytowanie zasobów siatki:

• Należą one do twórcy doświadczenia (jeśli doświadczenie należy do osoby fizycznej).
• Należące do grupy (jeśli doświadczenie należy do grupy).
• Należą one do użytkownika Studio zalogowanego (jeśli plik miejsca nie został jeszcze zapisany lub opublikowany w Roblox).

Ograniczenia pamięci

Edytowalne zasoby są obecnie drogie ze względu na zużycie pamięci.Aby ograniczyć jego wpływ na wydajność klienta, EditableMesh ma surowe budżety pamięci po stronie klienta, chociaż serwer, Studio i wtyczki działają z nieograniczoną pamięcią.Użycie FixedSize może pomóc utrzymać się w budżecie pamięci i, w niektórych scenariuszach, połączenie jednego EditableMesh z wieloma MeshParts (kilkukrotnym odwoływaniem) może pomóc w optymalizacji pamięci.

Tworzenie i wyświetlanie

An EditableMesh można utworzyć z istniejącego Content z MeshPart lub ID siatki za pomocą AssetService:CreateEditableMeshAsync() lub pustą EditableMesh można stworzyć za pomocą AssetService:CreateEditableMesh().Można go następnie wyświetlić, zmodyfikować i zaktualizować model kolizji.Nie wszystkie kroki są konieczne; na przykład możesz chcieć utworzyć EditableMesh tylko po to, aby wysłać promieniowanie, bez wyświetlania go nigdy.

local AssetService = game:GetService("AssetService")

-- Utwórz puste Edytowalne Mesh
local editableMesh = AssetService:CreateEditableMesh()

-- Twórz Edytowalną Sieć z ID zasobu
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Twórz Edytowalną Sieć z innej Edytowalnej Sieci
local editableMeshFromAnother = nil
local success, errorMessage = pcall(function()
	editableMeshFromAnother = AssetService:CreateEditableMeshAsync(Content.fromObject(OTHER_EDITABLE_MESH))
end)

-- Twórz edytowalną siatkę z części siatki
local editableMeshFromMeshPart = nil
local success, errorMessage = pcall(function()
	editableMeshFromMeshPart = AssetService:CreateEditableMeshAsync(MESH_PART.MeshContent)
end)

An EditableMesh jest wyświetlany, gdy jest powiązany z nowym MeshPart poprzez AssetService:CreateMeshPartAsync() .Możesz utworzyć więcej MeshPart instancji, które odwołują się do tego samego EditableMesh``Datatype.Content lub łączą się z istniejącym MeshPart poprzez MeshPart:ApplyMesh() .

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

-- Twórz Edytowalną Sieć z ID zasobu
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Utwórz nową część siatki powiązaną z Edytowaną siatką
local newMeshPart = nil
local success, errorMessage = pcall(function()
	newMeshPart = AssetService:CreateMeshPartAsync(Content.fromObject(editableMeshFromAsset))
end)

-- Alternatywnie, połącz nową część siatki utworzoną powyżej z istniejącą częścią siatki
local existingMeshPart = Workspace:FindFirstChild("EXISTING_MESH_PART")
existingMeshPart:ApplyMesh(newMeshPart)

Aby ponownie obliczyć kolizję i geometrię płynów po edycji, możesz ponownie wezwać AssetService:CreateMeshPartAsync() i MeshPart:ApplyMesh() , aby zaktualizować istniejący MeshPart.Zaleca się ogólnie zrobić to na końcu edycji koncepcyjnej, a nie po poszczególnych wezwaniach do metod, które manipulują geometrią.Wizualne zmiany w siatce zawsze będą natychmiast odzwierciedlone przez silnik, bez potrzeby wzywania AssetService:CreateMeshPartAsync() .

Naprawione siatki o stałym rozmiarze

Podczas tworzenia EditableMesh z istniejącego zasobu siatki (poprzez AssetService:CreateEditableMeshAsync() ), wynikowa edytowalna siatka jest domyślnie o stałej wielkości.Sieci o stałym rozmiarze są bardziej wydajne pod względem pamięci, ale nie możesz zmienić liczby wierzchołków, twarzy lub atrybutów.Tylko wartości atrybutów wierzchołków i pozycji mogą być edytowane.

local AssetService = game:GetService("AssetService")

-- Twórz edytowalną siatkę bez domyślnego rozmiaru
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID), {FixedSize = false})
end)

Stabilne ID punktów/twarzy

Wiele metod EditableMesh podaje wierzchołek , normalny , UV , kolor i twarz ID.Są reprezentowane jako liczby całkowite w Luau, ale wymagają pewnej specjalnej obsługi.Główną różnicą jest to, że identyfikatory są stabilne i pozostają takie same, nawet jeśli inne części siatki zmieniają się.Na przykład, jeśli EditableMesh ma pięć wierzchołków {1, 2, 3, 4, 5} i usuniesz wierzchołek 4, nowe wierzchołki będą {1, 2, 3, 5}.

Zauważ, że identyfikatory nie są gwarantowane do porządku i mogą wystąpić przerwy w numeracji, więc podczas iteracji przez węzły lub twarze powinieneś iterować przez tabelę zwrotzoną przez GetVertices() lub GetFaces().

Rozdzielone atrybuty wierzchołka

Wierzchołek jest krawędzią twarzy i łączy twarze topologicznie .Punkty mogą mieć kilka atrybutów: pozycję, normalną, koordynaty UV, kolor i przejrzystość.

Czasami przydatne jest, aby wszystkie twarze, które dotykają wierzchołka, używały tych samych wartości atrybutów, ale czasami będziesz chciał, aby różne twarze używały różnych wartości atrybutów na tym samym wierzchołku.Na przykład, na gładkiej kuli, każdy wierzchołek będzie miał tylko jedną normalną.W przeciwieństwie do tego, na krawędzi kostki będzie mieć 3 różne normalne (po jednym dla każdej przylegającej twarzy).Możesz także mieć szwy w koordynatach UV lub ostre zmiany w kolorach wierzchołków.

Podczas tworzenia twarzy każdy wierzchołek domyślnie będzie miał jeden z każdej cechy: jeden normalny, jedną koordynatę UV i jeden kolor/przezroczystość.Jeśli chcesz stworzyć szw, powinieneś utworzyć nowe atrybuty i umieścić je na twarzy.Na przykład ten kod stworzy ostry kubeł:

local AssetService = game:GetService("AssetService")

-- Dane 4 identyfikatory wierzchołków, dodaje nową normalną i 2 trójkąty, tworząc ostry kwadra
local function addSharpQuad(editableMesh, vid0, vid1, vid2, vid3)
	local nid = editableMesh:AddNormal()  -- Tworzy to normalną identyfikator, który jest automatycznie obliczany

	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

-- Tworzy kostkę z zaokrąglonymi krawędziami między 6 stronami
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)  -- Pród
	addSharpQuad(editableMesh, v1, v3, v4, v2)  -- Wróć
	addSharpQuad(editableMesh, v1, v5, v7, v3)  -- Lewo
	addSharpQuad(editableMesh, v2, v4, v8, v6)  -- Prawo
	addSharpQuad(editableMesh, v1, v2, v6, v5)  -- Dół
	addSharpQuad(editableMesh, v3, v7, v8, v4)  -- Góra

	editableMesh:RemoveUnused()
	return editableMesh
end

Windowanie

Oblicza siatki mają przód i tył.Podczas rysowania siatek tylko przednie części twarzy są rysowane domyślnie, choć możesz to zmienić, ustawiając właściwość siatki na wartość .

kolejność wierzchołków wokół twarzy decyduje, czy patrzysz na przód czy na tył.Przód twarzy jest widoczny, gdy wierzchołki krążą wokół niego w przeciwnym kierunku.

Pozy FACS

Animowane głowy korzystają z systemu kodowania akcji twarzowych (FACS).Zobacz odniesienie do pozy FACS, aby uzyskać pomocne informacje przy użyciu metod podobnych.

Każda poza FACS jest określona przez wartość Enum.FacsActionUnit.Dla pozy FACS wirtualne kości mogą każde mieć CFrame, które przekształca początkowe CFrame kości w pozie wiązania siatki w pozycji CFrame dla pozycji tej jednostki akcji FACS.Wszystkie kości CFrames znajdują się w lokalnej przestrzeni siatki.

Te pozy FACS są miksowane razem podczas animacji.Czasami mieszanie podstawowych pozycji daje słabe wyniki.W tych przypadkach możesz pominąć mieszanie konkretnych kombinacji pozy bazowych z pozą korygującą poprawiającą, która jest bardziej przyjemna.Poza korygująca jest określona przez 2 lub 3 wartości Enum.FacsActionUnit .Podobnie jak poza bazową pozą FACS, dla pozy korygującej wirtualne kości mogą każde mieć CFrame, które przekształcają początkowe CFrame w pozie wiązania siatki w prawidłową CFrame dla tej poprawki FACS.

Ograniczenia

EditableMesh obecnie ma ograniczenie 60 000 węzłów i 20 000 trójkątów. Dodawanie zbyt wielu węzłów lub trójkątów spowoduje błąd.