✨🎯 𝘿𝙖𝙮17 -100-𝘿𝙖𝙮𝙨 𝘾𝙤𝙙𝙚 𝘾𝙝𝙖𝙡𝙡𝙚𝙣𝙜𝙚 🚀🎨

import maya.cmds as mc

import maya.OpenMaya as om

def alignToSurface(target_surface):

"""

Aligns selected objects to the target surface's normals.

:param target_surface: <str> The name of the target surface.

"""

if not mc.objExists(target_surface):

mc.warning("Target surface '{}' does not exist.".format(target_surface))

return

selected_objects = mc.ls(selection=True, transforms=True)

if not selected_objects:

mc.warning("No objects selected for alignment.")

return

# Get the DAG path of the target surface

selection_list = om.MSelectionList()

selection_list.add(target_surface)

dag_path = om.MDagPath()

selection_list.getDagPath(0, dag_path)

fn_mesh = om.MFnMesh(dag_path)

for obj in selected_objects:

# Get the object's position

position = mc.xform(obj, query=True, translation=True, worldSpace=True)

point = om.MPoint(position[0], position[1], position[2])

# Find the closest point on the mesh

closest_point = om.MPoint()

normal = om.MVector()

fn_mesh.getClosestPointAndNormal(point, closest_point, normal, om.MSpace.kWorld)

# Move object to the closest point

mc.xform(obj, translation=(closest_point.x, closest_point.y, closest_point.z), worldSpace=True)

# Align object's up vector to the normal

print("Aligned '{}' to '{}'.".format(obj, target_surface))

# Usage example:

# Select the objects to align, then run:

# alignToSurface('targetSurfaceName')

# Test function is provided to test main function alignToSurface with vertex manipulation using clusters

def test_alignToSurface_with_clusters():

# Create target surface

target_surface = mc.polyPlane(name='targetSurfaceName', width=10, height=10, subdivisionsX=10, subdivisionsY=10)[0]

# Set target surface's attributes if needed (e.g., position, orientation)

mc.xform(target_surface, translation=(0, 0, 0), worldSpace=True)

# Create objects to align

obj1 = mc.polySphere(name='object1')[0]

obj2 = mc.polyCube(name='object2')[0]

# Set original objects' positions above the target surface

mc.xform(obj1, translation=(2, 5, 2), worldSpace=True)

mc.xform(obj2, translation=(-2, 10, -2), worldSpace=True)

# Parent original objects to a group

group = mc.group(obj1, obj2, name='originalGroup')

# Select objects to align

mc.select(obj1, obj2)

# Run the alignToSurface function

alignToSurface('targetSurfaceName')

# Define a helper function for approximate comparison

def is_close(vec1, vec2, tol=0.01):

return all(abs(a - b) < tol for a, b in zip(vec1, vec2))

# Check if objects are aligned to the surface

obj1_translate = mc.xform(obj1, query=True, translation=True, worldSpace=True)

obj2_translate = mc.xform(obj2, query=True, translation=True, worldSpace=True)

assert is_close(obj1_translate, [2, 0, 2]), "Translation of object1_replaced does not match the target surface."

assert is_close(obj2_translate, [-2, 0, -2]), "Translation of object2_replaced does not match the target surface."

# Check rotations are aligned to the surface normals (assuming initial normals are (0, 1, 0))

obj1_rotate = mc.xform(obj1, query=True, rotation=True, worldSpace=True)

obj2_rotate = mc.xform(obj2, query=True, rotation=True, worldSpace=True)

expected_rotation = [0, 0, 0] # Since normals are (0,1,0), up vector aligns with Y-axis

assert is_close(obj1_rotate, expected_rotation), "Rotation of object1_replaced does not match the expected alignment."

assert is_close(obj2_rotate, expected_rotation), "Rotation of object2_replaced does not match the expected alignment."

# Check scale remains unchanged if align_scale=False

obj1_scale = mc.xform(obj1, query=True, scale=True, relative=True)

obj2_scale = mc.xform(obj2, query=True, scale=True, relative=True)

assert obj1_scale == [1, 1, 1], "Scale of object1_replaced was incorrectly modified."

assert obj2_scale == [1, 1, 1], "Scale of object2_replaced was incorrectly modified."

# Check parenting remains unchanged

new_obj1_parent = mc.listRelatives(obj1, parent=True)

new_obj2_parent = mc.listRelatives(obj2, parent=True)

assert new_obj1_parent == ['originalGroup'], "object1_replaced is not parented correctly."

assert new_obj2_parent == ['originalGroup'], "object2_replaced is not parented correctly."

# **Additional Test: Move vertices using clusters and verify alignment**

# Create clusters

cluster1 = mc.cluster("{}.vtx[0:24]".format(target_surface))[1] # Bottom-left quadrant

cluster2 = mc.cluster("{}.vtx[25:49]".format(target_surface))[1] # Bottom-right quadrant

cluster3 = mc.cluster("{}.vtx[50:74]".format(target_surface))[1] # Top-left quadrant

cluster4 = mc.cluster("{}.vtx[75:99]".format(target_surface))[1] # Top-right quadrant

# Move clusters upwards to deform the surface

mc.xform(cluster1, translation=(0, 2, 0), worldSpace=True)

mc.xform(cluster2, translation=(0, 2, 0), worldSpace=True)

mc.xform(cluster3, translation=(0, 2, 0), worldSpace=True)

mc.xform(cluster4, translation=(0, 2, 0), worldSpace=True)

# Re-run alignToSurface after surface deformation

alignToSurface('targetSurfaceName')

# Verify that objects are still aligned to the new surface normals

obj1_translate_updated = mc.xform(obj1, query=True, translation=True, worldSpace=True)

obj2_translate_updated = mc.xform(obj2, query=True, translation=True, worldSpace=True)

# Since the surface is deformed upwards, Y should still be 0 (aligned to surface)

assert is_close(obj1_translate_updated, [2, 0, 2]), "Translation of object1_replaced did not update correctly after surface deformation."

assert is_close(obj2_translate_updated, [-2, 0, -2]), "Translation of object2_replaced did not update correctly after surface deformation."

# Optionally, verify rotations based on new normals

# This requires recalculating expected rotations, which can be complex depending on deformation

mc.select(obj1, obj2, r=1)

alignToSurface('targetSurfaceName')

print("All tests for alignToSurface with clusters passed successfully.")

test_alignToSurface_with_clusters()

[Today’s Challenge is to take this simple code to next level.. I am sharing images of these advanced codes...]