nuklear.h has been converted to C89 style comment blocks instead of the
amalgamation it was before (presummably a relic of the other
documentation system).
examples compile. more testing is required.
HEADER is the intro API section of the paq'd files, which is the most
critical part of our documentation. Ideally, this file needs to stay the
same style because it needs to be incorporated into the header file;
however, we can make a minor modification to allow doxygen to render it.
with this commit, I change the name to HEADER.c to allow doxygen
processing. This shouldn't have any affect on the generated paq file.
Eventually, I would like to move this HEADER file into a different name
and the overall mainpage of the documentation.
the difference isnt staggering by any means. the original comment blocks
had most everything we needed. More work is required and there are still
questions to be had about how much information / styling is desired to
be retained in the code comments, verses removing some styling because
doxygen handles that conversion into html with styling automatically.
this commit adds the proper source file directory, so now doxygen picks
up all of the C files for processing. Some minor cleanup and file
exclusions have also been added such that things like `paq.sh` and sub
`Readme.md` files are not picked up.
Adds initial doxyfile for doxygen configuration. Has some basic settings
for getting up and running with decent results.
Also, the beautiful doxygen-awesome-css project has been included in the
makefile such that we can pull (on your own time) a nice package to make
the doxygen output so much prettier to look at than the default.
SDL library has an issue where it expects intrinsics headers to be
provided, but intrinsics are not exactly part of a standard, so there is
no guarantee that they will be available. As such, the library allows
you to turn them off. I am disabling them to allow for better
portability and ease of compilation.
* demo: fix errors and warnings in GLFW Vulkan demo
* demo: improve resize handling in GLFW Vulkan demo
On my machine (x86_64 Linux, Wayland) VK_SUBOPTIMAL or
VK_OUT_OF_DATE_KHR were never returned so the resizing of the swapchain
never happened.
Fix by using GLFW's resize callback to detect a window resize and a
swapchain recreation. Vulkan tutorial uses the same approach.
fb_scale was never used in the Vulkan backend, so it was removed.
* demo: fix copy&paste typo in GLFW Vulkan demo
* demo: sync nuklear_glfw_vulkan.in.h with nuklear_glfw_vulkan.h
Over time people have not been noticing that the expected workflow is to
build nuklear_glfw_vulkan.h from nuklear_glfw_vulkan.in.h
Function `NK_API int nk_cairo_render(struct nk_cairo_context *cairo_ctx, struct nk_context *nk_ctx)` returns an int but `return;` is used twice. Now replaced with `return nk_false;`. This makes for clean compilation with both C89 _and_ C99.