Conversion to 'Animation from File'

robertojguerra · March 10, 2026, 8:16am

Finding clues in the souce code:

synfig-studio/ChangeLog.old

be55081b7


      
          * New converter: Animated File - allows to read waypoints from external files (only PGO files supported right now). Thanks to Ivan Mahonin.

github.com/synfig/synfig

synfig-core/src/synfig/valuenodes/valuenode_animatedfile.cpp

be55081b7


      
          		double value;
          		iss >> value;
          		return value;
          	}
          
          	/// Parse a Papagayo file
          	/// \param[in] s the Papagayo stream to be parsed
          	/// \param[out] value the map of time -> layer name
          	/// \param[out] fields the map of metafield -> value
          	/// \return true if successful. There is no guarantee about stream offset in case of failure
          	static bool parse_pgo(std::istream &s, std::map<Time, String> &values, std::map<String, String> &fields)
          	{
          		String word;
          		bool unexpected_end = false;
          
          		String id, version;
          		s >> id >> word >>  version;
          		if (id != "lipsync" || word != "version")
          			{ error("Wrong format of .pgo file"); return false; }
          		if (version != "1")
          			warning("Unknown version of .pgo file: '%s'", version.c_str());

From looking at that cpp file, it seems that a TSV (table separated value) is an alternative to animating something from a file… and I found this:

Then, digging more:

github.com/synfig/synfig

Add the ability to import layer values from a TSV file

opened 03:52AM - 09 Jul 21 UTC

closed 05:46AM - 26 Jul 21 UTC

ice0

Feature request

I recall somebody asking for "Animation File" converter to any parameter. https…://forums.synfig.org/t/conversion-to-animation-from-file/11364 The idea is not related to "Import" action, but for the already available converter that Import indirectly uses. User could write a TSV like: ``` 0.00 1.0 0.30 1.5 0.80 1.2 ``` Then he could convert the Radius parameter of a Circle layer, for example, to "Animation from File", and then referring to the above TSV file. Thus, the circle radius will be animated by the file contents. _Originally posted by @rodolforg in https://github.com/synfig/synfig/issues/2207#issuecomment-875261013_

It should be available in Synfig 1.5