JSIDPlay2UtilitiesTeaVM.java

package client.teavm;

import client.teavm.common.ExportedUtilitiesApi;
import client.teavm.common.IExportedUtilities;
import client.teavm.common.config.FilterSectionTeaVM;
import libsidplay.common.Emulation;
import org.teavm.jso.JSExport;

/**
 * Utility entry point for the TeaVM-based implementation of JSIDPlay2, designed to generate standalone JavaScript code
 * for auxiliary functions.
 *
 * <p>
 * This class is separated from the main emulator build to provide functionality that is independent of the SID
 * emulation engine. This allows the front-end to perform tasks, such as calculating and drawing filter curves, without
 * the overhead of the full emulator.
 * </p>
 *
 * <h2>Exported API</h2>
 * <ul>
 * <li><b>Filter Curves:</b> {@link #js2filterCurve} calculates the frequency
 * response of SID filters based on various emulation parameters.</li>
 * </ul>
 */
public class JSIDPlay2UtilitiesTeaVM {

    private static IExportedUtilities jsidplay2Utilities;

    //
    // Exports to JavaScript
    //

    public static void main(String[] args) {
        jsidplay2Utilities = new ExportedUtilitiesApi(args);
    }

    @JSExport
    public static String js2stereoCompanion(String name, String[] siblings) {
        return libsidplay.sidtune.CompanionFiles.findStereoCompanion(name, siblings);
    }

    @JSExport
    public static double[] js2filterCurve(String emulation, String name, float filter6581CurvePosition,
                                          float voiceNonLinearity, float steepness, float resonanceFactor, float offset, float nonLinearity,
                                          float minFetResistance, float k, float filter8580CurvePosition, float baseResistance, float b,
                                          float attenuation) {
        return jsidplay2Utilities.filterCurve(Emulation.valueOf(emulation),
                new FilterSectionTeaVM(name, filter6581CurvePosition, voiceNonLinearity, steepness, resonanceFactor,
                        offset, nonLinearity, minFetResistance, k, filter8580CurvePosition, baseResistance, b,
                        attenuation));
    }

    @JSExport
    public static double[] js2circuitFilterCurve(String model, float curve, float range, float capacitance) {
        return jsidplay2Utilities.filterCurve(Emulation.RESIDFP_CIRCUIT,
                new FilterSectionTeaVM().withCircuit(model, curve, range, capacitance));
    }
}