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));
}
}