From 425c881b86435d756f09f82dd5c3ba48fe64cf66 Mon Sep 17 00:00:00 2001 From: Richard Date: Wed, 3 Mar 2021 01:00:03 +0000 Subject: initial --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..34abd9d --- /dev/null +++ b/README.md @@ -0,0 +1,30 @@ +## Introduction +csound-nstrexists provides a simple way to check whether an instrument number exists in the orchestra, at i-rate or k-rate. An example csd is provided in the examples/ directory demonstrating i and k-rate operation. +This depends on changes in commit cca2bd90bffc5c36499c74734e37ec256dc60924 on 2019-09-12 so it will not work with builds older than that. +The opcode has only been tested on Linux as of writing. + + +## Requirements + - Csound development libraries + - Cmake + + +## Building +Create a build directory at the top of the source tree, execute *cmake ..*, *make* and optionally *make install* as root. If the latter is not used/possible then the resulting libnstrexists module can be used with the *--opcode-lib* flag in Csound. eg: + + cd csound-nstrexists + mkdir build && cd build + cmake .. + make && sudo make install + + +## Opcode overview +### nstrexists +*iexists nstrexists instrnum* +*kexists nstrexists knstrnum* + +Check if an instrument exists given the instrument number. + - iexists | kexists : 1 if instrument is found, 0 if not + + - instrnum | knstrnum : the instrument number to check + -- cgit v1.2.3