Map an absolute path to an abstract path for use in plugin state.
@param handle MUST be the handle member of this struct.
@param absolute_path The absolute path of a file.
@return An abstract path suitable for use in plugin state.
The plugin MUST use this function to map any paths that will be stored
in plugin state. The returned value is an abstract path which MAY not
be an actual file system path; absolute_path() MUST be used to map
it to an actual path in order to use the file.
Plugins MUST NOT make any assumptions about abstract paths except that
they can be mapped back to the absolute path of the "same" file (though
not necessarily the same original path) using absolute_path().
This function may only be called within the context of
LV2_State_Interface methods. The caller is responsible for freeing the
returned value with free().
Map an absolute path to an abstract path for use in plugin state. @param handle MUST be the handle member of this struct. @param absolute_path The absolute path of a file. @return An abstract path suitable for use in plugin state.
The plugin MUST use this function to map any paths that will be stored in plugin state. The returned value is an abstract path which MAY not be an actual file system path; absolute_path() MUST be used to map it to an actual path in order to use the file.
Plugins MUST NOT make any assumptions about abstract paths except that they can be mapped back to the absolute path of the "same" file (though not necessarily the same original path) using absolute_path().
This function may only be called within the context of LV2_State_Interface methods. The caller is responsible for freeing the returned value with free().