EditableMesh

EditableMesh เปลี่ยนเมชภาพที่ใช้เมื่อเชื่อมโยงกับ MeshPart ทำให้สามารถสอบถามและแก้ไขเมชได้ทั้งใน Studio และในประสบการณ์

สามารถสร้าง EditableMesh จาก Content ที่มีอยู่แล้วของ MeshPart หรือ ID เมชที่ใช้ AssetService:CreateEditableMeshAsync() หรือ EditableMesh ว่างเปล่าสามารถสร้างได้ด้วย AssetService:CreateEditableMesh()จากนั้นสามารถแสดง ปรับแต่ง และอัปเดตโมเดลการชนกันได้ไม่ใช่ทุกขั้นตอนที่จำเป็น; ตัวอย่างเช่นคุณอาจต้องการสร้าง EditableMesh เพียงเพื่อส่งรังสีโดยไม่แสดงมันเลย

An EditableMesh จะแสดงเมื่อเชื่อมโยงกับ MeshPart ใหม่ผ่าน AssetService:CreateMeshPartAsync()คุณสามารถสร้าง instance เพิ่มเติม ที่อ้างอิงถึงเดียวกัน หรือเชื่อมโยงไปยัง instance ที่มีอยู่แล้ว ผ่าน

เพื่อคำนวณการชนกันและภาคภูมิศาสตร์ของของไหลอีกครั้งหลังการแก้ไขคุณสามารถโทร AssetService:CreateMeshPartAsync() และ MeshPart:ApplyMesh() อีกครั้งเพื่ออัปเดต MeshPart ที่มีอยู่โดยทั่วไปแนะนำให้ทำเช่นนี้ในตอนท้ายของการแก้ไขแนวคิด ไม่ใช่หลังจากการโทรแยกกันไปยังวิธีการที่จัดการเรขาคณิตการเปลี่ยนแปลงทางภาพกับเมชจะสะท้อนได้ทันทีโดยเครื่องยนต์เสมอโดยไม่จำเป็นต้องเรียก AssetService:CreateMeshPartAsync()

เปิดใช้งาน EditableMesh สำหรับประสบการณ์ที่เผยแพร่

เพื่อวัตถุประสงค์ด้านความปลอดภัยการใช้ EditableMesh ตรวจสอบยืนยันตัวตน, EditableMesh , คุณต้องมีอายุ 13+ และตรวจสอบไอดีแล้วหลังจากที่คุณได้รับการยืนยันแล้ว เปิดการตั้งค่าเกมของ Studio , เลือก ความปลอดภัย และเปิดใช้งานสวิตช์ อนุญาต API เมชและภาพ อย่าลืมตรวจสอบ เงื่อนไขการใช้งาน ก่อนเปิดใช้งานสลับ

สิทธิ์

เพื่อป้องกันการใช้งานผิดพลาด AssetService:CreateEditableMeshAsync() จะอนุญาตให้คุณโหลดและแก้ไขทรัพยากรเมชเท่านั้น:

• ที่เป็นเจ้าของโดยผู้สร้างประสบการณ์ (ถ้าประสบการณ์เป็นของบุคคล)
• ที่เป็นเจ้าของโดยกลุ่ม (หากประสบการณ์เป็นเจ้าของโดยกลุ่ม)
• ที่เป็นเจ้าของโดยผู้ใช้ Studio ที่ล็อกอินแล้ว (หากไฟล์สถานที่ยังไม่ถูกบันทึกหรือเผยแพร่ไปยัง Roblox)

API จะโยนข้อผิดพลาดหากใช้เพื่อโหลดสินทรัพย์ที่ไม่ตรงตามเกณฑ์ด้านบน

เมชขนาดคงที่

เมื่อสร้างเมช EditableMesh จากแอสเซทเมชที่มีอยู่แล้ว (ผ่าน AssetService:CreateEditableMeshAsync() ) เมชที่แก้ไขได้จะมีขนาดคงที่โดยค่าเริ่มต้นเมชขนาดคงที่มีประสิทธิภาพมากขึ้นในเรื่องของหน่วยความจํา แต่คุณไม่สามารถเปลี่ยนจํานวนเวอร์ซิส ใบหน้า หรือคุณสมบัติได้เฉพาะค่าของคุณสมบัติเวอร์เท็กซ์และตําแหน่งที่สามารถแก้ไขได้

ระยะเวลาแนวโน้ม/รหัสใบหน้าที่เสถียร

หลายวิธี EditableMesh ใช้ vertex , ปกติ , UV , สี และ ใบหน้า IDเหล่านี้จะถูกแทนที่เป็นจํานวนเต็มใน Luau แต่ต้องใช้การจัดการพิเศษความแตกต่างหลักคือตัวระบุมีความเสถียรและยังคงเหมือนเดิมแม้ว่าส่วนอื่นๆ ของเมทริกซ์จะเปลี่ยนแปลงตัวอย่างเช่น หาก EditableMesh มีเหลี่ยมมุมห้า {1, 2, 3, 4, 5} และคุณลบเหลี่ยมมุม 4 เหลี่ยมมุมใหม่จะเป็น {1, 2, 3, 5}

โปรดทราบว่าไอดีไม่ได้รับประกันว่าจะอยู่ในลำดับและอาจมีช่องว่างในการจัดเรียงตัวเลขดังนั้นเมื่อตรวจสอบผ่านเวอร์ติกหรือใบหน้าคุณควรตรวจสอบผ่านตารางที่ส่งคืนโดย GetVertices() หรือ GetFaces()

แยกลักษณะเวอร์เท็กซ์

เวอร์เท็กซ์ เป็นมุมของใบหน้า และเชื่อมต่อใบหน้าร่วมกันทางทฤษฎีจุดสามารถมีคุณสมบัติหลายอย่างได้ เช่น ตำแหน่ง ปกติ พิกัด UV สี และความโปร่งใส

บางครั้งมันมีประโยชน์สำหรับใบหน้าทั้งหมดที่สัมผัสเวอร์เน็กซ์เพื่อใช้ค่าคุณสมบัติเดียวกัน แต่บางครั้งคุณจะต้องการใบหน้าที่แตกต่างกันใช้ค่าคุณสมบัติที่แตกต่างกันบนเวอร์เน็กซ์เดียวกันตัวอย่างเช่นบนทรงกลมที่เรียบเนียนแต่ละเวกเซลจะมีเพียงเวกเดียวเท่านั้นในทางกลับกันที่มุมของลูกบาศก์เวอร์เน็กซ์จะมี 3 ปกติที่แตกต่างกัน (หนึ่งสำหรับใบหน้าที่อยู่ติดกันแต่ละอัน)คุณยังสามารถมีรอยต่อในพิกัด UV หรือการเปลี่ยนแปลงอย่างกะทันหันในสีเวอร์เน็กซ์ได้

เมื่อสร้างใบหน้า ทุกเหลี่ยมจะมีค่าเริ่มต้นของแต่ละคุณสมบัติหนึ่ง: หนึ่งปกติ, หนึ่งคอร์ด UV และหนึ่งสี/ความโปร่งใสหากต้องการสร้างรอยต่อ คุณควรสร้างคุณสมบัติใหม่และตั้งค่าไว้บนใบหน้าตัวอย่างเช่น โค้ดนี้จะสร้างลูกบาศก์ที่แหลมคม:

local AssetService = game:GetService("AssetService")

-- ให้ 4 ไอดีเหลี่ยม เพิ่มเหลี่ยมใหม่และ 2 สามเหลี่ยม ทำให้เหลี่ยมแหลมคม
local function addSharpQuad(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- สิ่งนี้สร้าง ID ปกติซึ่งคำนวณโดยอัตโนมัติ

	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 ด้าน
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)  -- ด้านหน้า
	addSharpQuad(eMesh, v1, v3, v4, v2)  -- กลับ
	addSharpQuad(eMesh, v1, v5, v7, v3)  -- ซ้าย
	addSharpQuad(eMesh, v2, v4, v8, v6)  -- ขวา
	addSharpQuad(eMesh, v1, v2, v6, v5)  -- ด้านล่าง
	addSharpQuad(eMesh, v3, v7, v8, v4)  -- ด้านบน

	eMesh:RemoveUnused()
	return eMesh
end

พัน

ใบหน้าเมชมีด้านหน้าและด้านหลังเมื่อวาดเมช จะวาดด้านหน้าของใบหน้าเท่านั้นโดยค่าเริ่มต้น แม้ว่าคุณจะสามารถเปลี่ยนได้โดยการตั้งค่าคุณสมบัติเมช DoubleSided เป็น true

ลําดับของจุดยอดรอบใบหน้าจะกำหนดว่าคุณกําลังมองที่ด้านหน้าหรือด้านหลังด้านหน้าของใบหน้าจะเห็นได้เมื่อเหลี่ยมมุมไปในทิศทางตรงกันข้ามรอบๆ มัน

ข้อจํากัด

EditableMesh ขณะนี้มีขีดจํากัดของ 60,000 เหลี่ยมและ 20,000 เหลี่ยม การพยายามเพิ่มเหลี่ยมหรือเหลี่ยมมากเกินไปจะทําให้เกิดข้อผิดพลาด