Merge branch 'master' into feature/esfm

.github/workflows/build.yml

@@ -22,8 +22,8 @@ jobs:
           - { name: 'Windows MSVC x86_64', os: windows-latest, compiler: msvc, arch: x86_64 }
           #- { name: 'Windows MinGW x86', os: ubuntu-20.04, compiler: mingw, arch: x86 }
           #- { name: 'Windows MinGW x86_64', os: ubuntu-20.04, compiler: mingw, arch: x86_64 }
-          - { name: 'macOS x86_64', os: macos-latest, arch: x86_64 }
-          - { name: 'macOS ARM', os: macos-latest, arch: arm64 }
+          #- { name: 'macOS x86_64', os: macos-latest, arch: x86_64 }
+          #- { name: 'macOS ARM', os: macos-latest, arch: arm64 }
           - { name: 'Linux x86_64', os: ubuntu-20.04, arch: x86_64 }
           #- { name: 'Linux ARM', os: ubuntu-18.04, arch: armhf }
       fail-fast: false

CMakeLists.txt

@@ -143,7 +143,7 @@ if (WIN32)
   endif()
 endif()
 
-list(APPEND DEPENDENCIES_INCLUDE_DIRS "extern/SAASound/include")
+#list(APPEND DEPENDENCIES_INCLUDE_DIRS "extern/SAASound/include")
 list(APPEND DEPENDENCIES_INCLUDE_DIRS "extern/vgsound_emu-modified")
 
 find_package(Threads REQUIRED)
@@ -489,6 +489,9 @@ extern/Nuked-PSG/ympsg.c
 extern/opm/opm.c
 extern/Nuked-OPLL/opll.c
 extern/opl/opl3.c
+extern/YM3812-LLE/fmopl2.c
+extern/YMF262-LLE/fmopl3.c
+extern/YMF276-LLE/fmopn2.c
 extern/ESFMu/esfm.c
 extern/ESFMu/esfm_registers.c
 
@@ -558,9 +561,11 @@ src/engine/platform/sound/tia/AudioChannel.cpp
 src/engine/platform/sound/tia/Audio.cpp
 
 src/engine/platform/sound/ymfm/ymfm_adpcm.cpp
+src/engine/platform/sound/ymfm/ymfm_opl.cpp
 src/engine/platform/sound/ymfm/ymfm_opm.cpp
 src/engine/platform/sound/ymfm/ymfm_opn.cpp
 src/engine/platform/sound/ymfm/ymfm_opz.cpp
+src/engine/platform/sound/ymfm/ymfm_pcm.cpp
 src/engine/platform/sound/ymfm/ymfm_ssg.cpp
 
 src/engine/platform/sound/lynx/Mikey.cpp
@@ -1075,6 +1080,7 @@ if (NOT ANDROID OR TERMUX)
     set(CPACK_BUNDLE_PLIST ${CMAKE_SOURCE_DIR}/res/Info.plist)
     set(CPACK_BUNDLE_ICON ${CMAKE_SOURCE_DIR}/res/icon.icns)
     set(CPACK_BUNDLE_STARTUP_COMMAND "furnace")
+    set(CPACK_BUNDLE_APPLE_CERT_APP "-")
   endif()
   
   include(CPack)

CONTRIBUTING.md

@@ -35,6 +35,7 @@ the coding style is described here:
   - preprocessor directives not intended
   - if macro comprises more than one line, indent
   - no new line after `template<>`
+- do not use `_t` types, except for 64-bit integers and `size_t`.
 - prefer built-in types:
   - `bool`
   - `signed char` or `unsigned char` are 8-bit
@@ -48,6 +49,7 @@ the coding style is described here:
   - `long long int` or `unsigned long long int` are 64-bit
     - avoid using 64-bit numbers as I still build for 32-bit systems.
     - two `long`s are required to make Windows happy.
+    - prefer using `int64_t` or `uint64_t` for this specific case.
   - `size_t` are 32-bit or 64-bit, depending on architecture.
 - in float/double operations, always use decimal and `f` if single-precision.
   - e.g. `1.0f` or `1.0` instead of `1`.

TODO.md

@@ -4,11 +4,9 @@
 
 # THE REAL TO-DO LIST
 
-- Song is silent after playing an order after loop point
-- Select loaded instrument on open - rewrite because I want a setting...
 - finish auto-clone
 
-once you have done all of this (maybe not the first one) and merged the two or so pending pull requests, release 0.6.1
+once you have done all of this (maybe not the first one), release 0.6.1
 
 Furnace is like alcohol...
 

doc/1-intro/concepts.md

@@ -23,7 +23,7 @@ the **order list** is a smaller spreadsheet showing the overall song structure.
 - patterns may be used multiple times in the order list. changing a pattern's data in one order will affect the same pattern used in other orders.
 - each pattern is made of the same number of rows as seen in the tracker view.
 - during playback, the **playhead** moves down as described previously. when it reaches the end of the pattern view, it will go to the next order.
-- if the last order is reached and the playhear reaches the end of the pattern view, it will go back to the beginning of the song.
+- if the last order is reached and the playhead reaches the end of the pattern view, it will go back to the beginning of the song.
 
 ## time
 

doc/2-interface/menu-bar.md

@@ -35,6 +35,7 @@ items in _italic_ don't appear in basic mode and are only available in advanced
 
 - **export audio...**: opens the file picker, allowing you to export your song to a .wav file. see next section for more details.
 - **export VGM...**: opens the file picker, allowing you to export your song to a .vgm file. see next section for more details.
+- **export text...**: opens the file picker, allowing you to export your song to a .txt file.
 - **export ZSM...**: opens the file picker, allowing you to export your song to a .zsm file. see next section for more details.
   - only available when there's a YM2151 and/or VERA.
 - **export command stream...**: export song data to a command stream file. see next section for more details.
@@ -140,6 +141,7 @@ it's not really useful, unless you're a developer and want to use a command stre
 - **cut**: moves the current selection in the pattern view to clipboard.
 - **copy**: copies the current selection in the pattern view to clipboard.
 - **paste**: inserts the clipboard's contents in the cursor position.
+  - you may be able to paste from OpenMPT as well.
 - _**paste special...**:_ variants of the paste feature.
   - **paste mix**: inserts the clipboard's contents in the cursor position, but does not erase the occupied region.
   - **paste mix (background)**: does the same thing as paste mix, but doesn't alter content which is already there.

doc/2-interface/settings.md

@@ -305,6 +305,12 @@ below all the binds, select a key from the dropdown list to add it. it will appe
   - **Yes**
   - **Inverted**
 
+### Assets
+
+- **Display instrument type menu when adding instrument**
+  - if turned off, the menu can still be opened by right-clicking the add button.
+- **Select asset after opening one**
+
 ## Appearance
 
 ### Scaling
@@ -435,8 +441,6 @@ below all the binds, select a key from the dropdown list to add it. it will appe
   - **Graphical icons**
   - **Letter icons**
 - **Colorize instrument editor using instrument type**
-- **Display instrument type menu when adding instrument**
-  - if turned off, the menu can still be opened by right-clicking the add button.
 
 ### Macro Editor
 

doc/4-instrument/README.md

@@ -126,14 +126,25 @@ finally, the sequence of values can be directly edited in the text box at the bo
 - in arpeggio macros, a value starting with a `@` is a fixed value as described above.
 - in bitmask-style macros, the values are added up in binary and converted to decimal. see [the hexadecimal guide](../1-intro/hex.md) for more info.
 
-
+in all cases except bitmask macros, right-clicking on the graph opens up an editing menu:
+- **copy**: copies the macro.
+- **paste**: pastes the macro in the clipboard.
+- **clear**: clears the macro.
+- **clear contents**: resets all values to 0.
+- **offset**:
+  - **X**: slides the data "horizontally" within the macro, filling the gap with zeroes. data moved past the start or end is lost.
+  - **Y**: increases or decreases all values, clipping them if they would move past the allowed range.
+- **scale**:
+  - **X**: stretches the macro.
+  - **Y**: multiplies all values by the scale factor, clipping them if they would exceed the allowed range.
+- **randomize**: replaces all values with random values between **Min** and **Max**.
 
 ### ADSR
 
 ![ADSR macro editor](macro-ADSR.png)
 
 - **Bottom** and **Top** determine the range of outputs generated by the macro. (Bottom can be larger than Top to invert the envelope!) All outputs will be between these two values.
-- attack, Decay, Sustain, SusDecay, and Release accept inputs between 0 to 255. these are scaled to the distance between Bottom and Top.
+- Attack, Decay, Sustain, SusDecay, and Release accept inputs between 0 to 255. these are scaled to the distance between Bottom and Top.
 - **Attack** is how much the value moves toward Top with each tick.
 - **Hold** sets how many ticks to stay at Top before Decay.
 - **Decay** is how much the value moves to the Sustain level.

doc/6-sample/README.md

@@ -154,6 +154,9 @@ in there, you can modify certain data pertaining to your sample, such as the:
   - **Low-pass**: amount to attenuate everything above cutoff.
   - **Band-pass**: amount to attenuate everything outside cutoff.
   - **High-pass**: amount to attenuate everything below cutoff.
+- **Crossfade loop points**: applies a "fade" between the loop's starting point and the end.
+  - **Number of samples**: how many samples in the loop region to take into account for crossfade.
+  - **Linear <-> Equal power**: the curve used to crossfade.
 - **Preview sample**: plays sample at base frequency.
 - **Stop sample preview**: stops preview.
 - **Create instrument from sample**: creates a new instrument with its sample set to the current sample.

doc/7-systems/opl.md

@@ -82,3 +82,5 @@ afterwards everyone moved to Windows and software mixed PCM streaming...
 ## info
 
 this chip uses the [FM (OPL)](../4-instrument/fm-opl.md) instrument editor.
+
+when two channels are joined for 4-op mode, the channel bar will show `4OP` on a bracket tying them together.

doc/7-systems/pokey.md

@@ -39,3 +39,7 @@ a sound and input chip developed by Atari for their 8-bit computers (Atari 400,
 ## info
 
 this chip uses the [POKEY](../4-instrument/pokey.md) instrument editor.
+
+when two channels are joined for filtered output, the channel bar will show `filter` on a bracket tying them together.
+
+when two channels are joined for wide period range, the channel bar will show `16-bit` on a bracket tying them together.

doc/7-systems/snes.md

@@ -65,6 +65,8 @@ Furnace also allows the SNES to use wavetables (and the wavetable synthesizer) i
 
 this chip uses the [SNES](../4-instrument/snes.md) instrument editor.
 
+when two channels are joined for pitch modulation, the channel bar will show `mod` on a bracket tying them together.
+
 ## channel status
 
 the following icons are displayed when channel status is enabled in the pattern view:

doc/8-advanced/chanosc.md

@@ -1,6 +1,6 @@
 # oscilloscope (per-channel)
 
-the "Oscilloscope (per-channel)" windows displays several oscilloscope views (one per channel).
+the "Oscilloscope (per-channel)" window displays several oscilloscope views (one per channel).
 
 ![oscilloscope per-channel configuration view](chanosc.png)
 

doc/9-guides/README.md

@@ -1,7 +1,8 @@
 # guides
 
-this is collection of user-contributed Furnace guides which may be useful during composition.
+this is a collection of user-contributed Furnace guides which may be useful during composition.
 
+- [tuning samples](tuning-samples.md)
 - [using samples with limited playback rates](limited-samples.md)
 - [choosing emulation cores](emulation-cores.md)
 - [using OPLL patch macro](opllswitching.md)

doc/9-guides/emulation-cores.md

@@ -2,11 +2,11 @@
 
 Furnace achieves the authentic sound of videogame hardware by emulating sound chips as accurately as possible, using **emulator cores**. in some cases there are multiple cores to choose from, each with different strengths and weaknesses. here are the major differences between them all.
 
-- **Arcade/YM2151 core**:
+- **YM2151 core**:
   - **ymfm**: default playback core. much less CPU usage than Nuked-OPM, but less accurate. recommended for users with last-gen or earlier hardware.
   - **Nuked-OPM**: default render core. much more accurate than ymfm, due to the emulator being based on an image of the die map taken from a real YM2151. very CPU heavy, only recommended for users with recent hardware.
 
-- **Genesis/YM2612 core**:
+- **YM2612 core**:
   - **Nuked-OPN2**: default core. a little lighter on the CPU than Nuked-OPM.
   - **ymfm**: same as ymfm above.
 
@@ -34,3 +34,16 @@ Furnace achieves the authentic sound of videogame hardware by emulating sound ch
 - **OPN/OPNA/OPNB cores**:
   - **ymfm only**: lower CPU usage, less accurate FM.
   - **Nuked-OPN2 (FM) + ymfm (SSG/ADPCM)**: default cores. more accurate FM at the cost of more CPU load.
+
+- **OPL/OPL2/Y8950 core**:
+  - **Nuked-OPL3**: high quality OPL emulation core. slightly off due to tiny differences between OPL and OPL3, but otherwise it is good.
+  - **ymfm**: this core is supposed to use less CPU than Nuked-OPL3, but for some reason it actually doesn't.
+  - **YM3812-LLE**: a new core written by the author of the Nuked cores. it features extremely accurate emulation.
+    - this core uses a *lot* of CPU time. may not be suitable for playback!
+
+- **OPL3 core**:
+  - **Nuked-OPL3**: high quality OPL emulation core.
+  - **ymfm**: this core is supposed to use less CPU than Nuked-OPL3, but for some reason it actually doesn't.
+  - **YMF262-LLE**: a new core written by the author of the Nuked cores. it features extremely accurate emulation.
+    - this core uses even more CPU than YM3812-LLE. not suitable for playback or even rendering if you're impatient!
+

doc/9-guides/tuning-samples.md

@@ -0,0 +1,16 @@
+# tuning samples
+
+loading a new sample into Furnace is easy... but getting it transposed and tuned to match the song can be tricky at first.
+
+it's important to remember that the "Hz" and "Note" as shown in the sample editor are unrelated to the note heard in the sample itself. a sample shown as having a "Note" of C-4 will use a sample rate of 4181, even though it may contain a note played at a different pitch than C.
+
+for this example, we'll use a sample of a note played at E and recorded at 22050Hz.
+
+- if needed, use the "Create instrument from sample" button to make an instrument to use in the track.
+- calculate the semitone difference in Hz between the note your recorded sample is playing and C. in this example, the nearest C is 4 semitones down from E.
+- set "Note" to 4 semitones lower than it shows. in this case, it starts at `F-6`, so set it to `C#6`.
+	- or, use a pitch calculator like https://www.omnicalculator.com/other/semitone. input Frequency 1 as 22050Hz, input -4 semitones, and receive a Frequency 2 of 17501.10Hz. enter that value into "Hz".
+- now, using the "Preview sample" button should play the note at C. entering an E in the pattern will now play it at or near E.
+- if the sample still sounds out of tune, adjust "Hz" or "Fine" to bring it in line.
+
+if notes seem "capped" – for example, playing anything over D-6 sounds like a D-6 – those notes exceed the maximum sample playback rate for the chip. the only solution is to use "Resample" to change the sample to a lower rate.

doc/README.md

@@ -23,7 +23,6 @@ the index follows.
 - freq-mod
 - host12prog
 - Lunathir
-- nicco1690
 - tildearrow
 
 ## information

extern/YM3812-LLE/LICENSE

@@ -0,0 +1,339 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, 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.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, 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 or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+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 give any other recipients of the Program a copy of this License
+along with the Program.
+
+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.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, 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) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+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 Program, 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 Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) 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; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, 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 executable.  However, as a
+special exception, the source code 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.
+
+If distribution of executable or 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 counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program 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.
+
+  5. 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 Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program 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 to
+this License.
+
+  7. 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 Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program 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 Program.
+
+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.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program 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.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the 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 Program
+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 Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, 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
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "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 PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. 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 PROGRAM 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 PROGRAM (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 PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  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 program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 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 General Public License for more details.
+
+    You should have received a copy of the GNU 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.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

extern/YM3812-LLE/Readme.md

@@ -0,0 +1,13 @@
+# YM3812-LLE
+
+Yamaha YM3812 (OPL2) emulator using YM3812 die shot.
+
+Special thanks to Travis Goodspeed for decapping YM3812.
+
+https://twitter.com/travisgoodspeed/status/1652334901230723072
+
+# MODIFICATION DISCLAIMER
+
+this is a modified version of YM3812-LLE which adds functions to allow its usage and per-chan osc.
+
+the original Git commit is 7f0c6537ccd61e9e7dbddb4e4a353e007ea69c50.

extern/YM3812-LLE/fmopl2.h

@@ -0,0 +1,276 @@
+/*
+ * Copyright (C) 2023 nukeykt
+ *
+ * This file is part of YM3812-LLE.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * 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 General Public License for more details.
+ *
+ *  YM3812 emulator
+ *  Thanks:
+ *      Travis Goodspeed:
+ *          YM3812 decap and die shot
+ *
+ */
+
+#pragma once
+
+typedef struct
+{
+    int mclk;
+    int address;
+    int data_i;
+    int ic;
+    int cs;
+    int rd;
+    int wr;
+} fmopl2_input_t;
+
+typedef struct
+{
+    fmopl2_input_t input;
+
+    int mclk1;
+    int mclk2;
+    int clk1;
+    int clk2;
+
+    int prescaler_reset_l[2];
+    int prescaler_cnt[2];
+    int prescaler_l1[2];
+    int prescaler_l2[2];
+
+    int reset1;
+
+    int fsm_reset_l[2];
+    int fsm_reset; // wire
+    int fsm_cnt1[2];
+    int fsm_cnt2[2];
+    int fsm_cnt1_of; // wire
+    int fsm_cnt2_of; // wire
+    int fsm_sel[13];
+    int fsm_cnt; // wire
+    int fsm_ch_out;
+    int fsm_do_fb;
+    int fsm_load_fb;
+    int fsm_l1[2];
+    int fsm_l2[2];
+    int fsm_l3[2];
+    int fsm_l4[2];
+    int fsm_l5[2];
+    int fsm_l6[2];
+    int fsm_out[16];
+
+    int io_rd;
+    int io_wr;
+    int io_cs;
+    int io_a0;
+
+    int io_read0;
+    int io_read1;
+    int io_write;
+    int io_write0;
+    int io_write1;
+    int io_dir;
+    int io_data;
+
+    int data_latch;
+
+    int write0;
+    int write0_sr;
+    int write0_latch[6];
+    int write1;
+    int write1_sr;
+    int write1_latch[6];
+
+    int reg_sel1;
+    int reg_sel2;
+    int reg_sel3;
+    int reg_sel4;
+    int reg_sel8;
+    int reg_selbd;
+    int reg_test;
+    int reg_timer1;
+    int reg_timer2;
+    int reg_notesel;
+    int reg_csm;
+    int reg_da;
+    int reg_dv;
+    int rhythm;
+    int reg_rh_kon;
+    int reg_sel4_wr; // wire
+    int reg_sel4_rst; // wire
+    int reg_t1_mask;
+    int reg_t2_mask;
+    int reg_t1_start;
+    int reg_t2_start;
+    int reg_mode_b3;
+    int reg_mode_b4;
+
+    int t1_cnt[2];
+    int t2_cnt[2];
+    int t1_of[2];
+    int t2_of[2];
+    int t1_status;
+    int t2_status;
+    int unk_status1;
+    int unk_status2;
+    int timer_st_load_l;
+    int timer_st_load;
+    int t1_start;
+    int t1_start_l[2];
+    int t2_start_l[2];
+    int t1_load; // wire
+    int csm_load_l;
+    int csm_load;
+    int csm_kon;
+    int rh_sel0;
+    int rh_sel[2];
+
+    int keyon_comb;
+    int address;
+    int address_valid;
+    int address_valid_l[2];
+    int address_valid2;
+    int data;
+    int slot_cnt1[2];
+    int slot_cnt2[2];
+    int slot_cnt;
+    int sel_ch;
+
+    int ch_fnum[10][2];
+    int ch_block[3][2];
+    int ch_keyon[2];
+    int ch_connect[2];
+    int ch_fb[3][2];
+    int op_multi[4][2];
+    int op_ksr[2];
+    int op_egt[2];
+    int op_vib[2];
+    int op_am[2];
+    int op_tl[6][2];
+    int op_ksl[2][2];
+    int op_ar[4][2];
+    int op_dr[4][2];
+    int op_sl[4][2];
+    int op_rr[4][2];
+    int op_wf[2][2];
+    int op_mod[2];
+    int op_value; // wire
+
+    int eg_load1_l;
+    int eg_load1;
+    int eg_load2_l;
+    int eg_load2;
+    int eg_load3_l;
+    int eg_load3;
+
+    int trem_carry[2];
+    int trem_value[2];
+    int trem_dir[2];
+    int trem_step;
+    int trem_out;
+    int trem_of[2];
+
+    int eg_timer[2];
+    int eg_timer_masked[2];
+    int eg_carry[2];
+    int eg_mask[2];
+    int eg_subcnt[2];
+    int eg_subcnt_l[2];
+    int eg_sync_l[2];
+    int eg_timer_low;
+    int eg_shift;
+    int eg_state[2][2];
+    int eg_level[9][2];
+    int eg_out[2];
+    int eg_dokon; // wire
+    int eg_mute[2];
+
+    int block;
+    int fnum;
+    int keyon;
+    int connect;
+    int connect_l[2];
+    int fb;
+    int fb_l[2][2];
+    int multi;
+    int ksr;
+    int egt;
+    int vib;
+    int am;
+    int tl;
+    int ksl;
+    int ar;
+    int dr;
+    int sl;
+    int rr;
+    int wf;
+
+    int lfo_cnt[2];
+    int t1_step; // wire
+    int t2_step; // wire
+    int am_step; // wire
+    int vib_step; // wire
+    int vib_cnt[2];
+    int pg_phase[19][2];
+    int dbg_serial[2];
+
+    int noise_lfsr[2];
+
+    int hh_load;
+    int tc_load;
+    int hh_bit2;
+    int hh_bit3;
+    int hh_bit7;
+    int hh_bit8;
+    int tc_bit3;
+    int tc_bit5;
+    int op_logsin[2];
+    int op_shift[2];
+    int op_pow[2];
+    int op_mute[2];
+    int op_sign[2];
+    int op_fb[2][13][2];
+
+    int pg_out; // wire
+    int pg_out_rhy; // wire
+
+    int accm_value[2];
+    int accm_shifter[2];
+    int accm_load1_l;
+    int accm_load1;
+    int accm_clamplow;
+    int accm_clamphigh;
+    int accm_top;
+    int accm_sel[2];
+    int accm_mo[2];
+
+    int o_sh;
+    int o_mo;
+    int o_irq_pull;
+    int o_sy;
+
+    int data_o;
+    int data_z;
+
+    int o_clk1;
+    int o_clk2;
+    int o_reset1;
+    int o_write0;
+    int o_write1;
+    int o_data_latch;
+
+    int op_value_debug;
+
+} fmopl2_t;
+
+// modification
+void FMOPL2_Clock(fmopl2_t *chip);

extern/YMF262-LLE/LICENSE

@@ -0,0 +1,339 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, 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.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, 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 or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+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 give any other recipients of the Program a copy of this License
+along with the Program.
+
+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.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, 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) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+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 Program, 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 Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) 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; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, 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 executable.  However, as a
+special exception, the source code 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.
+
+If distribution of executable or 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 counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program 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.
+
+  5. 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 Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program 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 to
+this License.
+
+  7. 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 Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program 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 Program.
+
+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.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program 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.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the 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 Program
+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 Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, 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
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "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 PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. 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 PROGRAM 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 PROGRAM (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 PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  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 program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 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 General Public License for more details.
+
+    You should have received a copy of the GNU 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.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

extern/YMF262-LLE/Readme.md

@@ -0,0 +1,14 @@
+# YMF262-LLE
+
+Yamaha YMF262 (OPL3) emulator using YMF262 die shot.
+
+Special thanks to John McMaster for decapping YMF262.
+
+https://siliconpr0n.org/map/yamaha/ymf262-m/
+
+# MODIFICATION DISCLAIMER
+
+this is a modified version of YMF262-LLE which adds functions to allow its usage and per-chan osc.
+it also brings in a small optimization.
+
+the original Git commit is 63406354d05bc860a6762377ddbb9e2609bd6c36.

extern/YMF262-LLE/fmopl3.h

@@ -0,0 +1,335 @@
+/*
+ * Copyright (C) 2023 nukeykt
+ *
+ * This file is part of YMF262-LLE.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * 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 General Public License for more details.
+ *
+ *  YMF262 emulator
+ *  Thanks:
+ *      John McMaster (siliconpr0n.org):
+ *          YMF262 decap and die shot
+ *
+ */
+
+#pragma once
+
+#include <stdint.h>
+
+typedef struct
+{
+    int mclk;
+    int address;
+    int data_i;
+    int ic;
+    int cs;
+    int rd;
+    int wr;
+} fmopl3_input_t;
+
+typedef struct
+{
+    fmopl3_input_t input;
+
+    int mclk1;
+    int mclk2;
+    int aclk1;
+    int aclk2;
+    int clk1;
+    int clk2;
+    int rclk1;
+    int rclk2;
+
+    int o_clk1;
+    int o_clk2;
+    int o_rclk1;
+    int o_rclk2;
+    int o_wrcheck;
+    int o_data_latch;
+    int o_bank_latch;
+    int o_reset0;
+    int o_ra_w1_l1;
+
+    int prescaler1_reset[2];
+    int prescaler1_cnt[2];
+
+    int prescaler2_reset_l[2];
+    int prescaler2_cnt[2];
+    int prescaler2_reset;
+    int prescaler2_l1[2];
+    int prescaler2_l2;
+    int prescaler2_l3[2];
+    int prescaler2_l4;
+    int prescaler2_l5[2];
+    int prescaler2_l6[2];
+    int prescaler2_l7;
+
+    int fsm_cnt1[2];
+    int fsm_cnt2[2];
+    int fsm_cnt3[2];
+    int fsm_cnt;
+
+    int fsm_reset_l[2];
+    int fsm_out[17];
+    int fsm_l1[2];
+    int fsm_l2[2];
+    int fsm_l3[2];
+    int fsm_l4[2];
+    int fsm_l5[2];
+    int fsm_l6[2];
+    int fsm_l7[2];
+    int fsm_l8[2];
+    int fsm_l9[2];
+    int fsm_l10[2];
+
+    int ic_latch[2];
+
+    int io_rd;
+    int io_wr;
+    int io_cs;
+    int io_a0;
+    int io_a1;
+
+    int io_read;
+    int io_write;
+    int io_write0;
+    int io_write1;
+    int io_bank;
+
+    int data_latch;
+    int bank_latch;
+    int bank_masked;
+
+    int reg_sel1;
+    int reg_sel2;
+    int reg_sel3;
+    int reg_sel4;
+    int reg_sel5;
+    int reg_sel8;
+    int reg_selbd;
+
+    int reg_test0;
+    int reg_timer1;
+    int reg_timer2;
+    int reg_notesel;
+    int rhythm;
+    int reg_rh_kon;
+    int reg_da;
+    int reg_dv;
+
+    int reg_test1;
+    int reg_new;
+    int reg_4op;
+
+    int reg_t1_mask;
+    int reg_t2_mask;
+    int reg_t1_start;
+    int reg_t2_start;
+
+    int lfo_cnt[2];
+    int vib_cnt[2];
+    int t1_step;
+    int t2_step;
+    int am_step;
+    int vib_step;
+
+    int rh_sel0;
+    int rh_sel[2];
+
+    int keyon_comb;
+
+    int ra_address_latch;
+    int ra_address_good;
+    int ra_data_latch;
+    int ra_cnt1[2];
+    int ra_cnt2[2];
+    int ra_cnt3[2];
+    int ra_cnt4[2];
+    int ra_cnt;
+    int ra_rst_l[2];
+    int ra_w1_l1;
+    int ra_w1_l2;
+    int ra_write;
+    int ra_write_a;
+
+    int ra_multi[36];
+    int ra_ksr[36];
+    int ra_egt[36];
+    int ra_am[36];
+    int ra_vib[36];
+    int ra_tl[36];
+    int ra_ksl[36];
+    int ra_ar[36];
+    int ra_dr[36];
+    int ra_sl[36];
+    int ra_rr[36];
+    int ra_wf[36];
+    int ra_fnum[18];
+    int ra_block[18];
+    int ra_keyon[18];
+    int ra_connect[18];
+    int ra_fb[18];
+    int ra_pan[18];
+    int ra_connect_pair[18];
+    int multi[2];
+    int ksr[2];
+    int egt[2];
+    int am[2];
+    int vib[2];
+    int tl[2];
+    int ksl[2];
+    int ar[2];
+    int dr[2];
+    int sl[2];
+    int rr[2];
+    int wf[2];
+    int fnum[2];
+    int block[2];
+    int keyon[2];
+    int connect[2];
+    int fb[2];
+    int pan[2];
+    int connect_pair[2];
+
+    int64_t ra_dbg1[2];
+    int ra_dbg2[2];
+    int ra_dbg_load[2];
+
+    int fb_l[2][2];
+    int pan_l[2][2];
+
+    int write0_sr;
+    int write0_l[4];
+    int write0;
+
+    int write1_sr;
+    int write1_l[4];
+    int write1;
+
+    int connect_l[2];
+    int connect_pair_l[2];
+
+    int t1_cnt[2];
+    int t2_cnt[2];
+    int t1_of[2];
+    int t2_of[2];
+    int t1_status;
+    int t2_status;
+    int timer_st_load_l;
+    int timer_st_load;
+    int t1_start;
+    int t2_start;
+    int t1_start_l[2];
+    int t2_start_l[2];
+
+    int reset0;
+    int reset1;
+
+    int pg_phase_o[4];
+    int pg_dbg[2];
+    int pg_dbg_load_l[2];
+    int noise_lfsr[2];
+    int pg_index[2];
+    int pg_cells[36];
+    int pg_out_rhy;
+
+    int trem_load_l;
+    int trem_load;
+    int trem_st_load_l;
+    int trem_st_load;
+    int trem_carry[2];
+    int trem_value[2];
+    int trem_dir[2];
+    int trem_step;
+    int trem_out;
+    int trem_of[2];
+
+    int eg_load_l1[2];
+    int eg_load_l;
+    int eg_load;
+
+    int64_t eg_timer_masked[2];
+    int eg_carry[2];
+    int eg_mask[2];
+    int eg_subcnt[2];
+    int eg_subcnt_l[2];
+    int eg_sync_l[2];
+    int eg_timer_low;
+    int eg_shift;
+    int eg_timer_dbg[2];
+
+    int eg_timer_i;
+    int eg_timer_o[4];
+    int eg_state_o[4];
+    int eg_level_o[4];
+    int eg_index[2];
+    int eg_cells[36];
+
+    int eg_out[2];
+    int eg_dbg[2];
+    int eg_dbg_load_l[2];
+
+    int hh_load;
+    int tc_load;
+    int hh_bit2;
+    int hh_bit3;
+    int hh_bit7;
+    int hh_bit8;
+    int tc_bit3;
+    int tc_bit5;
+
+    int op_logsin[2];
+    int op_saw[2];
+    int op_saw_phase[2];
+    int op_shift[2];
+    int op_pow[2];
+    int op_mute[2];
+    int op_sign[2];
+    int op_fb[4][13][2];
+    int op_mod[2];
+
+    int op_value;
+
+    int accm_a[2];
+    int accm_b[2];
+    int accm_c[2];
+    int accm_d[2];
+    int accm_shift_a[2];
+    int accm_shift_b[2];
+    int accm_shift_c[2];
+    int accm_shift_d[2];
+    int accm_load_ac_l;
+    int accm_load_ac;
+    int accm_load_bd_l;
+    int accm_load_bd;
+    int accm_a_of;
+    int accm_a_sign;
+    int accm_b_of;
+    int accm_b_sign;
+    int accm_c_of;
+    int accm_c_sign;
+    int accm_d_of;
+    int accm_d_sign;
+
+    int o_doab;
+    int o_docd;
+    int o_sy;
+    int o_smpac;
+    int o_smpbd;
+    int o_irq_pull;
+    int o_test;
+
+    int data_o;
+    int data_z;
+} fmopl3_t;
+
+// modification
+void FMOPL3_Clock(fmopl3_t *chip);

extern/YMF276-LLE/LICENSE

@@ -0,0 +1,339 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, 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.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, 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 or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+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 give any other recipients of the Program a copy of this License
+along with the Program.
+
+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.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, 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) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+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 Program, 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 Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) 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; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, 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 executable.  However, as a
+special exception, the source code 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.
+
+If distribution of executable or 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 counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program 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.
+
+  5. 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 Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program 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 to
+this License.
+
+  7. 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 Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program 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 Program.
+
+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.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program 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.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the 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 Program
+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 Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, 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
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "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 PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. 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 PROGRAM 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 PROGRAM (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 PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  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 program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 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 General Public License for more details.
+
+    You should have received a copy of the GNU 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.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

extern/YMF276-LLE/Readme.md

@@ -0,0 +1,15 @@
+# YMF276-LLE
+
+Yamaha YMF276/YM3438 (OPN2) emulator using YM3438 and YMF276 die shots.
+
+Special thanks to John McMaster for decapping YM3438 and org(ogamespec) for decapping YMF276.
+
+https://siliconpr0n.org/map/yamaha/ym3438/
+
+https://drive.google.com/drive/u/0/folders/10IOhV4wf4A6SLQkS-i1wyJnyXH5o8DKn
+
+# MODIFICATION DISCLAIMER
+
+this is a modified version of YMF276-LLE which adds functions for per-chan osc.
+
+the original Git commit is 172b3a40011d0d89528a7fc0d606cc92d94cd033.

extern/YMF276-LLE/fmopn2.h

@@ -0,0 +1,362 @@
+/*
+ * Copyright (C) 2022-2023 nukeykt
+ *
+ * This file is part of YMF276-LLE.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * 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 General Public License for more details.
+ *
+ *  YMF276/YM3438 emulator.
+ *  Thanks:
+ *      John McMaster (siliconpr0n.org):
+ *          Yamaha YM3438 & YM2610 decap and die shot.
+ *      org, andkorzh, HardWareMan (emu-russia):
+ *          help & support, YMF276 and YM2612 decap.
+ *
+ */
+
+#pragma once
+#include <stdint.h>
+
+enum {
+    fmopn2_flags_ym3438 = 1,
+};
+
+typedef struct {
+    int phi;
+    int ic;
+} fmopn2_prescaler_input_t;
+
+typedef struct {
+    int phi_phase;
+    int ic;
+    int rd;
+    int wr;
+    int cs;
+    int address;
+    int data;
+    int test;
+    int i_fsm_reset; // (chip->ic_check_latch[1] & 16) != 0;
+} fmopn2_input_t;
+
+typedef struct {
+    int flags;
+    // input
+    fmopn2_input_t input_old, input;
+    int i_phi1;
+    int i_phi2;
+
+    fmopn2_prescaler_input_t pinput, pinput_old;
+
+    // clock
+    int ic_latch[2]; // 12
+    int ic_check_latch[2]; // 4
+    int prescaler_latch[2]; // 6
+    int phi1_latch[2];
+    int phi2_latch[2];
+    int dphi1_latch[4];
+    int dphi2_latch[3];
+    int dclk1;
+    int dclk2;
+    int fsm_reset;
+
+    // output
+    int dac_val;
+    int out_l;
+    int out_r;
+
+    // io
+    int write_addr_trig;
+    int write_addr_trig_sync;
+    int write_addr_dlatch;
+    int write_addr_sr[2];
+    int write_data_trig;
+    int write_data_trig_sync;
+    int write_data_dlatch;
+    int write_data_sr[2];
+
+    int data_latch;
+    int bank_latch;
+
+    int busy_cnt[2];
+    int busy_latch[2];
+
+    int io_ic_latch[2];
+
+    int write_fm_address[2];
+    int fm_address[2];
+    int write_fm_data[2];
+    int fm_data[2];
+    int status_timer_a_dlatch;
+    int status_timer_b_dlatch;
+
+    // mode registers
+    int write_mode_21[2];
+    int write_mode_22[2];
+    int write_mode_24[2];
+    int write_mode_25[2];
+    int write_mode_26[2];
+    int write_mode_27[2];
+    int write_mode_28[2];
+    int write_mode_2a[2];
+    int write_mode_2b[2];
+    int write_mode_2c[2];
+
+    int mode_test_21[2];
+    int mode_lfo_en[2];
+    int mode_lfo_freq[2];
+    int mode_timer_a_reg[2];
+    int mode_timer_b_reg[2];
+    int mode_ch3[2];
+    int mode_timer_a_load[2];
+    int mode_timer_a_enable[2];
+    int mode_timer_a_reset[2];
+    int mode_timer_b_load[2];
+    int mode_timer_b_enable[2];
+    int mode_timer_b_reset[2];
+    int mode_kon_operator[2];
+    int mode_kon_channel[2];
+    int mode_dac_data[2];
+    int mode_dac_en[2];
+    int mode_test_2c[2];
+
+    int mode_kon[4][2];
+
+    // operator registers
+    int slot_multi[2][4][2];
+    int slot_dt[2][3][2];
+    int slot_tl[2][7][2];
+    int slot_ar[2][5][2];
+    int slot_ks[2][2][2];
+    int slot_dr[2][5][2];
+    int slot_am[2][1][2];
+    int slot_sr[2][5][2];
+    int slot_rr[2][4][2];
+    int slot_sl[2][4][2];
+    int slot_ssg_eg[2][4][2];
+    // channel registers
+    int chan_fnum[11][2];
+    int chan_fnum_ch3[11][2];
+    int chan_block[3][2];
+    int chan_block_ch3[3][2];
+    int chan_a4[2];
+    int chan_ac[2];
+    int chan_connect[3][2];
+    int chan_fb[3][2];
+    int chan_pms[3][2];
+    int chan_ams[2][2];
+    int chan_pan[2][2];
+
+    int reg_cnt1[2];
+    int reg_cnt2[2];
+
+    // lfo
+
+    int lfo_cnt1[2];
+    int lfo_cnt2[2];
+
+    int lfo_dlatch;
+    int lfo_dlatch_load;
+    int lfo_inc_latch[2];
+
+    // pg
+    int pg_fnum[2][2];
+    int pg_kcode[2][2];
+    int pg_fnum_lfo1;
+    int pg_fnum_lfo2;
+    int pg_lfo_shift;
+    int pg_lfo_sign;
+    int pg_lfo;
+    int pg_freq1;
+    int pg_freq2;
+    int pg_freq3;
+    int pg_freq4;
+    int pg_freq5[2];
+    int pg_freq6;
+    int pg_freq_m1;
+    int pg_block;
+    int pg_dt[2];
+    int pg_detune[2];
+    int pg_multi[2][2];
+    int pg_multi2;
+    int pg_inc[2];
+    int pg_inc_mask[2];
+    int pg_phase[20][2];
+    int pg_reset_latch[2];
+    int pg_debug[2];
+    int pg_reset[2];
+
+    // eg
+    int eg_prescaler[2];
+    int eg_prescaler_clock_l[2];
+    int eg_prescaler_l;
+    int eg_clock_delay[2];
+    int eg_step[2];
+    int eg_timer_load;
+    int eg_timer[2];
+    int eg_timer_carry[2];
+    int eg_timer_mask[2];
+    int eg_timer_masked[2];
+    int eg_timer_low_lock;
+    int eg_shift_lock;
+    int eg_level[10][2];
+    int eg_level_latch[2];
+    int eg_level_latch_inv;
+    int eg_state[2][2];
+    int eg_ssg_dir[2];
+    int eg_ssg_inv[2];
+    int eg_ssg_holdup[2];
+    int eg_ssg_enable[2];
+    int eg_ssg_pgreset[2];
+    int eg_ssg_pgrepeat[2];
+    int eg_key[2];
+    int eg_rate_nonzero[2];
+    int eg_rate;
+    int eg_ksv;
+    int eg_rate2;
+    int eg_inc1;
+    int eg_inc2;
+    int eg_rate12;
+    int eg_rate13;
+    int eg_rate14;
+    int eg_rate15;
+    int eg_maxrate[2];
+    int eg_incsh0;
+    int eg_incsh1;
+    int eg_incsh2;
+    int eg_incsh3;
+    int eg_incsh_nonzero[2];
+    int eg_inc_total;
+    int eg_level_ssg[2];
+    int eg_sl[2][2];
+    int eg_nextlevel[2];
+    int eg_kon_csm[2];
+    int eg_kon_latch[2];
+    int eg_tl[2][2];
+    int eg_ams;
+    int eg_lfo[2];
+    int eg_ch3_latch[2];
+    int eg_out;
+    int eg_out_tl;
+    int eg_out_total;
+    int eg_debug[2];
+
+    // op
+    int op_mod[10][2];
+    int op_phase[2];
+    int op_logsin_base[2];
+    int op_logsin_delta[2];
+    int op_logsin_add_delta[2];
+    int op_atten[2];
+    int op_env[2];
+    int op_pow_base[2];
+    int op_pow_delta[2];
+    int op_pow_add_delta[2];
+    int op_shift[2];
+    int op_sign[2];
+    int op_output[2];
+    int op_op1[2][14][2];
+    int op_op2[14][2];
+    int op_mod_sum[2];
+    int op_dofeedback[2];
+
+    // accumulator
+
+    int ch_accm[14][2];
+    int ch_out[9][2];
+    int ch_out_dlatch;
+    int ch_out_pan_dlatch;
+    int ch_dac_load;
+    int ch_out_debug[2];
+    int ch_accm_l[2];
+    int ch_accm_r[2];
+
+    // timers
+    int timer_dlatch;
+    int timer_a_cnt[2];
+    int timer_a_load_latch[2];
+    int timer_a_load_old[2];
+    int timer_a_load_dlatch;
+    int timer_a_of[2];
+    int timer_a_status[2];
+    int timer_b_subcnt[2];
+    int timer_b_subcnt_of[2];
+    int timer_b_cnt[2];
+    int timer_b_load_latch[2];
+    int timer_b_load_old[2];
+    int timer_b_load_dlatch;
+    int timer_b_of[2];
+    int timer_b_status[2];
+    int timer_csm_key_dlatch;
+
+    // fm algorithm
+    int alg_mod_op1_0;
+    int alg_mod_op1_1;
+    int alg_mod_op2;
+    int alg_mod_prev_0;
+    int alg_mod_prev_1;
+    int alg_output;
+    int alg_mod_op1_0_l;
+    int alg_mod_op1_1_l;
+    int alg_mod_op2_l;
+    int alg_mod_prev_0_l;
+    int alg_mod_prev_1_l;
+    int alg_output_l;
+
+    // fsm
+    int fsm_cnt1[2];
+    int fsm_cnt2[2];
+    // fsm table output
+    int fsm_clock_eg;
+    int fsm_clock_timers1;
+    int fsm_clock_timers;
+    int fsm_op4_sel;
+    int fsm_op1_sel;
+    int fsm_op2_sel;
+    int fsm_op3_sel;
+    int fsm_sel2;
+    int fsm_sel23;
+    int fsm_ch3_sel;
+    int fsm_dac_load;
+    int fsm_dac_out_sel;
+    int fsm_dac_ch6;
+
+    // ymf276
+    int fsm_clock_eg_l;
+    int fsm_op1_sel_l;
+    int fsm_sel1_l;
+    int fsm_sel2_l;
+    int fsm_sel23_l;
+    int fsm_ch3_sel_l;
+    int fsm_dac_load_l;
+    int fsm_dac_out_sel_l;
+    int fsm_dac_ch6_l;
+    int fsm_lro_l[2];
+    int fsm_wco_l[2];
+    int fsm_lro_l2[2];
+    int fsm_wco_l2[2];
+    int fsm_op1_sel_l2[2];
+    int fsm_op1_sel_l3[2];
+    int fsm_shifter_ctrl[2];
+    int fsm_load_l;
+    int fsm_load_r;
+
+    int dac_shifter[2];
+    int dac_so_l[2];
+    int o_bco;
+    int o_wco;
+    int o_lro;
+    int o_so;
+} fmopn2_t;
+
+
+int FMOPN2_ReadStatus(fmopn2_t *chip);
+
+void FMOPN2_Clock(fmopn2_t *chip, int phi);