Shipwright/libultraship/libultraship/Lib/Fast3D
briaguya daec428cb3
call SDL_Quit() before exit(0) (linux window closing issue) (#408)
* use _Exit(0) on linux

* use SDL_Quit() instead of _Exit(0)

* remove unnecessary call, add bandaid comment

Co-authored-by: briaguya <briaguya@alice>
2022-05-29 16:45:27 -04:00
..
U64/PR/ultra64 Linux/GCC Support (#28) 2022-05-11 13:18:24 -04:00
dxsdk git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
.gitrepo git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
LICENSE.txt git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
README.md git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_cc.cpp Moved grayscale effect to the gpu and replaced some texture loads (#221) 2022-04-25 22:19:00 +02:00
gfx_cc.h Moved grayscale effect to the gpu and replaced some texture loads (#221) 2022-04-25 22:19:00 +02:00
gfx_direct3d11.cpp Implement AnyFPS + option to queue one rendered frame (#401) 2022-05-29 12:16:23 -04:00
gfx_direct3d11.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_direct3d12.cpp git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_direct3d12.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_direct3d12_guids.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_direct3d_common.cpp Removed ternary operator 2022-04-25 19:14:46 -04:00
gfx_direct3d_common.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_dxgi.cpp Implement AnyFPS + option to queue one rendered frame (#401) 2022-05-29 12:16:23 -04:00
gfx_dxgi.h Implement AnyFPS + option to queue one rendered frame (#401) 2022-05-29 12:16:23 -04:00
gfx_glx.cpp Linux/GCC Support (#28) 2022-05-11 13:18:24 -04:00
gfx_glx.h Linux/GCC Support (#28) 2022-05-11 13:18:24 -04:00
gfx_opengl.cpp Linux/GCC Support (#28) 2022-05-11 13:18:24 -04:00
gfx_opengl.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_pc.cpp Implement AnyFPS + option to queue one rendered frame (#401) 2022-05-29 12:16:23 -04:00
gfx_pc.h Implement AnyFPS + option to queue one rendered frame (#401) 2022-05-29 12:16:23 -04:00
gfx_rendering_api.h Normalized imgui and added texture filter (#271) 2022-05-11 10:59:56 -04:00
gfx_screen_config.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_sdl.h git subrepo clone https://github.com/HarbourMasters/libultraship.git 2022-03-22 02:52:44 +01:00
gfx_sdl2.cpp call SDL_Quit() before exit(0) (linux window closing issue) (#408) 2022-05-29 16:45:27 -04:00
gfx_window_manager_api.h Implement AnyFPS + option to queue one rendered frame (#401) 2022-05-29 12:16:23 -04:00

README.md

Nintendo 64 Fast3D renderer

Implementation of a Fast3D renderer for games built originally for the Nintendo 64 platform.

For rendering OpenGL, Direct3D 11 and Direct3D 12 are supported.

Supported windowing systems are GLX (used on Linux), DXGI (used on Windows) and SDL (generic).

Usage

See gfx_pc.h. You will also need a copy of PR/gbi.h, found in libultra.

First call gfx_init(struct GfxWindowManagerAPI *wapi, struct GfxRenderingAPI *rapi, const char *game_name, bool start_in_fullscreen) and supply the desired backends at program start.

Some callbacks can be set on wapi. See gfx_window_manager_api.h for more info.

Each game main loop iteration should look like this:

gfx_start_frame(); // Handles input events such as keyboard and window events
// perform game logic here
gfx_run(cmds); // submit display list and render a frame
// do more expensive work here, such as play audio
gfx_end_frame(); // this just waits until the frame is shown on the screen (vsync), to provide correct game timing

When you are ready to start the main loop, call wapi->main_loop(one_iteration_func).

For the best experience, please change the Vtx and Mtx structures to use floats instead of fixed point arithmetic (GBI_FLOATS).

License

See LICENSE.txt. Redistributions are allowed only in source form, not in binary form.