EditableMesh

는 연결된 경우 시각적 메시를 변경하여 스튜디오와 경험 모두에서 메시를 쿼리하고 수정할 수 있도록 합니다.

An EditableMesh 는 기존의 Content 의 MeshPart 또는 메쉬 ID를 사용하여 AssetService:CreateEditableMeshAsync() 에서 생성될 수 있으며, 빈 EditableMesh 는 AssetService:CreateEditableMesh() 를 사용하여 생성될 수 있습니다.그런 다음 표시, 수정 및 충돌 모델이 업데이트될 수 있습니다.모든 단계가 필요한 것은 아닙니다; 예를 들어, 단순히 표시하지 않고 레이캐스트만 생성하려는 경우 EditableMesh를 만들 수 있습니다.

새로운 EditableMesh 에 연결되면 새로운 MeshPart 를 통해 AssetService:CreateMeshPartAsync() 가 표시됩니다.동일한 을 참조하거나 기존 을 연결하는 더 많은 인스턴스를 생성할 수 있습니다. 또는 을 통해 기존 에 링크할 수 있습니다.

편집 후 충돌 및 유체 기하를 다시 계산하려면 AssetService:CreateMeshPartAsync() 및 MeshPart:ApplyMesh() 를 다시 호출하여 기존 MeshPart를 업데이트할 수 있습니다.일반적으로 이 작업은 기하 메서드를 조작하는 개별 호출 후에 하는 것이 아니라 개념 편집의 끝에서 수행하는 것이 좋습니다.메시에 대한 시각적 변경 사항은 항상 즉시 엔진에 반영되며, AssetService:CreateMeshPartAsync() 호출할 필요가 없습니다.

게시된 경험에 편집 가능한 메쉬 활성화

보안 목적으로, 게시된 경험에서 EditableMesh를 사용하면 기본적으로 실패합니다.사용을 활성화하려면 EditableMesh , 13세 이상 나이가 확인되고 ID가 확인되어야 합니다.확인 후 Studio의 게임 설정을 열고 보안 을 선택하고 메쉬 및 이미지 API 허용 토글을 활성화합니다.토글을 활성화하기 전에 사용 조건을 검토하는 것을 잊지 마십시오.

권한

오용을 방지하기 위해 AssetService:CreateEditableMeshAsync() 는 메쉬 자산만 로드하고 편집할 수 있도록 허용합니다:

• 경험의 크리에이터가 소유하는 것(경험이 개인에게 소유된 경우).
• 그룹에 소유된 것(경험이 그룹에 소유된 경우).
• 로그인한 Studio 사용자가 소유하는 항목(장소 파일이 Roblox에 저장되거나 게시되지 않은 경우).

APIs는 위의 조건을 충족하지 않는 자산을 로드하기 위해 사용되면 오류를 발생시킵니다.

고정 크기 메쉬

기존 메쉬 자산(via AssetService:CreateEditableMeshAsync() )에서 EditableMesh 를 생성할 때, 결과 편집 가능한 메쉬는 기본적으로 고정 크기입니다.고정 크기의 메쉬는 메모리 측면에서 더 효율적이지만 버텍스, 얼굴 또는 특성 수를 변경할 수 없습니다.벡스 특성 및 위치의 값만 편집할 수 있습니다.

안정적인 벡스/얼굴 ID

많은 EditableMesh 메서드가 벡스 , 정상 , UV , 색상 및 얼굴 ID를 사용합니다.이들은 Luau에서 정수로 표시되지만 특별한 처리가 필요합니다.주요 차이점은 ID가 안정적이고 메시의 다른 부분이 변경되더라도 동일하게 유지된다는 것입니다.예를 들어, 가 5개의 변점을 가지고 있고 변점 을 제거하면 새로운 변점은 이 됩니다.

ID가 순서대로 있을 것이라고 보장되지 않으며 번호 매기기에 구멍이 있을 수 있으므로 벡터나 면을 반복할 때 GetVertices() 또는 GetFaces()에서 반환된 테이블을 반복해야 합니다.

분할 벡터 특성

A 벡스 는 얼굴의 모서리이며, 토폴로지적으로 얼굴을 연결합니다.버텍스에는 위치, 정상, 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

감기

메쉬 얼굴에는 앞면과 뒷면이 있습니다.메쉬를 그릴 때 기본적으로 얼굴의 앞면만 그려지지만, mesh' DoubleSided 속성을 true로 설정하여 이를 변경할 수 있습니다.

얼굴 주변의 베리스 순서는 앞이나 뒤로보고 있는지 여부를 결정합니다.각 변점이 반대 방향으로 이동할 때 얼굴의 앞면이 보입니다. The front of the face is visible when the vertices go counterclockwise around it.

제한

EditableMesh 현재 60,000개의 벡터와 20,000개의 삼각형의 제한이 있습니다. 너무 많은 벡터나 삼각형을 추가하려고 하면 오류가 발생합니다.