initial

14 files changed, 1981 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..567609b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+build/
diff --git a/CMakeLists.txt b/CMakeLists.txt
new file mode 100644
index 0000000..612d056
--- /dev/null
+++ b/CMakeLists.txt
@@ -0,0 +1,203 @@
+# from https://github.com/csound/plugins : common CMake operations
+cmake_minimum_required(VERSION 2.8.12)
+project(Csound-plugins)
+
+if (${CMAKE_CXX_COMPILER_ID} STREQUAL "Clang")
+    set(CMAKE_COMPILER_IS_CLANG 1)
+endif()
+
+# C++11 needed
+if(NOT MSVC)
+  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
+endif()
+
+set(APIVERSION "6.0")
+
+set(CMAKE_MACOSX_RPATH 1)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "${CMAKE_SOURCE_DIR}/cmake/Modules/")
+
+include(TestBigEndian)
+include(CheckFunctionExists)
+include(CheckCCompilerFlag)
+include(CheckCXXCompilerFlag)
+
+### COMPILER OPTIMIZATION FLAGS
+option(USE_COMPILER_OPTIMIZATIONS "Use the default Csound compiler optimization flags" ON)
+if(USE_COMPILER_OPTIMIZATIONS)
+    include(${CMAKE_SOURCE_DIR}/cmake/CompilerOptimizations.cmake)
+endif()
+
+if(APPLE)
+    set(OSX_VERSION " ")
+endif()
+
+## USER OPTIONS ##
+# Optional targets, they should all default to ON (check_deps will disable them if not possible to build)
+option(USE_DOUBLE "Set to use double-precision floating point for audio samples." ON)
+option(USE_LRINT "Use lrint/lrintf for converting floating point values to integers." ON)
+option(BUILD_RELEASE "Build for release" ON)
+option(USE_GIT_COMMIT "Show the git commit in version information" ON)
+
+# in Release configuration, set NDEBUG
+if(${CMAKE_BUILD_TYPE} MATCHES "Release")
+message("-----> Release mode")
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DNDEBUG")
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DNDEBUG")
+elseif(${CMAKE_BUILD_TYPE} MATCHES "Debug")
+message("-----> Debug mode")
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -DBETA")
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -DBETA")
+endif()
+
+# set -Werror if in Debug configuration
+if(NOT MSVC AND NOT WASM)
+    set(CMAKE_CXX_FLAGS_RELEASE "-O3 ")
+    set(CMAKE_C_FLAGS_RELEASE "-O3 ")
+    if(${CMAKE_BUILD_TYPE} MATCHES "Debug")
+        set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}  -Wall -Werror -Wno-missing-field-initializers")
+        set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Werror -Wno-missing-field-initializers")
+    endif()
+endif()
+
+
+if(CMAKE_SYSTEM_NAME MATCHES "Linux")
+    set(LINUX YES)
+else()
+    set(LINUX NO)
+endif()
+
+set(BUILD_DIR ${CMAKE_CURRENT_BINARY_DIR})
+
+check_c_compiler_flag(-fvisibility=hidden HAS_VISIBILITY_HIDDEN)
+check_cxx_compiler_flag(-fvisibility=hidden HAS_CXX_VISIBILITY_HIDDEN)
+if (HAS_VISIBILITY_HIDDEN)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fvisibility=hidden")
+endif()
+if (HAS_CXX_VISIBILITY_HIDDEN)
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=hidden")
+endif()
+
+check_c_compiler_flag(-std=gnu99 HAS_GNU99)
+if (HAS_GNU99)
+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -std=gnu99")
+endif()
+if (HAS_CXX_VISIBILITY_HIDDEN)
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=hidden")
+endif()
+
+find_package(Csound)
+
+option(USE_LIB64 "Set to on to set installation directory for libraries to lib64" OFF)
+if(USE_LIB64)
+    set(LIBRARY_INSTALL_DIR "lib64")
+    add_definitions("-DLIB64")
+else()
+    set(LIBRARY_INSTALL_DIR "lib")
+endif()
+message(STATUS "LIBRARY INSTALL DIR: ${LIBRARY_INSTALL_DIR}")
+
+if(USE_DOUBLE)
+    message(STATUS "Building with 64-bit floats")
+    set(PLUGIN_INSTALL_DIR "${LIBRARY_INSTALL_DIR}/csound/plugins64-${APIVERSION}")
+    if(APPLE)
+        set(PLUGIN_INSTALL_DIR "${CS_FRAMEWORK_DEST}/${CSOUNDLIB}.framework/Versions/${APIVERSION}/Resources/Opcodes64")
+    endif()
+else()
+    message(STATUS "Building with 32-bit floats")
+    set(PLUGIN_INSTALL_DIR "${LIBRARY_INSTALL_DIR}/csound/plugins-${APIVERSION}")
+    if(APPLE)
+        set(PLUGIN_INSTALL_DIR "${CS_FRAMEWORK_DEST}/${CSOUNDLIB}.framework/Versions/${APIVERSION}/Resources/Opcodes")
+    endif()
+endif()
+
+
+# Checks if dependencies for an enabled target are fulfilled.
+# If FAIL_MISSING is true and the dependencies are not fulfilled,
+# it will abort the cmake run.
+# If FAIL_MISSING is false, it will set the option to OFF.
+# If the target is not enabled, it will do nothing.
+# example: check_deps(BUILD_NEW_PARSER FLEX_EXECUTABLE BISON_EXECUTABLE)
+function(check_deps option)
+    if(${option})
+        set(i 1)
+        while( ${i} LESS ${ARGC} )
+            set(dep ${ARGV${i}})
+            if(NOT ${dep})
+                if(FAIL_MISSING)
+                    message(FATAL_ERROR
+                        "${option} is enabled, but ${dep}=\"${${dep}}\"")
+                else()
+                    message(STATUS "${dep}=\"${${dep}}\", so disabling ${option}")
+                    set(${option} OFF PARENT_SCOPE)
+                    # Set it in the local scope too
+                    set(${option} OFF)
+                endif()
+            endif()
+            math(EXPR i "${i}+1")
+        endwhile()
+    endif()
+    if(${option})
+        message(STATUS "${option} is enabled.")
+    else()
+        message(STATUS "${option} is disabled.")
+    endif()
+endfunction(check_deps)
+
+# Utility function to make plugins. All plugin targets should use this as it
+# sets up output directory set in top-level CmakeLists.txt
+# and adds the appropriate install target
+#
+# libname - name of library to produce
+# srcs - list of src files (must be quoted if a list)
+# extralibs (OPTIONAL) - extra libraries to link the plugin to
+#
+# NB - this was moved here as it needs some VARS defined above
+# for setting up the framework
+function(make_plugin libname srcs)
+    if(APPLE)
+        add_library(${libname} SHARED ${srcs})
+    else()
+        add_library(${libname} MODULE ${srcs})
+    endif()
+
+    set(i 2)
+    while( ${i} LESS ${ARGC} )
+        target_link_libraries(${libname} ${ARGV${i}})
+        math(EXPR i "${i}+1")
+    endwhile()
+
+    set_target_properties(${libname} PROPERTIES
+        RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+        LIBRARY_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+        ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR})
+
+    install(TARGETS ${libname}
+        LIBRARY DESTINATION "${PLUGIN_INSTALL_DIR}" 
+        ARCHIVE DESTINATION "${PLUGIN_INSTALL_DIR}" )
+endfunction(make_plugin)
+
+# Linux does not have a separate libintl, it is part of libc
+set(LIBINTL_AVAIL (LIBINTL_LIBRARY OR LINUX))
+
+if(LINUX)
+    message(STATUS "Building on Linux.")
+    add_definitions(-DLINUX -DPIPES -D_GNU_SOURCE -DHAVE_SOCKETS)
+    list(APPEND libcsound_LIBS ${MATH_LIBRARY} dl)
+
+endif()
+
+if(APPLE AND NOT IOS)
+    message(STATUS "Building on OSX")
+    add_definitions(-DMACOSX -DPIPES -DNO_FLTK_THREADS -DHAVE_SOCKETS)
+    find_library(ACCELERATE_LIBRARY Accelerate)
+    find_path(VECLIB_PATH "Accelerate/Accelerate.h")
+    include_directories(${VECLIB_PATH})
+    list(APPEND libcsound_LIBS ${MATH_LIBRARY} dl ${ACCELERATE_LIBRARY})
+endif()
+
+if(WIN32)
+    add_definitions(-DWIN32)
+endif()
+
+include(Plugin.cmake)
diff --git a/LICENCE b/LICENCE
new file mode 100644
index 0000000..de9fd5a
--- /dev/null
+++ b/LICENCE
@@ -0,0 +1,502 @@
+		  GNU LESSER GENERAL PUBLIC LICENSE
+		       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+     51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+			    Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+^L
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+^L
+		  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+  
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+^L
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+^L
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+^L
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+^L
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+^L
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+^L
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+			    NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+		     END OF TERMS AND CONDITIONS
+^L
+           How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the library's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+  <signature of Ty Coon>, 1 April 1990
+  Ty Coon, President of Vice
+
+That's all there is to it!
diff --git a/Plugin.cmake b/Plugin.cmake
new file mode 100644
index 0000000..83586f6
--- /dev/null
+++ b/Plugin.cmake
@@ -0,0 +1,14 @@
+set(PLUGIN_NAME adlmidi)
+set(INCLUDES "include" ${CSOUND_INCLUDE_DIRS})
+set(LIBS "")
+
+# Dependencies
+find_package(ADLMIDI)
+check_deps(ADLMIDI_FOUND)
+list(APPEND LIBS ${ADLMIDI_LIBRARY})
+list(APPEND INCLUDES ${ADLMIDI_INCLUDE_DIR})
+
+# Source files
+set(CPPFILES src/opcodes.cpp)
+make_plugin(${PLUGIN_NAME} "${CPPFILES}" ${LIBS})
+target_include_directories(${PLUGIN_NAME} PRIVATE ${INCLUDES})
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c2772c3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,91 @@
+# csound-opl3 : OPL3 emulation for Csound
+
+## Overview
+Description here
+
+## Requirements
+* Cmake >= 2.8.12
+* Csound with development headers
+* libADLMIDI (https://github.com/Wohlstand/libADLMIDI)
+
+
+
+## Installation
+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 library can be used with the *--opcode-lib* flag in Csound.
+eg:
+
+	mkdir build && cd build
+	cmake ..
+	make && sudo make install
+
+Cmake should find Csound and any other required libraries using the modules in the cmake/Modules directory and installation should be as simple as above.
+
+
+## Notes
+Multiple types of OPL3 emulation are provided as in libADLMIDI. These are:
+* DOSBox : fast and quite accurate
+* Nuked : Very accurate, very CPU intensive
+
+All parameter ranges are representative of the original OPL3 chip which used 8-bit registers, hence ranges such as 0 - 15 and 0 - 3. 
+The parameters are all integers, so for example with attack, there are actually only 16 possible attack times. Any floating point numbers passed will just
+be converted accordingly.
+
+
+## Examples
+Some examples are provided in the examples directory.
+
+
+## Opcode reference
+
+### ioplhandle, aleft, aright opl [iemulation=0, irunatpcmrate=0]
+Create an instance of the emulated OPL3 synthesiser.
+
+* ioplhandle : handle to be used in other opcodes to control synthesis
+* aleft, aright : stereo audio outputs
+
+* iemulation : OPL3 chip emulation type (0 = DOSBox, 1 = Nuked_1.8, 2=Nuked_1.74, 3=Opal, 4=Java)
+* irunatpcmrate : run emulation at PCM rate; setting to 1 may reduce CPU usage but lessen emulation accuracy
+
+
+### oplnote ioplhandle, ichannel, inote, ivelocity
+Play a note using the synthesiser specified by ioplhandle.
+
+* ioplhandle : handle created by the opl opcode
+* ichannel : channel for playback (0 - 15)
+* inote : midi note number to play
+* ivelocity : midi note velocity (0 - 127)
+
+
+### iop1, iop2, iop3, iop4 oplinstrument ioplhandle, kfeedback ETC
+Modify the current instrument parameters and obtain handles to all four operators (oscillators) for further manipulation with the oploperator opcode.
+
+* iop1, iop2, iop3, iop4 : handles for the individual operators to be used by the oploperator opcode.
+
+
+### oploperator iop, klevel, kscale, kattack, kdecay, ksustain, krelease, kwave, kfreqmul, ktrem, kvib, ksus, kenv
+Alter individual operator parameters. Out of range parameters will wrap around.
+
+* iop : handle for the specific operator as provided by the oplinstrument opcode
+
+* klevel : gain level (0 - 63)
+* kscale : key scale (0 - 3)
+* kattack : attack time (0 - 15)
+* kdecay : decay time (0 - 15)
+* ksustain : sustain time (0 - 15)
+* krelease : release time (0 - 15)
+* kwave : waveform (0 - 7)
+* kfreqmul : frequency multiplier (0 - 15)
+* ktrem : tremolo switch (0 - 1)
+* kvib : vibrato switch (0 - 1)
+* ksus : sustaining switch (0 - 1)
+* kenv : key envelope switch (0 - 1)
+
+
+
+### oplpanic ioplhandle
+Terminate all current notes for the given opl instance.
+
+* ioplhandle : handle created by the opl opcode
+
+
+
diff --git a/cmake/CompilerOptimizations.cmake b/cmake/CompilerOptimizations.cmake
new file mode 100644
index 0000000..543daf8
--- /dev/null
+++ b/cmake/CompilerOptimizations.cmake
@@ -0,0 +1,53 @@
+

+check_c_compiler_flag(-ftree-vectorize HAS_TREE_VECTORIZE)

+check_cxx_compiler_flag(-ftree-vectorize HAS_CXX_TREE_VECTORIZE)

+if (HAS_TREE_VECTORISE)

+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -ftree-vectorize")

+endif()

+if (HAS_CXX_TREE_VECTORISE)

+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -ftree-vectorize")

+endif()

+

+

+check_c_compiler_flag(-ffast-math HAS_FAST_MATH)

+check_cxx_compiler_flag(-ffast-math HAS_CXX_FAST_MATH)

+if (HAS_FAST_MATH AND NOT MINGW)

+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -ffast-math")

+endif()

+if (HAS_CXX_FAST_MATH AND NOT MINGW)

+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -ffast-math")

+endif()

+

+

+

+if(NOT "${CMAKE_CXX_COMPILER_ID}" STREQUAL "Clang")

+check_c_compiler_flag(-mfpmath=sse HAS_FPMATH_SSE)

+check_cxx_compiler_flag(-mfpmath=sse HAS_CXX_FPMATH_SSE)

+  if (HAS_FPMATH_SSE)

+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mfpmath=sse")

+endif()

+if (HAS_CXX_FPMATH_SSE)

+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mfpmath=sse")

+endif()

+

+endif()

+

+

+check_c_compiler_flag(-msse2 HAS_SSE2)

+check_cxx_compiler_flag(-msse2 HAS_CXX_SSE2)

+  if (HAS_SSE2 AND NOT IOS AND NOT WASM)

+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -msse2")

+endif()

+if (HAS_CXX_SSE2 AND NOT IOS AND NOT WASM)

+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -msse2")

+endif()

+

+

+check_c_compiler_flag(-fomit-frame-pointer HAS_OMIT_FRAME_POINTER)

+check_cxx_compiler_flag(-fomit-frame-pointer HAS_CXX_OMIT_FRAME_POINTER)

+if (HAS_OMIT_FRAME_POINTER)

+    set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fomit-frame-pointer")

+endif()

+if (HAS_CXX_OMIT_FRAME_POINTER)

+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fomit-frame-pointer")

+endif()

diff --git a/cmake/Modules/FindADLMIDI.cmake b/cmake/Modules/FindADLMIDI.cmake
new file mode 100644
index 0000000..91bbe61
--- /dev/null
+++ b/cmake/Modules/FindADLMIDI.cmake
@@ -0,0 +1,34 @@
+# This module defines
+# ADLMIDI_LIBRARY, the name of the library to link against
+# ADLMIDI_FOUND, if false, do not try to link to ADLMIDI
+# ADLMIDI_INCLUDE_DIR, where to find adlmidi.h
+#
+
+SET(ADLMIDI_SEARCH_PATHS
+	~/Library/Frameworks
+	/Library/Frameworks
+	/usr/local
+	/usr
+	/sw # Fink
+	/opt/local # DarwinPorts
+	/opt/csw # Blastwave
+	/opt
+)
+
+FIND_PATH(ADLMIDI_INCLUDE_DIR adlmidi.h)
+
+if(CMAKE_SIZEOF_VOID_P EQUAL 8) 
+	set(PATH_SUFFIXES lib64 lib/x64 lib)
+else() 
+	set(PATH_SUFFIXES lib/x86 lib)
+endif() 
+
+FIND_LIBRARY(ADLMIDI_LIBRARY
+	NAMES ADLMIDI
+	PATH_SUFFIXES ${PATH_SUFFIXES}
+	PATHS ${ADLMIDI_SEARCH_PATHS}
+)
+
+INCLUDE(FindPackageHandleStandardArgs)
+
+FIND_PACKAGE_HANDLE_STANDARD_ARGS(ADLMIDI REQUIRED_VARS ADLMIDI_LIBRARY ADLMIDI_INCLUDE_DIR)
diff --git a/cmake/Modules/FindCsound.cmake b/cmake/Modules/FindCsound.cmake
new file mode 100644
index 0000000..24c90d9
--- /dev/null
+++ b/cmake/Modules/FindCsound.cmake
@@ -0,0 +1,62 @@
+# Try to find the Csound library.
+# Once done this will define:
+#  CSOUND_FOUND - System has the Csound library
+#  CSOUND_INCLUDE_DIRS - The Csound include directories.
+#  CSOUND_LIBRARIES - The libraries needed to use the Csound library.
+
+# RKnight 2021-07-21 : quick copy paste hack to deal with 32 bit if not using double
+
+if(USE_DOUBLE)
+  # 64 bit
+  if(APPLE)
+    find_path(CSOUND_INCLUDE_DIR csound.h HINTS /Library/Frameworks/CsoundLib64.framework/Headers
+    "$ENV{HOME}/Library/Frameworks/CsoundLib64.framework/Headers")
+  elseif(WIN32)
+    find_path(CSOUND_INCLUDE_DIR csound.h PATH_SUFFIXES csound 
+            HINTS "c:\\Program Files\\Csound6_x64\\include")
+  else()
+    find_path(CSOUND_INCLUDE_DIR csound.h PATH_SUFFIXES csound)
+  endif()
+
+  if(APPLE)
+    find_library(CSOUND_LIBRARY NAMES CsoundLib64 HINTS /Library/Frameworks/CsoundLib64.framework/
+    "$ENV{HOME}/Library/Frameworks/CsoundLib64.framework")
+  elseif(WIN32)
+    find_library(CSOUND_LIBRARY NAMES csound64 HINTS "c:\\Program Files\\Csound6_x64\\lib")
+  else()
+    find_library(CSOUND_LIBRARY NAMES csound64 csound)
+  endif()
+
+else()
+  # 32 bit
+  if(APPLE)
+    find_path(CSOUND_INCLUDE_DIR csound.h HINTS /Library/Frameworks/CsoundLib.framework/Headers
+    "$ENV{HOME}/Library/Frameworks/CsoundLib.framework/Headers")
+  elseif(WIN32)
+    find_path(CSOUND_INCLUDE_DIR csound.h PATH_SUFFIXES csound 
+            HINTS "c:\\Program Files (x86)\\Csound6\\include")
+  else()
+    find_path(CSOUND_INCLUDE_DIR csound.h PATH_SUFFIXES csound)
+  endif()
+
+  if(APPLE)
+    find_library(CSOUND_LIBRARY NAMES CsoundLib HINTS /Library/Frameworks/CsoundLib.framework/
+    "$ENV{HOME}/Library/Frameworks/CsoundLib.framework")
+  elseif(WIN32)
+    find_library(CSOUND_LIBRARY NAMES csound HINTS "c:\\Program Files (x86)\\Csound6\\lib")
+  else()
+    find_library(CSOUND_LIBRARY NAMES csound csound)
+  endif()
+
+endif()
+
+
+include(FindPackageHandleStandardArgs)
+# handle the QUIETLY and REQUIRED arguments and set CSOUND_FOUND to TRUE
+# if all listed variables are TRUE
+find_package_handle_standard_args(CSOUND
+                                  CSOUND_LIBRARY CSOUND_INCLUDE_DIR)
+mark_as_advanced(CSOUND_INCLUDE_DIR CSOUND_LIBRARY)
+
+set(CSOUND_INCLUDE_DIRS ${CSOUND_INCLUDE_DIR})
+set(CSOUND_LIBRARIES ${CSOUND_LIBRARY} )
diff --git a/examples/0-fltk_gui.csd b/examples/0-fltk_gui.csd
new file mode 100644
index 0000000..d81a48a
--- /dev/null
+++ b/examples/0-fltk_gui.csd
@@ -0,0 +1,169 @@
+<CsoundSynthesizer>
+<CsOptions>
+-odac
+-+rtmidi=virtual -M0
+</CsOptions>
+; ==============================================
+<CsInstruments>
+
+sr	=	44100
+kr = 4410
+nchnls	=	2
+0dbfs	=	1
+seed 0 
+
+gkop[][] init 4, 12
+giop[][] init 4, 12
+gkinstr[] init 8
+giinstr[] init 8
+giopwidth = 200
+gidiv = 60
+
+opcode operator, 0, i
+    iop xin
+    ix = giopwidth * iop
+    iy = 0
+    ihl FLbox sprintf("OP%d", iop+1), 1, 2, 14, giopwidth, 30, ix, iy
+    gkop[iop][0], giop[iop][0] FLslider "Level", 0, 63, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*1)
+    gkop[iop][1], giop[iop][1] FLslider "Key scale", 0, 3, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*2)
+    gkop[iop][2], giop[iop][2] FLslider "Attack", 0, 15, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*3)
+    gkop[iop][3], giop[iop][3] FLslider "Decay", 0, 15, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*4)
+    gkop[iop][4], giop[iop][4] FLslider "Sustain", 0, 15, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*5)
+    gkop[iop][5], giop[iop][5] FLslider "Release", 0, 15, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*6)
+    gkop[iop][6], giop[iop][6] FLslider "Waveform", 0, 7, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*7)      ;; TODO have as scrollbox/text
+    gkop[iop][7], giop[iop][7] FLslider "Frequency multiplier", 0, 15, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*8)
+    gkop[iop][8], giop[iop][8] FLbutton "Tremolo", 1, 0, 3, giopwidth/2, 30, ix, iy+(gidiv*9), -1
+    gkop[iop][9], giop[iop][9] FLbutton "Vibrato", 1, 0, 3, giopwidth/2, 30, ix+(giopwidth/2), iy+(gidiv*9), -1
+    gkop[iop][10], giop[iop][10] FLbutton "Sustaining", 1, 0, 3, giopwidth/2, 30, ix, iy+(gidiv*9.5), -1
+    gkop[iop][11], giop[iop][11] FLbutton "Key env", 1, 0, 3, giopwidth/2, 30, ix+(giopwidth/2), iy+(gidiv*9.5), -1
+
+endop
+
+opcode randomise, 0, 0
+    iop = 0
+    while (iop < 4) do
+        FLsetVal_i random(30, 63), giop[iop][0]
+        FLsetVal_i random(0, 3), giop[iop][1]
+        FLsetVal_i random(0, 15), giop[iop][2]
+        FLsetVal_i random(0, 15), giop[iop][3]
+        FLsetVal_i random(0, 15), giop[iop][4]
+        FLsetVal_i random(0, 15), giop[iop][5]
+        FLsetVal_i random(0, 7), giop[iop][6]
+        FLsetVal_i random(0, 15), giop[iop][7]
+        FLsetVal_i random(0, 1), giop[iop][8]
+        FLsetVal_i random(0, 1), giop[iop][9]
+        FLsetVal_i random(0, 1), giop[iop][10]
+        FLsetVal_i random(0, 1), giop[iop][11]
+        iop += 1
+    od
+    FLsetVal_i random(0, 7), giinstr[2]
+    FLsetVal_i random(0, 7), giinstr[3]
+endop
+
+instr gui
+    FLpanel "OPL3", 1000, 768
+        operator 0
+        operator 1
+        operator 2
+        operator 3
+        ix = 800
+        iy = 0
+        ihl FLbox "Globals", 1, 2, 14, giopwidth, 30, ix, iy
+        gkinstr[0], giinstr[0] FLbutton "Mode 1/2 AM", 1, 0, 3, giopwidth/2, 30, ix, iy+(gidiv), -1
+        gkinstr[1], giinstr[1] FLbutton "Mode 3/4 AM", 1, 0, 3, giopwidth/2, 30, ix+(giopwidth/2), iy+(gidiv), -1
+        gkinstr[2], giinstr[2] FLslider "Feedback 1/2", 0, 7, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*2)
+        gkinstr[3], giinstr[3] FLslider "Feedback 3/4", 0, 7, 0, 1, -1, giopwidth, 30, ix, iy+(gidiv*3)
+        gkinstr[4], giinstr[4] FLbutton "4OP", 1, 0, 3, giopwidth/2, 30, ix, iy+(gidiv*4), 0, nstrnum("fouroptrig"), 0, 1
+        gkinstr[5], giinstr[5] FLbutton "Pseudo 4OP", 1, 0, 3, giopwidth/2, 30, ix+(giopwidth/2), iy+(gidiv*4), 0, nstrnum("fouroptrig"), 0, 1
+        gkinstr[6], giinstr[6] FLbutton "Deep vib", 1, 0, 3, giopwidth/2, 30, ix, iy+(gidiv*4.5), -1
+        gkinstr[7], giinstr[7] FLbutton "Deep trem", 1, 0, 3, giopwidth/2, 30, ix+(giopwidth/2), iy+(gidiv*4.5), -1
+        knull0, inull0 FLbutton "Randomise", 1, 0, 1, giopwidth, 30, ix, iy+(gidiv*5), 0, nstrnum("randomiser"), 0, 1
+        knull1, inull1 FLbutton "Panic", 1, 0, 1, giopwidth, 30, ix, iy+(gidiv*6), 0, nstrnum("panic"), 0, 1
+    FLpanelEnd
+    FLrun
+    event_i "i", "fouropset", 0, 1, 0
+endin
+
+
+
+instr fouroptrig
+    kstate = 0
+    if (gkinstr[4] == 1 || gkinstr[5] == 1) then
+        kstate = 1
+    endif
+    event "i", "fouropset", 0, 1, kstate
+    turnoff
+endin
+
+instr fouropset
+    istate = p4
+    iop = 2
+    while (iop <= 3) do
+        idx = 0
+        while (idx < 12) do
+            ihandle = giop[iop][idx]
+            if (istate == 0) then
+                FLhide ihandle
+            else
+                FLshow ihandle
+            endif
+            idx += 1
+        od
+        iop += 1
+    od
+endin
+
+instr randomiser
+    randomise
+    turnoff
+endin
+
+instr main	
+    giopl, aL, aR opl 5
+    outs aL, aR
+
+    
+    iop1, iop2, iop3, iop4 oplinstrument giopl, gkinstr[0], gkinstr[1], gkinstr[2], gkinstr[3], gkinstr[4], gkinstr[5], gkinstr[6], gkinstr[7]
+
+
+    ; level, keyscale, attack, decay
+    kattack init 2
+    kdecay init 13
+
+    oploperator iop1, gkop[0][0], gkop[0][1], gkop[0][2], gkop[0][3], gkop[0][4], gkop[0][5], gkop[0][6], gkop[0][7], gkop[0][8], gkop[0][9], gkop[0][10], gkop[0][11]
+    oploperator iop2, gkop[1][0], gkop[1][1], gkop[1][2], gkop[1][3], gkop[1][4], gkop[1][5], gkop[1][6], gkop[1][7], gkop[1][8], gkop[1][9], gkop[1][10], gkop[1][11]
+    oploperator iop3, gkop[2][0], gkop[2][1], gkop[2][2], gkop[2][3], gkop[2][4], gkop[2][5], gkop[2][6], gkop[2][7], gkop[2][8], gkop[2][9], gkop[2][10], gkop[2][11]
+    oploperator iop4, gkop[3][0], gkop[3][1], gkop[3][2], gkop[3][3], gkop[3][4], gkop[3][5], gkop[3][6], gkop[3][7], gkop[3][8], gkop[3][9], gkop[3][10], gkop[3][11]
+
+endin
+
+
+instr 2
+    ;inotes[] fillarray 48, 52, 53, 57, 60, 64, 65, 69
+    ;inote = 56;inotes[int(random(0, lenarray(inotes)-1))]-36
+    oplnote giopl, 0, 60, 120
+    oplnote giopl, 0, 64, 120
+    oplnote giopl, 0, 65, 120
+    oplnote giopl, 0, 69, 120
+
+endin
+
+instr 1
+    inote notnum
+    iveloc veloc
+    oplnote giopl, 0, inote, iveloc
+endin
+
+instr panic
+    oplpanic giopl
+endin
+
+
+</CsInstruments>
+; ==============================================
+<CsScore>
+i"main" 0 3600
+i"gui" 0 3600
+</CsScore>
+</CsoundSynthesizer>
+
diff --git a/examples/1-chord_sequence.csd b/examples/1-chord_sequence.csd
new file mode 100644
index 0000000..38e0ed6
--- /dev/null
+++ b/examples/1-chord_sequence.csd
@@ -0,0 +1,104 @@
+<CsoundSynthesizer>
+<CsOptions>
+-odac
+</CsOptions>
+<CsInstruments>
+
+sr = 44100
+kr = 4410
+nchnls = 2
+0dbfs = 1
+
+giopl init 0
+
+instr main	
+    giopl, aL, aR opl
+    outs aL, aR
+
+    oplpatchchange giopl, 0, 89
+    oplpatchchange giopl, 1, 12
+    oplpatchchange giopl, 2, 72
+    oplpatchchange giopl, 3, 96
+
+    event_i "i", "sequencer", 0, p3
+endin
+
+
+opcode playchord, 0, kkkk[]kk
+    kinstr, kduration, kbase, kintervals[], ktimeinc, kreadmode xin
+    ktime = 0
+
+    if (kreadmode == 0) then
+        kdx = 0
+        while (kdx < lenarray(kintervals)) do
+            event "i", kinstr, ktime, kduration, kbase+kintervals[kdx]
+            ktime += ktimeinc
+            kdx += 1
+        od
+    else 
+        kdx = lenarray(kintervals) - 1
+        while (kdx > -1) do
+            event "i", kinstr, ktime, kduration, kbase+kintervals[kdx]
+            ktime += ktimeinc
+            kdx -= 1
+        od
+    endif
+endop
+
+instr sequencer
+    itempo = 120
+    ibeatduration = 60/itempo
+    kintervals[] fillarray 0, 4, 5, 9
+    knotes[] fillarray 50, 54, 56, 48
+    knotedx init 0
+    kbeat metro itempo/60
+    kbar0 init 0
+    if (kbeat == 1) then
+        if (kbar0 == 0) then
+            playchord 3, ibeatduration*4, knotes[knotedx], kintervals, 0, 0
+        elseif (kbar0 == 1) then
+            playchord 2, ibeatduration, knotes[knotedx], kintervals, ibeatduration/4, 0
+        elseif (kbar0 == 2) then
+            playchord 1, ibeatduration, knotes[knotedx]+12, kintervals, 0, 0
+        elseif (kbar0 == 3) then
+            playchord 4, ibeatduration, knotes[knotedx]+12, kintervals, ibeatduration/4, 1
+        endif
+
+        if (kbar0 < 3) then
+            kbar0 += 1
+        else
+            if (knotedx < 3) then
+                knotedx += 1
+            else 
+                knotedx = 0
+            endif
+            kbar0 = 0
+        endif
+    endif
+endin
+
+
+instr 1
+    oplnote giopl, 0, p4, 120
+endin
+
+instr 2
+    oplnote giopl, 1, p4, 100
+endin
+
+instr 3
+    oplnote giopl, 2, p4, 100
+endin
+
+instr 4
+    oplnote giopl, 3, p4, 100
+endin
+
+</CsInstruments>
+; ==============================================
+<CsScore>
+i"main" 0 3600
+
+</CsScore>
+</CsoundSynthesizer>
+
diff --git a/examples/2-random_params.csd b/examples/2-random_params.csd
new file mode 100644
index 0000000..37b951d
--- /dev/null
+++ b/examples/2-random_params.csd
@@ -0,0 +1,58 @@
+<CsoundSynthesizer>
+<CsOptions>
+-odac
+</CsOptions>
+; ==============================================
+<CsInstruments>
+
+sr	=	44100
+kr = 4410
+nchnls	=	2
+0dbfs	=	1
+seed 0 
+
+
+instr main	
+    giopl, aL, aR opl 0
+    outs aL, aR
+
+    kmetro metro 1
+    schedkwhen kmetro, 0, 0, 2, 0, 1
+
+    iop1, iop2, iop3, iop4 oplinstrument giopl, int:k(random:k(0, 2)), int:k(random:k(0, 2)), random:k(0, 7), random:k(0, 7), 1, 1, int:k(random:k(0, 2)), int:k(random:k(0, 2))
+
+
+    ; level, keyscale, attack, decay
+    kattack init 2
+    kdecay init 13
+;0 -15 freq mult
+    oploperator iop1, random:k(60, 63), random:k(0, 3), random:k(0, 15), random:k(0, 15), random:k(0, 15), random:k(0, 1), random:k(0, 7), 0, random:k(0, 2), random:k(0, 2), random:k(0, 2), random:k(0, 2)
+    oploperator iop2, random:k(60, 63), random:k(0, 3), random:k(0, 15), random:k(0, 15), random:k(0, 15), random:k(0, 1), random:k(0, 7), 0, random:k(0, 2), random:k(0, 2), random:k(0, 2), random:k(0, 2)
+    oploperator iop3, random:k(60, 63), random:k(0, 3), random:k(0, 15), random:k(0, 15), random:k(0, 15), random:k(0, 1), random:k(0, 7), 0, random:k(0, 2), random:k(0, 2), random:k(0, 2), random:k(0, 2)
+    oploperator iop4, random:k(60, 63), random:k(0, 3), random:k(0, 15), random:k(0, 15), random:k(0, 15), random:k(0, 1), random:k(0, 7), 0, random:k(0, 2), random:k(0, 2), random:k(0, 2), random:k(0, 2)
+endin
+
+
+instr 2
+    inotes[] fillarray 48, 52, 53, 57
+    inote = inotes[int(random(0, lenarray(inotes)-1))]+24
+    oplnote giopl, 0, inote, 120
+endin
+
+instr 3
+    inote = 48+24
+    oplnote giopl, 1, inote, 120
+    oplnote giopl, 1, inote+4, 120
+    oplnote giopl, 1, inote+5, 120
+    oplnote giopl, 1, inote+9, 120
+endin
+
+
+
+</CsInstruments>
+; ==============================================
+<CsScore>
+i"main" 0 3600
+</CsScore>
+</CsoundSynthesizer>
+
diff --git a/examples/3-controlchanges.csd b/examples/3-controlchanges.csd
new file mode 100644
index 0000000..93749b1
--- /dev/null
+++ b/examples/3-controlchanges.csd
@@ -0,0 +1,77 @@
+<CsoundSynthesizer>
+<CsOptions>
+-odac -m0
+</CsOptions>
+<CsInstruments>
+
+sr = 44100
+kr = 4410
+nchnls	= 2
+0dbfs = 1
+seed 0 
+
+
+instr main	
+    giopl, aL, aR opl
+    outs aL, aR
+    gSbanks[] oplbanknames giopl
+    
+    index = 0
+    itime = 0
+    inote = 0
+    inotes[] fillarray 50, 52, 64, 56, 53, 59, 62 
+    while (index < lenarray(gSbanks)) do
+        event_i "i", "play", itime, 2, index, inotes[inote], 0
+        if (inote < lenarray(inotes)-1) then
+            inote += 1
+        else
+            inote = 0
+        endif
+        if (random(0, 1) > 0.5) then
+            event_i "i", "play", itime+0.5, 0.5, index, inotes[inote], 1
+        endif
+        itime += 1
+        index += 1
+    od
+    p3 = itime
+endin
+
+
+instr play
+    ibank = p4
+    inote = p5
+    ichannel = p6
+    ipatch random 0, 127
+    prints sprintf("%d-%d (%s)\n", ibank, ipatch, gSbanks[ibank])    
+    if (ichannel == 0) then
+        oplsetbank giopl, ibank
+    endif
+    oplpatchchange giopl, ichannel, ipatch
+    oplnote giopl, ichannel, inote, 100
+    event_i "i", "cc", p3*0.5, p3*0.5, ichannel
+endin
+
+
+instr cc
+    ichannel = p4
+    if (random(0, 1) > 0.6) then
+        ibend = (random(0, 1) > 0.5) ? 1 : -1
+        kbend linseg 0, p3*0.7, 0, p3*0.29, ibend, p3*0.01, 0
+        oplpitchbend giopl, ichannel, kbend
+    endif
+
+
+    if (random(0, 1) > 0.6) then
+        kmod linseg 0, p3*0.7, 255, p3*0.3, 0
+        oplcontrolchange giopl, ichannel, 1, kmod
+    endif
+endin
+
+
+</CsInstruments>
+; ==============================================
+<CsScore>
+i"main" 0 3600
+</CsScore>
+</CsoundSynthesizer>
+
diff --git a/include/handling.h b/include/handling.h
new file mode 100644
index 0000000..706ffb1
--- /dev/null
+++ b/include/handling.h
@@ -0,0 +1,54 @@
+/*
+    handling.h
+    Copyright (C) 2021 Richard Knight
+
+
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 3 of the License, or (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with this program; if not, write to the Free Software Foundation,
+    Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ 
+ */
+#include <plugin.h>
+
+const char* handleIdentifier = "::hnd%d";
+
+
+/*
+ * Obtain global object of typename from global variables by handle
+ */
+template <typename T>
+T* getHandle(csnd::Csound* csound, MYFLT handle) {
+    char buffer[32];
+    snprintf(buffer, 32, handleIdentifier, (int)handle);
+    return (T*) csound->query_global_variable(buffer);  
+}
+
+
+/*
+ * Create global object of typename in global variables, returning handle
+ */
+template <typename T>
+MYFLT createHandle(csnd::Csound* csound, T** data) {
+    char buffer[32];
+    int handle = 0;
+    snprintf(buffer, 32, handleIdentifier, handle);
+    while ((*data = (T*) csound->query_global_variable(buffer)) != NULL) {
+        snprintf(buffer, 32, handleIdentifier, ++handle);
+    }
+    csound->create_global_variable(buffer, sizeof(T));
+    *data = (T*) csound->query_global_variable(buffer);
+    
+    return FL(handle);
+}
+
+
diff --git a/src/opcodes.cpp b/src/opcodes.cpp
new file mode 100644
index 0000000..7b38c80
--- /dev/null
+++ b/src/opcodes.cpp
@@ -0,0 +1,559 @@
+/*
+    opcodes.cpp
+    Copyright (C) 2021 Richard Knight
+
+
+    This program is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 3 of the License, or (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public License
+    along with this program; if not, write to the Free Software Foundation,
+    Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ 
+ */
+#include <float.h>
+#include <plugin.h>
+#include "handling.h"
+#include "adlmidi.h"
+/* sources referenced for bit shift/convert operations etc
+ * https://github.com/jpcima/ADLplug/blob/master/sources/opl3/parameter_block.cc
+ * https://github.com/jpcima/ADLplug/blob/master/sources/opl3/adl/instrument.h
+ * https://github.com/jpcima/ADLplug/blob/master/sources/utility/field_bitops.h
+ */
+
+
+static const char* badHandle = "opl handle is not valid";
+
+/*
+ * core struct for passing between opcodes as a handle
+ */
+struct ADLSession {
+    ADL_MIDIPlayer* device = NULL;
+    bool changed;
+};
+
+/*
+ *  operator struct for passing between oplinstrument and oploperator opcodes
+ */
+struct ADLSessionOperator {
+    ADLSession* session;
+    ADL_Operator* op;
+};
+
+/*
+ *  bit conversion for decimal to OPL chipset values
+ */
+static int bitconvert(int shiftb, int size, int current, MYFLT value) {
+    int mask = (1 << size) - 1;
+    return (current & ~(mask << shiftb)) | (( ((int)value) & mask) << shiftb);
+}
+
+/*
+ *  bit conversion for decimal to OPL chipset values, inverse
+ */
+static int bitconvert_inv(int shiftb, int size, ADL_UInt8 current, MYFLT value) {
+    int max = ((1 << size) - 1);
+    return bitconvert(shiftb, size, current, max - value);
+}
+
+/* 
+ * opcode: opl
+ * handle the libADLMIDI instance and output audio
+ */
+struct opl : csnd::Plugin<3, 2> {
+    static constexpr char const *otypes = "iaa";
+    static constexpr char const *itypes = "oo";
+    
+    ADLSession* session;
+    short* out;
+    
+    int init() {
+        csound->plugin_deinit(this);
+        outargs[0] = createHandle<ADLSession>(csound, &session);
+
+        session->device = adl_init(csound->sr());
+        if (session->device == NULL) {
+            return csound->init_error(adl_errorString());
+        }
+        int status = 0;
+        if (inargs[0] == FL(0)) {
+            status = adl_switchEmulator(session->device, ADLMIDI_EMU_DOSBOX);
+        } else if (inargs[0] == FL(1)) {
+            status = adl_switchEmulator(session->device, ADLMIDI_EMU_NUKED);
+        } else if (inargs[0] == FL(2)) {
+            status = adl_switchEmulator(session->device, ADLMIDI_EMU_NUKED_174);
+        } else if (inargs[0] == FL(3)) {
+            status = adl_switchEmulator(session->device, ADLMIDI_EMU_OPAL);
+        } else if (inargs[0] == FL(4)) {
+            status = adl_switchEmulator(session->device, ADLMIDI_EMU_JAVA);
+        }
+        
+        if (status != 0) return csound->init_error(adl_errorInfo(session->device));
+
+        status = adl_setRunAtPcmRate(session->device, (int) inargs[1]);
+        if (status != 0) return csound->init_error(adl_errorInfo(session->device));
+        
+        out = (short*) csound->calloc(sizeof(short) * ksmps() * 2);
+        return OK;
+    }
+    
+    int deinit() {
+        //if (session->device != NULL) adl_close(session->device); // causes segfault..?
+        if (out != NULL) csound->free(out);
+        return OK;
+        
+    }
+    
+    int aperf() {
+        int read_pos = 0;
+        int sample_count = adl_generate(session->device, nsmps*2, out);
+        for (int i = 0; i < nsmps; i++) { // interleaved buffer from ADL
+            outargs(1)[i] = ((MYFLT) out[read_pos++])/SHRT_MAX;
+            outargs(2)[i] = ((MYFLT) out[read_pos++])/SHRT_MAX;
+        }
+        
+        return OK;
+    }
+};
+
+/* 
+ * opcode: oplsetbank
+ * set the current bank by index (preset internal libADLMIDI banks, specified at
+ * compile time)
+ */
+struct oplsetbank : csnd::InPlug<2> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "ii";
+    
+    int init() {
+        ADLSession* session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        int status = adl_setBank(session->device, (int) args[1]);
+        if (status != 0) return csound->init_error(adl_errorInfo(session->device));
+        adl_reset(session->device);
+        return OK;
+    }
+};
+
+/* 
+ * opcode: oplpanic
+ * turn off all notes, reset the instance
+ */
+struct oplpanic : csnd::InPlug<1> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "i";
+    
+    int init() {
+        ADLSession* session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        adl_panic(session->device);
+        adl_reset(session->device);
+        return OK;
+    }
+};
+
+/* 
+ * opcode: oplpatchchange
+ * change the midi patch (ie 0-127) for a specified channel
+ */
+struct oplpatchchange : csnd::InPlug<3> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "ikk";
+    
+    ADLSession* session;
+    int channel;
+    int patch;
+    
+    int init() {
+        session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        channel = (int) args[1];
+        patch = (int) args[2];
+        adl_rt_patchChange(session->device, channel, patch);
+        return OK;
+    }
+    
+    int kperf() {
+        int channel = (int) args[1];
+        int patch = (int) args[2]; 
+        if (channel != this->channel || patch != this->patch) {
+            this->channel = channel;
+            this->patch = patch;
+            adl_rt_patchChange(session->device, channel, patch);
+        }
+        return OK;
+    }
+};
+
+
+/* 
+ * opcode: oplaftertouch
+ * apply aftertouch for channel
+ */
+struct oplaftertouch : csnd::InPlug<3> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "ikk";
+    
+    ADLSession* session;
+    int channel;    
+    ADL_UInt8 value;
+    
+    int init() {
+        session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        channel = (int) args[1];
+        value = (ADL_UInt8) args[2];
+        adl_rt_channelAfterTouch(session->device, channel, value);
+        return OK;
+    }
+    
+    int kperf() {
+        channel = (int) args[1];
+        value = (ADL_UInt8) args[2];
+        if (channel != this->channel || value != this->value) {
+            this->channel = channel;
+            this->value = value;
+            adl_rt_channelAfterTouch(session->device, channel, value);
+        }
+        return OK;
+    }
+};
+
+/* 
+ * opcode: oplcontrolchange
+ * apply control change for channel
+ */
+struct oplcontrolchange : csnd::InPlug<4> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "ikkk";
+    
+    ADLSession* session;
+    int channel;    
+    ADL_UInt8 type;
+    ADL_UInt8 value;
+    
+    int init() {
+        session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        channel = (int) args[1];
+        type = (ADL_UInt8) args[2];
+        value = (ADL_UInt8) args[3];
+        adl_rt_controllerChange(session->device, channel, type, value);
+        return OK;
+    }
+    
+    int kperf() {
+        channel = (int) args[1];
+        type = (ADL_UInt8) args[2];
+        value = (ADL_UInt8) args[3];
+        if (channel != this->channel || type != this->type || value != this->value) {
+            this->channel = channel;
+            this->type = type;
+            this->value = value;
+            adl_rt_controllerChange(session->device, channel, type, value);
+        }
+        return OK;
+    }
+};
+
+/* 
+ * opcode: oplpitchbend
+ * apply channel specific pitch bend; pitch bend is 24bit
+ */
+struct oplpitchbend : csnd::InPlug<3> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "ikk";
+    
+    ADLSession* session;
+    int channel;
+    ADL_UInt16 bend;
+    
+    int init() {
+        session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        channel = (int) args[1];
+        bend = (ADL_UInt16) ((args[2]*4096)+8192); 
+        adl_rt_pitchBend(session->device, channel, bend);
+        return OK;
+    }
+    
+    int kperf() {
+        int channel = (int) args[1];
+        ADL_UInt16 bend = (ADL_UInt16) ((args[2]*4096)+8192);
+        if (channel != this->channel || bend != this->bend) {
+            this->channel = channel;
+            this->bend = bend;
+            adl_rt_pitchBend(session->device, channel, bend);
+        }
+        return OK;
+    }
+};
+
+/* 
+ * opcode: oplnote
+ * play a note on the specified opl instance
+ */
+struct oplnote : csnd::InPlug<4> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "iiii";
+    
+    int channel;
+    int note;
+    ADLSession* session;
+    
+    int init() {
+        csound->plugin_deinit(this);
+        session = getHandle<ADLSession>(csound, args[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        channel = (int) args[1];
+        note = (int) args[2];
+        int velocity = (int) args[3];
+        adl_rt_noteOn(session->device, channel, note, velocity);
+        return OK;
+    }
+    
+    int deinit() {
+        adl_rt_noteOff(session->device, channel, note);
+    }
+};
+
+struct oplbanknames : csnd::Plugin<1, 1> { // InPlug
+    static constexpr char const *otypes = "S[]";
+    static constexpr char const *itypes = "i";
+    
+    int init() {
+        ADLSession* session = getHandle<ADLSession>(csound, inargs[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        int banks_number = adl_getBanksCount();
+        
+        ARRAYDAT* array = (ARRAYDAT*) outargs(0);
+        array->sizes = (int32_t*) csound->calloc(sizeof(int32_t));
+        array->sizes[0] = banks_number;
+        array->dimensions = 1;
+        CS_VARIABLE* var = array->arrayType->createVariable(csound, NULL);
+        array->arrayMemberSize = var->memBlockSize;
+        array->data = (MYFLT*) csound->calloc(var->memBlockSize * banks_number);
+        STRINGDAT* data = (STRINGDAT*) array->data;
+        
+        const char* const* banks = adl_getBankNames();
+        for (int i = 0 ; i < banks_number; i++) {
+            data[i].size = strlen(banks[i]);
+            data[i].data = csound->strdup((char*) banks[i]);
+        }
+        return OK;
+    }
+    
+};
+
+
+
+/* 
+ * opcode: oploperator
+ * control specific parameters of an operator (oscillator)
+ */
+struct oploperator : csnd::InPlug<13> {
+    static constexpr char const *otypes = "";
+    static constexpr char const *itypes = "ikkkkkkkkkkkk";
+    
+    ADLSessionOperator* so;
+    ADL_Operator* o;
+    MYFLT* lastval;
+    int argnum;
+    
+    int init() {
+        argnum = 13;
+        so = getHandle<ADLSessionOperator>(csound, args[0]);
+        if (so == NULL) return csound->init_error("opl instrument handle is not valid");
+        o = so->op;
+        lastval = (MYFLT*) csound->malloc(sizeof(MYFLT) * argnum);
+        setvalues();
+        return OK;
+    }
+    
+    
+    
+    bool haschanged() { // TODO really saves any overhead??
+        bool changed = false;
+        for (int i = 1; i < argnum ; i++) {
+            if (args[i] != lastval[i]) {
+                lastval[i] = args[i];
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    
+    void setvalues() {
+        // level, 0 to 63
+        o->ksl_l_40 = bitconvert_inv(0, 6, o->ksl_l_40, args[1]);
+        //printf("%d-x\n", o->ksl_l_40);
+        
+        // key scale level, 0 to 3
+        o->ksl_l_40 = bitconvert_inv(6, 2, o->ksl_l_40, args[2]);
+        
+        // attack, 0 to 15
+        o->atdec_60 = bitconvert_inv(4, 4, o->atdec_60, args[3]);
+        
+        // decay, 0 to 15
+        o->atdec_60 = bitconvert_inv(0, 4, o->atdec_60, args[4]);
+        
+        // sustain, 0 to 15 
+        o->susrel_80 = bitconvert_inv(4, 4, o->susrel_80, args[5]);
+        
+        // release, 0 to 15
+        o->susrel_80 = bitconvert_inv(0, 4, o->susrel_80, args[6]);
+        
+        // waveform, 0 to 8
+        o->waveform_E0 = bitconvert(0, 3, o->waveform_E0, args[7]);
+        
+        // freq mult, 0 to 15
+        o->avekf_20 = bitconvert(0, 4, o->avekf_20, args[8]);
+        
+        // tremolo, 0 to 1
+        o->avekf_20 = bitconvert(7, 1, o->avekf_20, args[9]);
+        
+        // vibrato, 0 to 1
+        o->avekf_20 = bitconvert(6, 1, o->avekf_20, args[10]);
+        
+        // sustaining, 0 to 1
+        o->avekf_20 = bitconvert(5, 1, o->avekf_20, args[11]);
+        
+        // env/key scaling, 0 to 1
+        o->avekf_20 = bitconvert(4, 1, o->avekf_20, args[12]);
+    }
+    
+    int kperf() {
+        //o->avekf_20 = (ADL_UInt8) shift(args[1];
+        
+        if (haschanged()) {
+            setvalues();
+            so->session->changed = true;
+        }
+        return OK;
+    }
+};
+
+
+/* 
+ * opcode: oplinstrument
+ * switch to instrument control mode (rather than bank), specify parameters
+ * and get operator handles
+ */
+struct oplinstrument : csnd::Plugin<4, 9> {
+    static constexpr char const *otypes = "iiii";
+    static constexpr char const *itypes = "ikkkkkkkk";
+    
+    ADLSession* session;
+    ADL_Instrument* instrument;
+    ADL_Bank* bank;
+    ADLSessionOperator* sessionOperators[4];
+    MYFLT* lastval;
+    int argnum;
+    
+    int init() {
+        argnum = 9;
+        session = getHandle<ADLSession>(csound, inargs[0]);
+        if (session == NULL) return csound->init_error(badHandle);
+        int status;
+        instrument = (ADL_Instrument*) csound->malloc(sizeof(ADL_Instrument));
+        bank = (ADL_Bank*) csound->malloc(sizeof(ADL_Bank));
+                
+        ADL_BankId bnk;
+        bnk.percussive = 0;
+        bnk.msb = 0;
+        bnk.lsb = 0;
+        
+        status = adl_getBank(session->device, &bnk, 1, bank); // 1 is create
+        if (status != 0) return csound->init_error(adl_errorInfo(session->device));
+        
+        status = adl_getInstrument(session->device, bank, 0, instrument);
+        if (status != 0) return csound->init_error(adl_errorInfo(session->device));
+        
+        for (int i = 0; i < 4; i++) {
+            outargs[i] = createHandle<ADLSessionOperator>(csound, &sessionOperators[i]);
+            sessionOperators[i]->op = &(instrument->operators[i]);
+            sessionOperators[i]->session = session;
+        }
+        
+        lastval = (MYFLT*) csound->malloc(sizeof(MYFLT) * argnum);
+        setvalues();
+        
+        return OK;
+    }
+    
+    void setvalues() {
+        
+        // mode 1-2, 0 to 1 (FM, AM)
+        instrument->fb_conn1_C0 = bitconvert(0, 1, instrument->fb_conn1_C0, inargs[1]);
+        
+        // mode 3-4, 0 to 1 (FM, AM)
+        instrument->fb_conn2_C0 = bitconvert(0, 1, instrument->fb_conn2_C0, inargs[2]);
+        
+        // feedback 1-2, 0 to 7
+        instrument->fb_conn1_C0 = bitconvert(1, 3, instrument->fb_conn1_C0, inargs[3]);
+        
+        // feedback 3-4, 0 to 7
+        instrument->fb_conn2_C0 = bitconvert(1, 3, instrument->fb_conn2_C0, inargs[4]);
+        
+        // 4op, 0 to 1
+        instrument->inst_flags = bitconvert(0, 1, instrument->inst_flags, inargs[5]);
+        
+        // pseudo 4op, 0 to 1
+        instrument->inst_flags = bitconvert(1, 1, instrument->inst_flags, inargs[6]);
+        
+        // deep vibrato, 0 to 1
+        adl_setHVibrato(session->device, inargs[7]);
+        
+        // deep tremolo, 0 to 1
+        adl_setHTremolo(session->device, inargs[8]);
+    }
+    
+    bool haschanged() { // TODO really saves any overhead??
+        bool changed = false;
+        for (int i = 1; i < argnum ; i++) {
+            if (inargs[i] != lastval[i]) {
+                lastval[i] = inargs[i];
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    
+    int kperf() {
+        bool changed = session->changed;
+        if (haschanged()) {
+            setvalues();
+            changed = true;
+        }
+        if (changed) { 
+            adl_setInstrument(session->device, bank, 0, instrument);
+            session->changed = false;
+        }
+        return OK;
+    }
+};
+
+
+#include <modload.h>
+void csnd::on_load(csnd::Csound *csound) {
+    csnd::plugin<opl>(csound, "opl", csnd::thread::ia);
+    csnd::plugin<oplsetbank>(csound, "oplsetbank", csnd::thread::i);
+    csnd::plugin<oplpatchchange>(csound, "oplpatchchange", csnd::thread::ik);
+    csnd::plugin<oplpitchbend>(csound, "oplpitchbend", csnd::thread::ik);
+    csnd::plugin<oplinstrument>(csound, "oplinstrument", csnd::thread::ik);
+    csnd::plugin<oploperator>(csound, "oploperator", csnd::thread::ik);
+    csnd::plugin<oplaftertouch>(csound, "oplaftertouch", csnd::thread::ik);
+    csnd::plugin<oplcontrolchange>(csound, "oplcontrolchange", csnd::thread::ik);
+    csnd::plugin<oplnote>(csound, "oplnote", csnd::thread::i);
+    csnd::plugin<oplpanic>(csound, "oplpanic", csnd::thread::i);
+    csnd::plugin<oplbanknames>(csound, "oplbanknames", csnd::thread::i);
+}
+
+