EditableMesh

EditableMesh thay đổi lưới hình ảnh được áp dụng khi kết nối với một MeshPart , cho phép truy vấn và chỉnh sửa lưới cả trong Studio và trong trải nghiệm.

Một EditableMesh có thể được tạo từ một Content hiện có của một MeshPart hoặc một ID lưới bằng AssetService:CreateEditableMeshAsync() , hoặc một ID trống EditableMesh có thể được tạo với AssetService:CreateEditableMesh() .Sau đó, nó có thể được hiển thị, chỉnh sửa và mô hình va chạm của nó được cập nhật.Không phải tất cả các bước đều cần thiết; ví dụ, bạn có thể muốn tạo một EditableMesh chỉ để phát sóng mà không bao giờ hiển thị nó.

Một EditableMesh được hiển thị khi nó được liên kết với một MeshPart mới, thông qua AssetService:CreateMeshPartAsync() .Bạn có thể tạo thêm MeshPart các ví dụ tham chiếu cùng Class.EditableMesh``Datatype.Content , hoặc liên kết đến một đối tượng hiện có MeshPart thông qua MeshPart:ApplyMesh() .

Để tính toán lại va chạm và hình học chất lỏng sau khi chỉnh sửa, bạn có thể lại gọi AssetService:CreateMeshPartAsync() và MeshPart:ApplyMesh() để cập nhật một MeshPart hiện có.Nói chung, được khuyến khích làm điều này ở cuối một lần chỉnh sửa khái niệm, không phải sau các cuộc gọi riêng lẻ đến các phương pháp thao tác địa hình.Các thay đổi hình ảnh đến lưới sẽ luôn được phản ánh ngay lập tức bởi động cơ, mà không cần phải gọi AssetService:CreateMeshPartAsync() .

Bật EditableMesh cho các trải nghiệm đã xuất bản

Vì mục đích bảo mật, sử dụng EditableMesh không thành công mặc định đối với các trải nghiệm đã xuất bản.Để bật sử dụng, EditableMesh , bạn phải là 13+ tuổi được xác minh và ID được xác minh.Sau khi được xác minh, mở Cài đặt trò chơi của Studio, chọn Bảo mật , và bật chuyển công tắc Cho phép API khối và hình ảnh .Hãy nhớ xem xét các điều khoản sử dụng trước khi bật công tắc.

Quyền

Để ngăn chặn lạm dụng, AssetService:CreateEditableMeshAsync() chỉ cho phép bạn tải và chỉnh sửa tài nguyên khối lượng:

• Đó là sở hữu của người tạo ra trải nghiệm (nếu trải nghiệm được sở hữu bởi một cá nhân).
• Thuộc sở hữu của một nhóm (nếu trải nghiệm thuộc sở hữu của nhóm).
• Những người sở hữu bởi người dùng Studio đã đăng nhập (nếu tập tin chỗ chưa được lưu hoặc xuất bản vào Roblox).

Các API sẽ ném lỗi nếu chúng được sử dụng để tải một tài sản không đáp ứng các tiêu chí trên.

Khối lượng cố định Meshes

Khi tạo một EditableMesh từ một tài nguyên lưới hiện có (thông qua AssetService:CreateEditableMeshAsync() ), kết quả là lưới có kích thước cố định mặc định.Khối lượng cố định có hiệu quả hơn về bộ nhớ nhưng bạn không thể thay đổi số lượng cạnh, mặt hoặc thuộc tính.Chỉ các giá trị của điểm đỉnh và vị trí có thể được chỉnh sửa.

ID khối/mặt ổn định

Nhiều phương pháp EditableMesh nhận vertex , bình thường , UV , màu và khuôn mặt ID.Chúng được biểu diễn như số nguyên trong Luau nhưng chúng cần một số xử lý đặc biệt.Sự khác biệt chính là các ID ổn định và chúng vẫn giống nhau ngay cả khi các phần khác của lưới thay đổi.Ví dụ, nếu một EditableMesh có năm cạnh {1, 2, 3, 4, 5} và bạn xóa cạnh 4 , các cạnh mới sẽ là {1, 2, 3, 5} .

Lưu ý rằng các ID không được đảm bảo sẽ ở trong trật tự và có thể có các lỗ trong số đếm, vì vậy khi lặp qua các đỉnh hoặc mặt, bạn nên lặp qua bảng được trả về bởi GetVertices() hoặc GetFaces() .

Phân tách các thuộc tính Vertex

Một vertex là góc của một khuôn mặt, và kết nối topologically các khuôn mặt với nhau.Các đỉnh có thể có một số thuộc tính: vị trí, bình thường, phối hợp UV, màu sắc và độ trong suốt.

Đôi khi nó hữu ích cho tất cả các khuôn mặt tiếp xúc với một vértice để sử dụng cùng giá trị thuộc tính, nhưng đôi khi bạn sẽ muốn các khuôn mặt khác sử dụng các giá trị thuộc tính khác trên cùng một vértice.Ví dụ, trên một cạnh tròn mịn, mỗi cạnh chỉ có một bình thường.Ngược lại, ở góc của một khối, đỉnh sẽ có 3 độ bình thường khác nhau (một cho mỗi khuôn mặt liền kề).Bạn cũng có thể có các đường chỉnh sửa trong phối hợp UV hoặc những thay đổi sắc nét trong màu đỉnh.

Khi tạo khuôn mặt, mỗi đỉnh sẽ mặc định có một trong mỗi thuộc tính: một thường, một phối hướng UV và một màu/độ trong suốt.Nếu bạn muốn tạo một ranh giới, bạn nên tạo các thuộc tính mới và đặt chúng trên khuôn mặt.Ví dụ, mã này sẽ tạo một khối cạnh tròn:

local AssetService = game:GetService("AssetService")

-- Khi được cung cấp 4 ID đỉnh, thêm một đỉnh mới và 2 tam giác, tạo một cạnh bén
local function addSharpQuad(eMesh, vid0, vid1, vid2, vid3)
	local nid = eMesh:AddNormal()  -- Điều này tạo ra một ID bình thường được tính toán tự động

	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

-- Tạo một khối với các cạnh bị méo giữa 6 bên
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)  -- Phía trước
	addSharpQuad(eMesh, v1, v3, v4, v2)  -- Quay lại
	addSharpQuad(eMesh, v1, v5, v7, v3)  -- Bên trái
	addSharpQuad(eMesh, v2, v4, v8, v6)  -- Phải
	addSharpQuad(eMesh, v1, v2, v6, v5)  -- Ở đáy
	addSharpQuad(eMesh, v3, v7, v8, v4)  -- Trên cùng

	eMesh:RemoveUnused()
	return eMesh
end

Lượt vòng

Các khuôn mặt lưới có một mặt trước và một mặt sau.Khi vẽ khối, chỉ phần trước của khuôn mặt được vẽ mặc định, mặc dù bạn có thể thay đổi điều này bằng cách đặt tính chất khối DoubleSided của khối thành true .

Thứ tự của các đỉnh xung quanh khuôn mặt quyết định xem bạn đang nhìn vào phía trước hay phía quay lại.Phía trước của khuôn mặt có thể nhìn thấy khi các đỉnh đi ngược chiều xung quanh nó.

Hạn chế

EditableMesh hiện đang có giới hạn 60,000 vertex và 20,000 tam giác. Cố gắng thêm quá nhiều vertex hoặc tam giác sẽ gây ra lỗi.