diff --git a/include/frei0r.h b/include/frei0r.h index f6b81d2..2ae58b3 100644 --- a/include/frei0r.h +++ b/include/frei0r.h @@ -40,6 +40,11 @@ * * @section sec_changes Changes * + * @subsection sec_changes_1_1_1_2 From frei0r 1.1 to frei0r 1.2 + * - make in plugin path optional + * - added section on FREI0R_PATH environment variable + * - added requirement to initialize all parameters in f0r_construct() + * * @subsection sec_changes_1_0_1_1 From frei0r 1.0 to frei0r 1.1 * * - added specifications for plugin locations @@ -79,7 +84,7 @@ * - /home/martin/.frei0r-1/lib/martin/test.so * * Like in these examples plugins should be placed in "vendor" subdirs - * to reduce name clashes. + * to reduce name clashes. However, is optional and may be left blank. * * @subsection sec_order Plugin Loading Order * @@ -95,6 +100,16 @@ * * The order of loading plugins inside each of the directories * 1, 2, and 3 is not defined. + * + * @subsection sec_path FREI0R_PATH Environment Variable + * + * If the environment variable FREI0R_PATH is defined, then it shall be + * considered a colon separated list of directories which replaces the + * default list. + * + * For example: + * + * FREI0R_PATH=/home/foo/frei0r-plugins:/usr/lib/frei0r-1:/etc/frei0r */ /** @@ -173,7 +188,7 @@ /** \file - * \brief This file defines the frei0r api, version 1.1. + * \brief This file defines the frei0r api, version 1.2. * * A conforming plugin must implement and export all functions declared in * this header. @@ -195,7 +210,7 @@ /** * The frei0r API minor version */ -#define FREI0R_MINOR_VERSION 1 +#define FREI0R_MINOR_VERSION 2 //--------------------------------------------------------------------------- @@ -240,7 +255,7 @@ void f0r_deinit(); * by their significance in an uint32_t value. * * For effects that work on the color components, - * RGBA8888 is the recommended color model for frei0r-1.1 effects. + * RGBA8888 is the recommended color model for frei0r-1.2 effects. * For effects that only work on pixels, PACKED32 is the recommended * color model since it helps the application to avoid unnecessary * color conversions. @@ -449,8 +464,9 @@ typedef void* f0r_instance_t; * Constructor for effect instances. The plugin returns a pointer to * its internal instance structure. * - * The resolution has to be an integer multiple of 8, + * The resolution must be an integer multiple of 8, * must be greater than 0 and be at most 2048 in both dimensions. + * The plugin must set default values for all parameters in this function. * * \param width The x-resolution of the processed video frames * \param height The y-resolution of the processed video frames diff --git a/msvc/frei0r_1_2.def b/msvc/frei0r_1_2.def new file mode 100644 index 0000000..4c3fa4d --- /dev/null +++ b/msvc/frei0r_1_2.def @@ -0,0 +1,10 @@ +EXPORTS + f0r_init + f0r_deinit + f0r_get_plugin_info + f0r_get_param_info + f0r_construct + f0r_destruct + f0r_set_param_value + f0r_get_param_value + f0r_update2