LV2
1.0.13
|
Feature data for state:mapPath (LV2_STATE__mapPath). More...
Data Fields | |
LV2_State_Map_Path_Handle | handle |
Opaque host data. | |
char *(* | abstract_path )(LV2_State_Map_Path_Handle handle, const char *absolute_path) |
Map an absolute path to an abstract path for use in plugin state. | |
char *(* | absolute_path )(LV2_State_Map_Path_Handle handle, const char *abstract_path) |
Map an abstract path from plugin state to an absolute path. |
Feature data for state:mapPath (LV2_STATE__mapPath).
LV2_State_Map_Path_Handle LV2_State_Map_Path::handle |
Opaque host data.
char*(* LV2_State_Map_Path::abstract_path)(LV2_State_Map_Path_Handle handle, const char *absolute_path) |
Map an absolute path to an abstract path for use in plugin state.
handle | MUST be the handle member of this struct. |
absolute_path | The absolute path of a file. |
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().
char*(* LV2_State_Map_Path::absolute_path)(LV2_State_Map_Path_Handle handle, const char *abstract_path) |
Map an abstract path from plugin state to an absolute path.
handle | MUST be the handle member of this struct. |
abstract_path | An abstract path (e.g. a path from plugin state). |
The plugin MUST use this function in order to actually open or otherwise use any paths loaded from plugin state.
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().