From K-3D

Jump to: navigation, search


Load a papagayo lipsync (.dat) file and output its values given a time source
Plugin Status:Experimental
Categories:All Plugins, Experimental Plugins, Animation Plugins


Name Value


Label Description Type Script Name
Papagayo File Papagayo Lipsync File to Load k3d::filesystem::path papagayo_file
Frame Rate Frame rate of the papagayo lipsync file. Frames are converted to time units according to this value. k3d::double_t frame_rate
Time Time for the current mouths' values(should be connected to a time source) k3d::double_t time
Interpolate Enables linear interpolation between mouths values. k3d::bool_t interpolate
Interpolation Time Time for the transition from mouth to mouth k3d::double_t interpolation_time
AI AI mouth value. k3d::double_t AI
E E mouth value. k3d::double_t E
etc etc mouth value. k3d::double_t etc
FV FV mouth value. k3d::double_t FV
L L mouth value. k3d::double_t L
MBP MBP mouth value. k3d::double_t MBP
O O mouth value. k3d::double_t O
rest rest mouth value. k3d::double_t rest
U U mouth value. k3d::double_t U
WQ WQ mouth value. k3d::double_t WQ


This plugins was designed to be used together with the open source software Papagayo.


  1. Once you have your character mouth or face you should create a new instance for the following sounds:
    1. AI, E, etc, FV, L, MBP, O, rest, U and WQ
  2. Then go to the papagayo software and select your mouth according to your sound file.
  3. Once you finished the lip synchronization you can save the .dat file.
  4. Load the .dat file on PapagayoLipsyncReader
  5. Adjust the frame rate to the one you used in Papagayo (not necessarily must be the same in K-3D's time source, generally it will be lower). The time will be converted according to this value to match K-3D's time.
  6. Add a MorphPoints modifier to you face/mouth and add all the face/mouth targets. (I suggest using the same sounds name as in the PapagayoLipsyncReader plugin)
  7. Connect the MorphPoints morph value to its corresponding value on the PapagayoLipsyncReader
  8. Connect PapagayoLipsyncReader's time property to the TimeSource's time property
  9. Push play!