Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

memory [-asFloat] [-freeMemory] [-gigaByte] [-heapMemory] [-kiloByte] [-megaByte] [-pageFaults] [-pageReclaims] [-physicalMemory] [-summary] [-swapFree] [-swapLogical] [-swapMax] [-swapPhysical] [-swapVirtual] [-swaps]

memory is undoable, NOT queryable, and NOT editable.

Used to query essential statistics on memory availability and usage.

By default memory sizes are returned in bytes. Since Maya's command engine only supports 32-bit signed integers, any returned value which cannot fit into 31 bits will be truncated to 2,147,483,647 and a warning message displayed. To avoid having memory sizes truncated use one of the memory size flags to return the value in larger units (e.g. megabytes) or use the asFloat flag to return the value as a float.

Return value

None

Flags

asFloat, freeMemory, gigaByte, heapMemory, kiloByte, megaByte, pageFaults, pageReclaims, physicalMemory, summary, swapFree, swapLogical, swapMax, swapPhysical, swapVirtual, swaps
Long name (short name) Argument types Properties
-kiloByte(-kb) create
Return memory sizes in kilobytes (1024 bytes)
-megaByte(-mb) create
Return memory sizes in megabytes (1024*1024 bytes)
-gigaByte(-gb) create
Return memory sizes in gigabytes (1024*1024*1024 bytes)
-asFloat(-af) create
Causes numeric values to be returned as floats rather than ints. This can be useful if you wish to retain some of the significant digits lost when using the unit size flags.
-heapMemory(-he) create
Returns size of memory heap
-freeMemory(-fr) create
Returns size of free memory
-physicalMemory(-phy) create
Returns size of physical memory
-pageFaults(-pf) create
Returns number of page faults
-pageReclaims(-pr) create
Returns number of page reclaims
-summary(-sum) create
Returns a summary of memory usage. The size flags are ignored and all memory sizes are given in megabytes.
-swaps(-sw) create
Returns number of swaps
-swapFree(-swf) create
Returns size of free swap
-swapMax(-swm) create
Returns maximum swap size
-swapVirtual(-swv) create
Returns size of virtual swap
-swapPhysical(-swp) create
Returns size of physical swap
-swapLogical(-swl) create
Returns size of logical swap
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 be used more than once in a command.

MEL examples

memory -freeMemory;
// Result: 548388864 //

memory -freeMemory -megaByte;
// Result: 522 //

memory -freeMemory -megaByte -asFloat;
// Result: 521.683594 //