Roblox UtilitiesDevlHub Roblox Documentation

Class

WrapDeformer

Inherits
BaseWrap › Instance › Object
Memory category
Instances

Allows for the real-time deformation of a MeshPart.

The WrapDeformer object provides a low-resolution cage mesh that pairs with a WrapTarget sibling to deform a parent MeshPart. The MeshPart geometry is deformed according to the displacement between pairs of WrapTarget cage mesh vertices and WrapDeformer cage mesh vertices. Cage mesh vertices are paired based on UV equivalence.

WrapDeformer may be used with avatars or on distinct MeshParts, as long as WrapTarget children are present for the parent MeshParts. WrapDeformer is similar to WrapLayer but doesn't require layered clothing and can directly deform MeshParts for publishing.

Methods 3#

CreateEditableMeshAsyncReturns an EditableMesh (currently unskinned) equivalent to the deformed parent mesh.Yields
GetDeformedCFrameAsyncReturns a CFrame deformed comparably to the MeshPart.Yields
SetCageMeshContentSets the cage mesh used to deform against a sibling WrapTarget cage mesh.

CreateEditableMeshAsync(): EditableMesh#

Yields

Constructs and returns an EditableMesh corresponding to the deformed parent mesh geometry. This method respects all updates made to the deformation inputs prior to the request. It also sets the returned result's FixedSize to true.

Returns

GetDeformedCFrameAsync(originalCFrame: CFrame): CFrame#

Yields

Returns a CFrame deformed by the same deformation field used for the geometry of the parent MeshPart. This method is useful for the placement of accessories.

The input and output CFrame are both in the space of the parent MeshPart; only position (not rotation) will be deformed. This method respects all updates made to the deformation inputs prior to the request.

NameTypeDefaultDescription
originalCFrameCFrameThe CFrame, expressed in the local space of the parent MeshPart, whose position is deformed.
Returns
  • CFrame — A CFrame in the parent MeshPart space with its position displaced by the same deformation field applied to the parent mesh; rotation is unchanged.

SetCageMeshContent(content: Content, cageOrigin: CFrame?): ()#

Sets the cage mesh used to deform the parent MeshPart in conjunction with a sibling WrapTarget cage mesh. The content parameter should represent a Roblox mesh asset ID or an EditableMesh reference in your DataModel.

NameTypeDefaultDescription
contentContentA Roblox mesh asset ID or an EditableMesh reference specifying the cage mesh to deform against the sibling WrapTarget.
cageOriginCFrame?An optional CFrame, in the parent MeshPart space, that sets the cage's CageOrigin. When omitted, the existing CageOrigin is left unchanged.
Returns
  • ()

Inherited members#

Inherited from BaseWrap 8
Inherited from Instance 58
Inherited from Object 6
Properties (2)

ClassName, className

Events (1)

Changed