EditableMesh

EditableMesh bir MeshPart 'a bağlandığında uygulanan görsel çerçeveyi değiştirir, böylece hem Studio'da hem de deneyimde görselin sorgulanmasına ve değiştirilmesine izin verir.

Bir EditableMesh mevcut bir Content 'dan oluşturulabilir MeshPart veya bir örümcek kimliği kullanarak AssetService:CreateEditableMeshAsync() , veya boş bir EditableMesh ile yeni bir AssetService:CreateEditableMesh() oluşturulabilir.Ardından görüntülenebilir, değiştirilebilir ve çarpışma modeli güncellenebilir.Tüm adımlar gerekli değildir; örneğin, hiç görüntülemeden sadece EditableMesh ı yayınlamak istiyor olabilirsiniz.

Yeni bir EditableMesh ile bağlantı kurulduğunda, MeshPart aracılığıyla bir AssetService:CreateMeshPartAsync() görüntülenir.Aynı referans eden daha fazla örnek oluşturabilir veya mevcut bir aracılığıyla bağlantı kurabilirsiniz .

Düzenlemeden sonra çarpışma ve sıvı geometrisini yeniden hesaplamak için, mevcut bir MeshPart güncellemek için tekrar AssetService:CreateMeshPartAsync() ve MeshPart:ApplyMesh() 'yi arayabilirsiniz.Bu genellikle mantıksal bir düzenlemenin sonunda, geometriyi manipüle eden yöntemlere yapılan bireysel çağrılardan sonra yapılması önerilir.Kafenin görsel değişiklikleri daima hemen motor tarafından yansıtılacak ve AssetService:CreateMeshPartAsync() çağrılması gerekmeyecektir.

Yayınlanmış Deneyimler için Düzenlenebilir Mesh'i Etkinleştirme

Güvenlik amaçlarıyla, EditableMesh yayınlanmış deneyimler için varsayılan olarak başarısız olur.Kullanımı etkinleştirmek için, EditableMesh , 13+ yaş doğrulanmış ve Kimlik doğrulandıolmalısınız.Doğrulandıktan sonra, Studio'nun Oyun Ayarlarını açın, Güvenlik seçin ve Mesh & Image API'lerine İzin Verme geçişini etkinleştirin.Açma düğmesini etkinleştirmeden önce Kullanım Koşullarını incelemeyi unutmayın.

Yetkiler

Kötü kullanımı önlemek için, AssetService:CreateEditableMeshAsync() yalnızca çatı malzemelerini yüklemenize ve düzenlemenize izin verecektir:

• Deneyimin yaratıcısına ait olanlar (deneyim bir birey tarafından sahipleniyorsa).
• Bir grubun sahip olduğu (deneyim grupaitse)
• Kayıtlı Studio kullanıcısına ait olanlar (yer dosyası henüz Roblox'a kaydedilmedi veya yayınlanmadıysa).

APİ'ler yukarıdaki kriterlere uymayan bir varlığı yüklemeye kullanılırsa bir hata verir.

Kısa Boyutlu Örüntüler

Mevcut bir çerçeve varlığından EditableMesh bir çerçeve oluştururken (via AssetService:CreateEditableMeshAsync() ), sonraki düzenlenebilir çerçeve varsayılan olarak sabit boyuttadır.Konumlandırılmış boyutlu ızgaralar bellek açısından daha verimlidir, ancak nokta sayısını, yüzleri veya öznitelikleri değiştiremezsiniz.Sadece zirve özniteliklerinin ve pozisyonlarının değerleri düzenlenebilir.

Kararlı Vertex/Yüz Kimlikleri

Birçok EditableMesh yöntemi zirve , normal , UV , renk ve yüz ID'lerini alır.Bunlar Luau'da bütün sayılar olarak temsil edilir, ancak bazı özel davranışlar gerektirir.Ana fark, kimliklerin istikrarlı olması ve diğer parçalar değişse bile aynı kalmasıdır.Örneğin, bir EditableMesh eğer beş zirveye sahipse {1, 2, 3, 4, 5} ve vertex 4 kaldırırsanız, yeni zirveler olacak {1, 2, 3, 5} .

Kimliklerin düzenli olacağı garanti edilmez ve sayılarda delikler olabilir, bu nedenle vertex'lerden veya yüzlerden dolaşırken, GetVertices() veya GetFaces() tarafından döndürülen tablodan dolaşmalısınız.

Ayrık Veri Tabanı Özellikleri

Bir zirve bir yüzün köşesidir ve topolojik olarak yüzleri birbirine bağlar.Zirvelerin birkaç özelliği olabilir: konum, normal, UV koordinatı, renk ve saydamlık.

Bazen bir zirveye dokunan tüm yüzler için aynı özellik değerlerini kullanmak yararlıdır, ancak bazen farklı yüzlerin aynı zirvede farklı özellik değerlerini kullanmasını isteyeceksiniz.Örneğin, pürüzsüz bir kürede, her vertex sadece tek bir normal olacaktır.Buna karşılık, bir kübenin köşesinde, zirve 3 farklı normal olacaktır (her bir bitişik yüze için bir tane).Ayrıca UV koordinatlarında izler veya zirve renklerinde keskin değişiklikler olabilir.

Yüzleri oluştururken, her düğüm varsayılan olarak her bir özellikten birine sahip olacak: bir normal, bir UV koordinatı ve bir renk/透明度.Bir iz oluşturmak istiyorsanız, yeni öznitelikler oluşturmalı ve yüzüne yerleştirmelisiniz.Örneğin, bu kod keskin bir küp oluşturur:

local AssetService = game:GetService("AssetService")

-- 4 köşe kimliği verildiğinde, yeni bir normal ve 2 üçgen ekler, keskin bir dörtlü oluşturur
local function addSharpQuad(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- Bu, otomatik olarak hesaplanan normal bir kimlik oluşturur

	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

-- 6 taraf arasındaki kenarları artırılmış bir küp yapar
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)  -- Önden
	addSharpQuad(eMesh, v1, v3, v4, v2)  -- Geri
	addSharpQuad(eMesh, v1, v5, v7, v3)  -- Sola Yüksek
	addSharpQuad(eMesh, v2, v4, v8, v6)  -- Sağ
	addSharpQuad(eMesh, v1, v2, v6, v5)  -- Altı
	addSharpQuad(eMesh, v3, v7, v8, v4)  -- Üst

	eMesh:RemoveUnused()
	return eMesh
end

Döndürme

Mesh yüzlerinin bir ön tarafı ve arka tarafı vardır.Dokuları çizerken, yalnızca yüzlerin önü varsayılan olarak çizilir, ancak bunu değiştirmek için dokunun DoubleSided``true.

Yüzün etrafındaki köşegenlerin sırası, önü veya arkayı görüp görmediğinizi belirler.Zirveler etrafında saat yönünde dönerken yüzün önü görünür. The front of the face is visible when the vertices go counterclockwise around it.

Sınırlar

EditableMesh şu anda 60,000 zirve ve 20,000 üçgen sınırına sahiptir. Çok fazla zirve veya üçgen eklemek bir hata yol açar.