Rack/include/asset.hpp

#pragma once
#include <common.hpp>


namespace rack {


namespace plugin {
struct Plugin;
} // namespace plugin


namespace engine {
struct Module;
} // namespace engine


namespace asset {


void init();

/** Returns the path of a system asset. Should only read files from this location. */
std::string system(std::string filename = "");

/** Returns the path of a user asset. Can read and write files to this location. */
std::string user(std::string filename = "");

/** Returns the path of a asset in the plugin's folder.
Plugin assets should be read-only by plugins.
Examples:
	asset::plugin(pluginInstance, "samples/00.wav") // "/path/to/Rack/user/folder/plugins/MyPlugin/samples/00.wav"
*/
std::string plugin(plugin::Plugin* plugin, std::string filename = "");


// Set these before calling init() to override the default paths
extern std::string systemDir;
extern std::string userDir;
// Only defined on Mac
extern std::string bundlePath;


} // namespace asset
} // namespace rack