EditableMesh

EditableMesh mengubah meshes visual yang diterapkan saat terhubung ke MeshPart , memungkinkan pencarian dan modifikasi meshes baik di Studio maupun di pengalaman.

Sebuah EditableMesh dapat dibuat dari sebuah Content yang ada dari MeshPart atau ID mesh menggunakan AssetService:CreateEditableMeshAsync() , atau kosong EditableMesh dapat dibuat dengan AssetService:CreateEditableMesh() .Kemudian dapat ditampilkan, dimodifikasi, dan model tabrakannya diperbarui.Tidak semua langkah diperlukan; misalnya, Anda mungkin ingin membuat EditableMesh hanya untuk raycast tanpa pernah menampilkannya.

Sebuah EditableMesh ditampilkan saat terhubung ke MeshPart baru, melalui AssetService:CreateMeshPartAsync() .Anda dapat membuat lebih banyak instansi yang merujuk pada yang sama , atau tautkan ke yang ada melalui .

Untuk menghitung ulang kolisi dan geometri cairan setelah diedit, Anda dapat sekali lagi memanggil AssetService:CreateMeshPartAsync() dan MeshPart:ApplyMesh() untuk memperbarui MeshPart yang ada.Umumnya disarankan untuk melakukan ini pada akhir edit konsep, bukan setelah panggilan individu ke metode yang memanipulasi geometri.Perubahan visual pada mesh akan selalu segera dicerminkan oleh mesin, tanpa perlu memanggil AssetService:CreateMeshPartAsync() .

Mengaktifkan EditableMesh untuk Pengalaman Terpublikasi

Untuk tujuan keamanan, menggunakan EditableMesh gagal secara default untuk pengalaman yang dipublikasikan.Untuk mengaktifkan penggunaan, EditableMesh , Anda harus memiliki usia 13+ diverifikasi dan ID terverifikasi.Setelah Anda diverifikasi, buka Pengaturan Permainan Studio, pilih Keamanan , dan aktifkan toggle Izinkan API Mesh & Gambar .Ingatlah untuk meninjau Ketentuan Penggunaan sebelum mengaktifkan toggle.

Izin

Untuk mencegah penyalahgunaan, AssetService:CreateEditableMeshAsync() hanya akan memungkinkan Anda untuk memuat dan mengedit aset mesh:

• Yang dimiliki oleh pencipta pengalaman (jika pengalaman dimiliki oleh individu).
• Yang dimiliki oleh kelompok (jika pengalaman dimiliki oleh grup).
• Yang dimiliki oleh pengguna Studio yang masuk (jika file tempat belum disimpan atau dipublikasikan ke Roblox).

APIs membuang kesalahan jika digunakan untuk memuat aset yang tidak memenuhi kriteria di atas.

Mesh Ukuran Tetap

Saat membuat EditableMesh dari aset mesh yang ada (melalui AssetService:CreateEditableMeshAsync() ), mesh yang dihasilkan memiliki ukuran tetap secara default.Meshes ukuran tetap lebih efisien dalam hal memori tetapi Anda tidak dapat mengubah jumlah vertiks, wajah, atau atribut.Hanya nilai atribut vertex dan posisi yang dapat diedit.

ID Vertex/Wajah Stabil

Banyak metode EditableMesh banyak mengambil vertex , normal , UV , warna dan wajah ID.Ini diwakili sebagai bilangan bulat di Luau tetapi mereka membutuhkan penanganan khusus.Perbedaan utama adalah bahwa ID tetap stabil dan tetap sama bahkan jika bagian lain dari mesh berubah.Sebagai contoh, jika sebuah EditableMesh memiliki lima vertiks {1, 2, 3, 4, 5} dan Anda menghapus vertiks 4 , vertiks baru akan menjadi {1, 2, 3, 5} .

Perhatikan bahwa ID tidak dijamin berada dalam urutan dan mungkin ada lubang dalam penomoran, jadi saat mengulang melalui vertex atau wajah, Anda harus mengulang melalui tabel yang dikembalikan oleh GetVertices() atau GetFaces() .

Atribut Vertex Terbagi

Sebuah vertex adalah sudut wajah, dan terhubung secara topologis wajah bersama-sama.Vertiks dapat memiliki beberapa atribut: posisi, normal, koordinat UV, warna, dan transparansi.

Terkadang berguna untuk semua wajah yang menyentuh vertex untuk menggunakan nilai atribut yang sama, tetapi terkadang Anda akan ingin wajah yang berbeda menggunakan nilai atribut yang berbeda di vertex yang sama.Sebagai contoh, pada bola mulus, setiap vertex hanya akan memiliki satu normal.Sebaliknya, di sudut kubus, vertex akan memiliki 3 normal yang berbeda (satu untuk setiap wajah berdekatan).Anda juga dapat memiliki celah di koordinat UV atau perubahan tajam pada warna vertex.

Saat membuat wajah, setiap vertex akan secara default memiliki satu dari setiap atribut: satu normal, satu koordinat UV, dan satu warna/transparansi.Jika Anda ingin membuat celah, Anda harus membuat atribut baru dan menetapkannya di wajah.Sebagai contoh, kode ini akan membuat kubus tajam:

local AssetService = game:GetService("AssetService")

-- Dengan diberikan 4 ID sudut, menambahkan normal baru dan 2 segi tiga, membuat quad tajam
local function addSharpQuad(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- Ini membuat ID normal yang dihitung secara otomatis

	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

-- Membuat kubus dengan tepi yang meningkat di antara 6 sisi
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)  -- Depan
	addSharpQuad(eMesh, v1, v3, v4, v2)  -- Kembali
	addSharpQuad(eMesh, v1, v5, v7, v3)  -- Terpisah
	addSharpQuad(eMesh, v2, v4, v8, v6)  -- Tepat
	addSharpQuad(eMesh, v1, v2, v6, v5)  -- Bawah
	addSharpQuad(eMesh, v3, v7, v8, v4)  -- Atas

	eMesh:RemoveUnused()
	return eMesh
end

Memutar

Wajah mesh memiliki sisi depan dan sisi belakang.Saat menarik meshes, hanya bagian depan wajah yang ditarik secara default, meskipun Anda dapat mengubah ini dengan mengatur properti meshes' DoubleSided ke true.

Pesanan vertiks di sekitar wajah menentukan apakah Anda melihat ke depan atau ke kembali.Bagian depan wajah terlihat saat vertex berjalan searah jam terbalik di sekitarnya.

Keterbatasan

EditableMesh saat ini memiliki batas 60.000 vertex dan 20.000 segi tiga. Mencoba menambahkan terlalu banyak vertex atau segi tiga akan menyebabkan kesalahan.