mirror of
https://github.com/hrydgard/ppsspp.git
synced 2026-07-27 09:15:00 +02:00
Henrik Rydgård
80a99a67d9
These naturally come in bunches on many platforms like Android, so lay some groundwork to also handle them in bunches to minimize locking in the future. Linux buildfix
85 lines
3.6 KiB
C++
85 lines
3.6 KiB
C++
#pragma once
|
|
|
|
#include <functional>
|
|
#include <string>
|
|
|
|
// The Native App API.
|
|
//
|
|
// Implement these functions and you've got a native app. These are called
|
|
// from the framework, which exposes the native JNI api which is a bit
|
|
// more complicated.
|
|
|
|
// These are defined in Common/Input/InputState.cpp
|
|
struct TouchInput;
|
|
struct KeyInput;
|
|
struct AxisInput;
|
|
|
|
class GraphicsContext;
|
|
|
|
// The first function to get called, just write strings to the two pointers.
|
|
// This might get called multiple times in some implementations, you must be able to handle that.
|
|
void NativeGetAppInfo(std::string *app_dir_name, std::string *app_nice_name, bool *landscape, std::string *version);
|
|
|
|
// Easy way for the Java side to ask the C++ side for configuration options, such as
|
|
// the rotation lock which must be controlled from Java on Android.
|
|
// It is currently not called on non-Android platforms.
|
|
std::string NativeQueryConfig(std::string query);
|
|
|
|
// For the back button to work right, this should return true on your main or title screen.
|
|
// Otherwise, just return false.
|
|
bool NativeIsAtTopLevel();
|
|
|
|
// The very first function to be called after NativeGetAppInfo. Even NativeMix is not called
|
|
// before this, although it may be called at any point in time afterwards (on any thread!)
|
|
// This functions must NOT call OpenGL. Main thread.
|
|
void NativeInit(int argc, const char *argv[], const char *savegame_dir, const char *external_dir, const char *cache_dir);
|
|
|
|
// Runs after NativeInit() at some point. May (and probably should) call OpenGL.
|
|
// Should not initialize anything screen-size-dependent - do that in NativeResized.
|
|
bool NativeInitGraphics(GraphicsContext *graphicsContext);
|
|
|
|
// If you want to change DPI stuff (such as modifying dp_xres and dp_yres), this is the
|
|
// place to do it. You should only read g_dpi_scale and pixel_xres and pixel_yres in this,
|
|
// and only write dp_xres and dp_yres.
|
|
void NativeResized();
|
|
|
|
// Set a flag to indicate a restart. Reset after NativeInit().
|
|
void NativeSetRestarting();
|
|
|
|
// Retrieve current restarting flag.
|
|
bool NativeIsRestarting();
|
|
|
|
// Delivers touch/key/axis events "instantly", without waiting for the next frame so that NativeFrame can deliver.
|
|
// Some systems like UI will buffer these events internally but at least in gameplay we can get the minimum possible
|
|
// input latency - assuming your main loop is architected properly (NativeFrame called from a different thread than input event handling).
|
|
void NativeTouch(const TouchInput &touch);
|
|
bool NativeKey(const KeyInput &key);
|
|
void NativeAxis(const AxisInput *axis, size_t count);
|
|
|
|
// Called when it's process a frame, including rendering. If the device can keep up, this
|
|
// will be called sixty times per second. Main thread.
|
|
void NativeFrame(GraphicsContext *graphicsContext);
|
|
|
|
// This should render num_samples 44khz stereo samples.
|
|
// Try not to make too many assumptions on the granularity
|
|
// of num_samples.
|
|
// This function may be called from a totally separate thread from
|
|
// the rest of the game, so be careful with synchronization.
|
|
// Returns the number of samples actually output. The app should do everything it can
|
|
// to fill the buffer completely.
|
|
int NativeMix(short *audio, int num_samples, int sampleRateHz);
|
|
|
|
// Called when it's time to shutdown. After this has been called,
|
|
// no more calls to any other function will be made from the framework
|
|
// before process exit.
|
|
// The graphics context should still be active when calling this, as freeing
|
|
// of graphics resources happens here.
|
|
// Main thread.
|
|
void NativeShutdownGraphics();
|
|
void NativeShutdown();
|
|
|
|
void PostLoadConfig();
|
|
|
|
void NativeSaveSecret(const char *nameOfSecret, const std::string &data);
|
|
std::string NativeLoadSecret(const char *nameOfSecret);
|