EditableMesh

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

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

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

สิทธิ์

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

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

ขีดจํากัดความทรงจํา

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

การสร้างและแสดง

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

local AssetService = game:GetService("AssetService")

-- สร้าง EditableMesh ว่างเปล่า
local editableMesh = AssetService:CreateEditableMesh()

-- สร้าง EditableMesh จาก ID สินทรัพย์
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- สร้าง EditableMesh จาก EditableMesh อื่น
local editableMeshFromAnother = nil
local success, errorMessage = pcall(function()
	editableMeshFromAnother = AssetService:CreateEditableMeshAsync(Content.fromObject(OTHER_EDITABLE_MESH))
end)

-- สร้าง EditableMesh จาก MeshPart
local editableMeshFromMeshPart = nil
local success, errorMessage = pcall(function()
	editableMeshFromMeshPart = AssetService:CreateEditableMeshAsync(MESH_PART.MeshContent)
end)

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

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

-- สร้าง EditableMesh จาก ID สินทรัพย์
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID))
end)

-- สร้าง MeshPart ใหม่ที่เชื่อมโยงกับ EditableMesh
local newMeshPart = nil
local success, errorMessage = pcall(function()
	newMeshPart = AssetService:CreateMeshPartAsync(Content.fromObject(editableMeshFromAsset))
end)

-- หรือเชื่อมโยง MeshPart ใหม่ที่สร้างขึ้นข้างต้นไปยัง MeshPart ที่มีอยู่
local existingMeshPart = Workspace:FindFirstChild("EXISTING_MESH_PART")
existingMeshPart:ApplyMesh(newMeshPart)

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

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

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

local AssetService = game:GetService("AssetService")

-- สร้าง EditableMesh โดยไม่มีขนาดคงที่เริ่มต้น
local editableMeshFromAsset = nil
local success, errorMessage = pcall(function()
	editableMeshFromAsset = AssetService:CreateEditableMeshAsync(Content.fromAssetId(ASSET_ID), {FixedSize = false})
end)

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

หลายวิธี 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(editableMesh, vid0, vid1, vid2, vid3)
	local nid = editableMesh:AddNormal()  -- สิ่งนี้สร้าง ID ปกติซึ่งคำนวณโดยอัตโนมัติ

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

	editableMesh:RemoveUnused()
	return editableMesh
end

พัน

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

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

ท่าทาง FACS

หัวที่เคลื่อนไหวได้ใช้ระบบการเขียนโค้ดการกระทําใบหน้า (FACS)ดูที่ ตัวอ้างอิงท่าทาง FACS สำหรับข้อมูลที่เป็นประโยชน์เมื่อใช้ GetFacsPoses() และวิธีการที่คล้ายกัน

แต่ละโพสต์ของ FACS จะระบุโดยค่า Enum.FacsActionUnit ค่าสำหรับท่าทาง FACS กระดูกเสมือนสามารถแต่ละมี CFrame ที่เปลี่ยนกระดูกเริ่มต้น CFrame ในท่าทางผูกของเมชให้เป็น CFrame สำหรับท่าทางของหน่วยการกระทำของ FACS นั้นกระดูกทั้งหมด CFrames อยู่ในพื้นที่ท้องถิ่นของเมช

ท่าทาง FACS เหล่านี้จะผสมผสานกันในระหว่างการแอนิเมชั่นบางครั้งการผสมผสานของท่าเบสจะให้ผลลัพธ์ที่ไม่ดีในกรณีเหล่านั้น คุณสามารถยกเลิกการผสมผสานของคอมโบที่เฉพาะเจาะจงของท่ายืนพื้นด้วยท่าแก้ไขที่เป็นที่น่าพอใจมากขึ้น ท่าแก้ไขท่าแก้ไขจะระบุโดย 2 หรือ 3 ค่า Enum.FacsActionUnit ค่าเช่นท่าทาง FACS ฐาน, สำหรับท่าทางแก้ไข, กระดูกเสมือนแต่ละอันสามารถมี CFrame ที่เปลี่ยนกระดูกเริ่มต้น CFrame ในท่าทางผูกของเมชให้เป็น CFrame สำหรับการแก้ไข FACS นั้น

ข้อจํากัด

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