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.

Yayınlanmış Deneyimlerin Etkinleştirilmesi

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, 13 yaşından büyük ve kimlik doğrulanmış olmalısınız.Doğrulandıktan sonra, Studio'nun Oyun Ayarlarını açın, Güvenlik seçin ve Mesh / Resim API'lerine İzin Verme geçişini etkinleştirin.

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 gruba aitse)
• Kayıtlı Studio kullanıcısına ait olanlar (yer dosyası henüz Roblox'a kaydedilmedi veya yayınlanmadıysa).

Hafıza Sınırları

Düzenlenebilir varlıklar şu anda hafıza kullanımı için pahalıdır.Müşteri performansı üzerindeki etkisini en aza indirmek için, EditableMesh çok sıkı müşteri tarafı bellek bütçelerine sahiptir, sunucu, Studio ve eklentiler sınırsız bellekle çalışsa da.FixedSize kullanmak, hafıza bütçesinde kalmanıza yardımcı olabilir ve bazı senaryolarda, bir EditableMesh 'i çoklu MeshParts (çok referanslı) bağlamak, hafıza optimizasyonuna yardımcı olabilir.

Oluşturma ve Görüntüleme

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.

local AssetService = game:GetService("AssetService")

-- Boş Düzenlenebilir Mesh oluştur
local editableMesh = AssetService:CreateEditableMesh()

-- Varlık kimliğinden düzenlenebilir çerçeve oluştur Create EditableMesh from asset ID
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Diğer Düzenlenebilir Meshed'den Düzenlenebilir Meshed oluştur
local editableMeshFromAnother = nil
local success, errorMessage = pcall(function()
	editableMeshFromAnother = AssetService:CreateEditableMeshAsync(Content.fromObject(OTHER_EDITABLE_MESH))
end)

-- MeshPart'ten Düzenlenebilir Mesh oluştur
local editableMeshFromMeshPart = nil
local success, errorMessage = pcall(function()
	editableMeshFromMeshPart = AssetService:CreateEditableMeshAsync(MESH_PART.MeshContent)
end)

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 .

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

-- Varlık kimliğinden düzenlenebilir çerçeve oluştur Create EditableMesh from asset ID
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- Düzenlenebilir Mesh'e bağlı yeni MeshPart oluştur
local newMeshPart = nil
local success, errorMessage = pcall(function()
	newMeshPart = AssetService:CreateMeshPartAsync(Content.fromObject(editableMeshFromAsset))
end)

-- Alternatif olarak, yukarıda oluşturulan yeni MeshPart'i mevcut bir MeshPart'a bağlayın
local existingMeshPart = Workspace:FindFirstChild("EXISTING_MESH_PART")
existingMeshPart:ApplyMesh(newMeshPart)

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.

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.

local AssetService = game:GetService("AssetService")

-- Değiştirilebilir Mesh'i sabit boyutlu varsayım olmadan oluştur
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID), {FixedSize = false})
end)

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(editableMesh, vid0, vid1, vid2, vid3)
	local nid = editableMesh:AddNormal()  -- Bu, otomatik olarak hesaplanan normal bir kimlik oluşturur

	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

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

	editableMesh:RemoveUnused()
	return editableMesh
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.

FACS Pozları

Animasyonlu kafalar Yüz Eylem Kodlama Sistemi'ni (FACS) kullanır.FACS pozları referansına bakın, GetFacsPoses() ve benzer yöntemler kullanırken yararlı bilgi almak için.

Her FACS pozisyonu bir Enum.FacsActionUnit değeriyle belirtilir.FACS pozisyonu için, sanal kemikler her birinin kemiklerin bağlanma pozisyonundaki başlangıç CFrame 'ini bu FACS eylem birimi pozunun pozisyonu için CFrame 'e dönüştüren bir CFrame 'e sahip olabilir.Tüm kemik CFrames lokal alanındadır.

Bu FACS pozları animasyon sırasında birleştirilir.Bazen, temel pozların birleştirilmesi kötü sonuçlar verir.Bu durumlarda, özel kombinasyonların temel pozlarla birleştirilmesini daha hoş görünen bir düzeltici poz ile geçersiz kılabilirsiniz.Düzeltici bir pozisyon, 2 veya 3 Enum.FacsActionUnit değeri ile belirtilir.Temel bir FACS pozuna benzer şekilde, düzeltici bir poz için, sanal kemiklerin her birinin bağ bağlantısı pozundaki kemiklerin başlangıç dönüşümüne sahip olması gerekir, bu FACS düzeltici için.

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.