Go to: Synopsis. Return value. Related. Flags. Python examples.
sysFile(
string
, [copy=string], [delete=boolean], [makeDir=boolean], [move=string], [removeEmptyDir=boolean], [rename=string])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
sysFile is undoable, NOT queryable, and NOT editable.
This command provides a system independent way to create a directory
or to rename or delete a file.
| boolean | True if successful, false otherwise. |
getFileList
copy, delete, makeDir, move, removeEmptyDir, rename
| Long name (short name) |
Argument types |
Properties |
delete(delete)
|
boolean
|
|
|
|
rename(ren)
|
string
|
|
|
Rename the file to the name given by the newFileName parameter.
|
|
move(mov)
|
string
|
|
|
Behaves identically to the -rename flag and remains for
compatibility with old scripts
|
|
copy(cp)
|
string
|
|
|
Copy the file to the name given by the newFileName paramter.
|
|
makeDir(md)
|
boolean
|
|
|
Create the directory path given in the parameter.
This will create the entire path if more than one
directory needs to be created.
|
|
removeEmptyDir(red)
|
boolean
|
|
|
Delete the directory path given in the parameter if
the directory is empty. The command will not delete a directory
which is not empty.
|
|
|
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.
|
import maya.cmds as cmds
# Create a new directory path
cmds.sysFile( 'C:/temp/mayaStuff', makeDir=True )# Windows
cmds.sysFile( '/tmp/mayaStuff', makeDir=True )# Unix
# Move a scene to the new directory (we can rename it at the same time).
cmds.sysFile( 'C:/maya/projects/default/scenes/myScene.mb', rename='C:/temp/mayaStuff/myScene.mb.trash' )# Windows
cmds.sysFile( '/maya/projects/default/scenes/myScene.mb', rename='/tmp/mayaStuff/myScene.mb.trash' )# Unix
# Rename the scene to "myScene.will.be.deleted"
cmds.sysFile( 'C:/temp/mayaStuff/myScene.mb.trash', rename='C:/temp/mayaStuff/myScene.will.be.deleted' )# Windows
cmds.sysFile( '/tmp/mayaStuff/myScene.mb.trash', rename='/tmp/mayaStuff/myScene.will.be.deleted' )# Unix
# Copy a scene to the new directory
destWindows = "C:/temp/mayaStuff/myScene.mb.trash"
srcWindows = "C:/maya/projects/default/scenes/myScene.mb"
cmds.sysFile( srcWindows, copy=destWindows )# Windows
destUnix = "/tmp/mayaStuff/myScene.mb.trash"
srcUnix = "maya/projects/default/scenes/myScene.mb"
cmds.sysFile( srcUnix, copy=destUnix )# Unix
# Delete the scene
cmds.sysFile( 'C:/temp/mayaStuff/myScene.will.be.deleted', delete=True )# Windows
cmds.sysFile( '/tmp/mayaStuff/myScene.will.be.deleted', delete=True )# Unix