Go to: Synopsis. Return value. Keywords. Related. Flags. Python examples.


polyHole([assignHole=boolean], [createHistory=boolean])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

polyHole is undoable, queryable, and editable.

Command to set and clear holes on given faces.

Return value

booleanSuccess or Failure.

In query mode, return type is based on queried flag.


poly, hole, smooth, subdiv




assignHole, createHistory
Long name (short name) Argument types Properties
createHistory(ch) boolean createqueryedit
For objects that have no construction history, this flag can be used to force the creation of construction history for hole. By default, history is not created if the object has no history. Regardless of this flag, history is always created if the object already has history.
assignHole(ah) boolean createqueryedit
Assign the selected faces to be hole or unassign the hole faces to be non-hole. By default, the command will assign faces to be hole.

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# To toggle hole on/off on the selected faces
cmds.polyHole( )