This statement is intended primarily to ease the distribution of tracks within which you want to embed binary data.
The statement is only executed once regardless of the execution mode, stepwise or grouped. The statement will only process tracks which are ID3 based (mp3, aiff, dff, dsf and wav) or MPEG-4 based (m4v, mp4, etc.). ie. the statement will not process flac, ogg, opus or wv files.
You must specify the description and import file path fields.
If the explicit mime type option is checked, you can optionally specify a mime type. When not checked, the mime type will be calculated from the import file's path at runtime.
If the explicit filename option is checked, you can optionally specify a filename. When not checked, the filename will be extracted from the import file's path at runtime.
The specified file will be read and will become the content portion of the created General Encapsulated Object. Any pre-existing item with the same name will be removed.
All text fields may contain any of the escape sequences described in Escape Sequences.
The action test state will be set to false if the description field is empty, the import file path is invalid, the file cannot be read or if there are no appropriate audio files to process. Otherwise the test state will be set to true.
Typically General Encapsulated Objects are only available in ID3 based file formats. Yate additionally uses it for MPEG-4 files to store Reverse DNS atoms which do not have a mean of com.apple.iTunes or those which cannot be displayed as UTF8. This ensures there will be no loss of data for custom binary data produced by various audio applications.
With MPEG-4 files the filename field is ignored. The mime type field is used to contain the reverse dns name. If the specified mime type field is com.apple.iTunes any pre-existing UDTIs of the same name will be removed.
If the object content can be read as UTF8 and the mime type is com.apple.iTunes, the created item will appear as a UDTI (not a GEOB), after saving and reloading the file. This is because the determination and assignment of a tag as a GEOB is performed when reading a file.
If you want to specify a reverse dns name of com.apple.iTunes, you can select it from the mime type field's menu disclosure button.