MDM_MeshFit

Namespace: MDPackage.Modifiers

Modify mesh vertices by surface height or fit mesh to any collider.
Great time saver for creating environmental decals!
Read more here (Online documentation slide)

Properties

// FitWholeMesh, FitSpecificVertices
public MeshFitterMode CurrentMeshFitterMode { get; }

public float MeshFitterOffset { get; set; }
public float MeshFitterSurfaceDetection { get; set; }
public bool MeshFitterContinuousEffect { get; set; }

public Transform[] GeneratedPoints { get; }
public GameObject[] SelectedPoints { get; }

Public Methods

// Show/ Hide renderers of the generated points (if exist)
public void MeshFit_ShowHidePoints(bool activation)
// Generate gameObject points on the mesh
public void MeshFit_GeneratePoints()
// Clear points on the mesh (if possible)
public void MeshFit_ClearPoints()
// Reset mesh matrix transform (set scale to 1 and keep the shape)
public void MeshFit_BakeMesh()
// Update current mesh state (if UpdateEveryFrame is disabled)
public void MeshFit_UpdateMeshState()
// Refresh currently selected points state. Once the selected points are assigned, this will separate selected and unselected points
public void MeshFit_RefreshSelectedPointsState()

Examples

The following paragraphs contain Mesh Fit modifier component used in a practical example - add and control Mesh Fit modifier on a specific gameObject.

using UnityEngine;
using MDPackage.Modifiers;

[RequireComponent(typeof(MeshFilter))]
public class SampleScript : MonoBehaviour
{
private MDM_MeshFit fit;

private void Start()
{
// Add/Create a Mesh Fit modifier to this object right after start
fit = MD_ModifierBase.CreateModifier<MDM_MeshFit>(gameObject, MD_ModifierBase.MeshReferenceType.CreateNewReference);
// Reset object's transform (keep the current scale and reset the matrix to 1)
fit.MeshFit_BakeMesh();
// Generate points on start and start moving with the object...
fit.MeshFit_GeneratePoints();
// Destroy any collider that this object may contain
if (TryGetComponent<Collider>(out Collider c))
Object.Destroy(c);
}
}

Mesh Fit with selected points - selected points are received from checking the lowest position among the generated points.

using System.Collections.Generic;
using UnityEngine;
using MDPackage.Modifiers;

[RequireComponent(typeof(MeshFilter))]
public class SampleScript : MonoBehaviour
{
private MDM_MeshFit fit;

private void Start()
{
// Add/Create a Mesh Fit modifier to this object right after start
fit = MD_ModifierBase.CreateModifier<MDM_MeshFit>(gameObject, MD_ModifierBase.MeshReferenceType.CreateNewReference);
// Reset object's transform (keep the current scale and reset the matrix to 1)
fit.MeshFit_BakeMesh();
// Generate points on start
fit.MeshFit_GeneratePoints();
// Destroy any collider that this object may contain
if (TryGetComponent<Collider>(out Collider c))
Object.Destroy(c);
// Set the fitter type
fit.CurrentMeshFitterMode = MDM_MeshFit.MeshFitterMode.FitSpecificVertices;
List<GameObject> selPoints = new List<GameObject>();
// Generate and assign specific points that will control specific mesh vertices
foreach (var p in fit.GeneratedPoints)
{
if (p.localPosition.y <= -0.35f) // Or any other type of condition... Works just fine with regular cube
selPoints.Add(p.gameObject);
}
// Assign the selected points
fit.MeshFit_SetSelectedPoints(selPoints.ToArray());
fit.MeshFit_RefreshSelectedPointsState();
}
}