/* Copyright 2016-2021 Arisotura This file is part of melonDS. melonDS 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 3 of the License, or (at your option) any later version. melonDS 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 melonDS. If not, see http://www.gnu.org/licenses/. */ #ifndef FRONTENDUTIL_H #define FRONTENDUTIL_H #include "types.h" #include namespace Frontend { enum { ROMSlot_NDS = 0, ROMSlot_GBA, ROMSlot_MAX }; enum { Load_OK = 0, Load_BIOS9Missing, Load_BIOS9Bad, Load_BIOS7Missing, Load_BIOS7Bad, Load_FirmwareMissing, Load_FirmwareBad, Load_FirmwareNotBootable, Load_DSiBIOS9Missing, Load_DSiBIOS9Bad, Load_DSiBIOS7Missing, Load_DSiBIOS7Bad, Load_DSiNANDMissing, Load_DSiNANDBad, // TODO: more precise errors for ROM loading Load_ROMLoadError, }; extern char ROMPath [ROMSlot_MAX][1024]; extern char SRAMPath[ROMSlot_MAX][1024]; extern bool SavestateLoaded; // Stores type of nds rom i.e. nds/srl/dsi. Should be updated everytime an NDS rom is loaded from an archive extern char NDSROMExtension[4]; // initialize the ROM handling utility void Init_ROM(); // deinitialize the ROM handling utility void DeInit_ROM(); // load the BIOS/firmware and boot from it int LoadBIOS(); // load a ROM file to the specified cart slot // note: loading a ROM to the NDS slot resets emulation int LoadROM(const char* file, int slot); int LoadROM(const u8 *romdata, u32 romlength, const char *archivefilename, const char *romfilename, const char *sramfilename, int slot); // unload the ROM loaded in the specified cart slot // simulating ejection of the cartridge void UnloadROM(int slot); void ROMIcon(u8 (&data)[512], u16 (&palette)[16], u32* iconRef); void AnimatedROMIcon(u8 (&data)[8][512], u16 (&palette)[8][16], u16 (&sequence)[64], u32 (&animatedTexRef)[32 * 32 * 64], std::vector &animatedSequenceRef); // reset execution of the current ROM int Reset(); // get the filename associated with the given savestate slot (1-8) void GetSavestateName(int slot, char* filename, int len); // determine whether the given savestate slot does contain a savestate bool SavestateExists(int slot); // load the given savestate file // if successful, emulation will continue from the savestate's point bool LoadState(const char* filename); // save the current emulator state to the given file bool SaveState(const char* filename); // undo the latest savestate load void UndoStateLoad(); // imports savedata from an external file. Returns the difference between the filesize and the SRAM size int ImportSRAM(const char* filename); // enable or disable cheats void EnableCheats(bool enable); // setup the display layout based on the provided display size and parameters // * screenWidth/screenHeight: size of the host display // * screenLayout: how the DS screens are laid out // 0 = natural (top screen above bottom screen always) // 1 = vertical // 2 = horizontal // 3 = hybrid // * rotation: angle at which the DS screens are presented: 0/1/2/3 = 0/90/180/270 // * sizing: how the display size is shared between the two screens // 0 = even (both screens get same size) // 1 = emphasize top screen (make top screen as big as possible, fit bottom screen in remaining space) // 2 = emphasize bottom screen // 4 = top only // 5 = bottom only // * screenGap: size of the gap between the two screens // * integerScale: force screens to be scaled up at integer scaling factors // * screenSwap: whether to swap the position of both screens // * topAspect/botAspect: ratio by which to scale the top and bottom screen respectively void SetupScreenLayout(int screenWidth, int screenHeight, int screenLayout, int rotation, int sizing, int screenGap, bool integerScale, bool swapScreens, float topAspect, float botAspect); const int MaxScreenTransforms = 3; // get a 2x3 transform matrix for each screen and whether it's a top or bottom screen // note: the transform assumes an origin point at the top left of the display, // X going right and Y going down // for each screen the source coordinates should be (0,0) and (256,192) // 'out' should point to an array of 6*MaxScreenTransforms floats // 'kind' should point to an array of MaxScreenTransforms ints // (0 = indicates top screen, 1 = bottom screen) // returns the amount of screens int GetScreenTransforms(float* out, int* kind); // de-transform the provided host display coordinates to get coordinates // on the bottom screen bool GetTouchCoords(int& x, int& y, bool clamp); // initialize the audio utility void Init_Audio(int outputfreq); // get how many samples to read from the core audio output // based on how many are needed by the frontend (outlen in samples) int AudioOut_GetNumSamples(int outlen); // resample audio from the core audio output to match the frontend's // output frequency, and apply specified volume // note: this assumes the output buffer is interleaved stereo void AudioOut_Resample(s16* inbuf, int inlen, s16* outbuf, int outlen, int volume); // feed silence to the microphone input void Mic_FeedSilence(); // feed random noise to the microphone input void Mic_FeedNoise(); // feed an external buffer to the microphone input // buffer should be mono void Mic_FeedExternalBuffer(); void Mic_SetExternalBuffer(s16* buffer, u32 len); } #endif // FRONTENDUTIL_H