pymel.core.animation.movIn

movIn(*args, **kwargs)

Imports a .mov file into animation curves connected to the listed attributes. The attribute must be writable, since an animation curve will be created and connected to the attribute. If an animation curve already is connected to the attribute, the imported data is pasted onto that curve. The starting time used for the .mov file importation is the current time when the command is executed. Valid attribute types are numeric attributes; time attributes; linear attributes; angular attributes; compound attributes made of the types listed previously; and multi attributes composed of the types listed previously. If an unsuppoted attribute type is requested, the command will fail and no data will be imported. It is important that your user units are set to the same units used in the .mov file, otherwise linear and angular values will be incorrect. To export a .mov file, use the movOut command.

Flags:

Long name (short name)		Argument Types	Properties
file (f)		unicode
	The name of the .mov file. If no extension is used, a .mov will be added.
startTime (st)		time
	The default start time for importing the .mov file is the current time. The startTime option sets the starting time for the .mov data in the current time unit.Flag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.

Derived from mel command maya.cmds.movIn

Example:

import pymel.core as pm

pm.sphere( n='sph' )
# Result: [nt.Transform(u'sph'), nt.MakeNurbSphere(u'makeNurbSphere1')] #

#    Start importing the data at time 45;
#
pm.currentTime( 45 )
# Result: 45.0 #

#    Read in rotation, translation, and scale information from the
#    test.mov file into the sphere. The order of data in the test.mov
#    file must be: rx, ry, rz, tx, ty, tz.
#
pm.movIn( 'sph.r', 'sph.t', f='sphereMotion.mov' )

#    An equivalent way of importing data into the sphere.
#
pm.movIn( 'sph.rx', 'sph.ry', 'sph.rz', 'sph.tx', 'sph.ty', 'sph.tz', f='sphereMotion.mov' )