Eyeon:Script/Reference/Applications/Fusion/Classes/Object/GetData
From VFXPedia
Contents |
Object : GetData
Arguments
value = GetData(name)
- name (required, string)
This is the name of the attribute to fetch. As of 5.1, this name can be in "table.subtable" format, to allow persistent data to be stored within subtables.
Returns
- value
This is the value that has been fetched from the object's persistent data. It can be of almost any type.
Remarks
Persistent data is a very useful way to store names, dates, filenames, notes, flags, or anything else, in such a way that they are permanently associated with this instance of the object, and are stored along with the object using SetData(), and can be retrieved at any time with GetData().
The method of storage varies by object: SetData() called on the Fusion app itself will save its data in the Fusion.prefs file, and will be available whenever that copy of Fusion is running. Calling SetData() on any object associated with a Composition will cause the data to be saved in the .comp file, or in any settings files that may be saved directly from that object. Some ephemeral objects that are not associated with any composition and are not otherwise saved in any way, may not have their data permanently stored at all, and the data will only persist as long as the object itself does.
Requirements
- eyeonScript 5.0
- Fusion 5.0
Examples
author = tool:GetData("Modified.Author") dt = tool:GetData("Modified.Date") print("Last modified by "..author.." on "..dt)
Tips for GetData (edit)
EyeonTips:Script/Reference/Applications/Fusion/Classes/Object/GetData