It is sometimes handy to have EDL assets not as a copy, but as a reference that is automatically updated into your project. Suppose you have several short videos that at the end have the same credits which include the current year such as 2019. But now it is 2020 and all of the videos would have to be individually updated with the new date. By including a Referenced File as the EDL file type when you create each of the videos, you can just change the one credits xml file and the next time you load one of the videos and render it, it will now automatically have the updated information.
The purpose of this feature is to be able to rework a smaller section of a global master project at any time, which can be done by an "assistant" (i.e. external software like GIMP or Inkscape, ...) and then this work is automatically reflected in the global master project. It is for advanced usage only.
Up until the addition of this feature, CINELERRA-GG has always used copies and no direct reference in order to ensure original data is never compromised (No Destructive editing). In the usual case, subprojects as xmls are copied into a master project where subprojects had been inserted, so that if you change something in a subproject or delete a subproject, it would have no affect on the master project. But now with File by Reference, any project that uses a referenced file will automatically include any changes made to the referenced file when loaded. At the same time, if you use the EDL file NOT as a referenced file in a project since it is then just a copy, it will not be updated. Because of this difference, the user needs to be very aware of what using this feature could do.
Use with extreme caution. However, there are several built-in safety features and a warning that should never be turned off even though it gives you the option to do so. These include:
Here is a step by step example of how you can use File by Reference:
The CINELERRA-GG Community, 2021