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.

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.

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 Class.EditableMesh``Datatype.Content lub łączą się z istniejącym MeshPart poprzez MeshPart:ApplyMesh() .

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() .

Włączanie edytowalnej siatki 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, EditableMesh , musisz być zweryfikowany wiek 13+ i weryfikacja tożsamościtożsamość.Po weryfikacji otwórz Ustawienia gry w Studio, wybierz Bezpieczeństwo i włącz przełącznik Pozwolenie na API siatki i obrazu .Pamiętaj o przejrzeniu Warunków użytkowania przed włączeniem przełącznika.

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 grupa).
• Należą one do użytkownika Studio zalogowanego (jeśli plik miejsca nie został jeszcze zapisany lub opublikowany w Roblox).

APIs rzucają błąd, jeśli są używane do ładowania zasobu, który nie spełnia kryteriów powyżej.

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.

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(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- Tworzy to normalną identyfikator, który jest automatycznie obliczany

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

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

-- Tworzy kostkę z zaokrąglonymi krawędziami między 6 stronami
local function makeSharpCube()
	local eMesh = AssetService:CreateEditableMesh()

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

	addSharpQuad(eMesh, v5, v6, v8, v7)  -- Pród
	addSharpQuad(eMesh, v1, v3, v4, v2)  -- Wróć
	addSharpQuad(eMesh, v1, v5, v7, v3)  -- Lewo
	addSharpQuad(eMesh, v2, v4, v8, v6)  -- Prawo
	addSharpQuad(eMesh, v1, v2, v6, v5)  -- Dół
	addSharpQuad(eMesh, v3, v7, v8, v4)  -- Góra

	eMesh:RemoveUnused()
	return eMesh
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 wstecz.Przód twarzy jest widoczny, gdy wierzchołki krążą wokół niego w przeciwnym kierunku.

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.