1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
|
<!-- Copyright 2010-2022 David Robillard <d@drobilla.net> -->
<!-- SPDX-License-Identifier: ISC -->
LV2
===
LV2 is a plugin standard for audio systems. It defines an extensible C API for
plugins, and a format for self-contained "bundle" directories that contain
plugins, metadata, and other resources. See <http://lv2plug.in/> for more
information.
This package contains specifications (C headers and Turtle data files),
documentation generation tools, tests, and example plugins.
Installation
------------
See the [installation instructions](INSTALL.md) for details on how to
configure, build, and install LV2 with meson.
By default, on UNIX-like systems, everything is installed within the `prefix`,
and LV2 bundles are installed in the "lv2" subdirectory of the `libdir`. On
other systems, bundles are installed by default to the standard location for
plugins on the system. The bundle installation directory can be overridden
with the `lv2dir` option.
The [specification bundles](lv2) are run-time dependencies of LV2 applications.
Programs expect their data to be available somewhere in `LV2_PATH`. See
<http://lv2plug.in/pages/filesystem-hierarchy-standard.html> for details on the
standard installation paths.
Headers
-------
The `lv2/` include namespace is reserved for this LV2 distribution.
Other projects may extend LV2, but must place their headers elsewhere.
Headers are installed to `includedir` with paths like:
#include "lv2/urid/urid.h"
For backwards compatibility, if the `old_headers` option is set, then headers
are also installed to the older URI-based paths:
#include "lv2/lv2plug.in/ns/ext/urid/urid.h"
Projects still using this style are encourated to migrate to the shorter style
above.
|