ac465d29b4
I'm taking a page from Dolphin's book, and including copies of each dependency's source code. This combines the ease of use of including pre-built libraries instead of needing to navigate a package manager - as is (or was) the case for MSVC - with the portability of using packages. Granted, this method's more of a jack of all trades, master of none, since it's *less* user-friendly than prebuilt packages (compilation times), and you don't get the per-distro compatibility fixes you'd get from a package manager. You can still use system libs if you want. In fact, it's still the default behaviour: compiling the libs manually is just a fallback. I'll add an option to force-enable this soon, however, since it's a nicer way to produce static MSYS2 builds than the hackish nightmare that I was using before. Not to mention, having my own copy of the sources means I can provide my own fixes and tweaks your package manager may not. For example, I can combine MSYS2's FreeType subpixel rendering with vcpkg's fix for SDL2 exporting its symbols in static builds.
55 lines
2.5 KiB
C
55 lines
2.5 KiB
C
/*
|
|
Simple DirectMedia Layer
|
|
Copyright (C) 1997-2018 Sam Lantinga <slouken@libsdl.org>
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any damages
|
|
arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
including commercial applications, and to alter it and redistribute it
|
|
freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
claim that you wrote the original software. If you use this software
|
|
in a product, an acknowledgment in the product documentation would be
|
|
appreciated but is not required.
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
misrepresented as being the original software.
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
*/
|
|
#ifndef SDL_dataqueue_h_
|
|
#define SDL_dataqueue_h_
|
|
|
|
/* this is not (currently) a public API. But maybe it should be! */
|
|
|
|
struct SDL_DataQueue;
|
|
typedef struct SDL_DataQueue SDL_DataQueue;
|
|
|
|
SDL_DataQueue *SDL_NewDataQueue(const size_t packetlen, const size_t initialslack);
|
|
void SDL_FreeDataQueue(SDL_DataQueue *queue);
|
|
void SDL_ClearDataQueue(SDL_DataQueue *queue, const size_t slack);
|
|
int SDL_WriteToDataQueue(SDL_DataQueue *queue, const void *data, const size_t len);
|
|
size_t SDL_ReadFromDataQueue(SDL_DataQueue *queue, void *buf, const size_t len);
|
|
size_t SDL_PeekIntoDataQueue(SDL_DataQueue *queue, void *buf, const size_t len);
|
|
size_t SDL_CountDataQueue(SDL_DataQueue *queue);
|
|
|
|
/* this sets a section of the data queue aside (possibly allocating memory for it)
|
|
as if it's been written to, but returns a pointer to that space. You may write
|
|
to this space until a read would consume it. Writes (and other calls to this
|
|
function) will safely append their data after this reserved space and can
|
|
be in flight at the same time. There is no thread safety.
|
|
If there isn't an existing block of memory that can contain the reserved
|
|
space, one will be allocated for it. You can not (currently) allocate
|
|
a space larger than the packetlen requested in SDL_NewDataQueue.
|
|
Returned buffer is uninitialized.
|
|
This lets you avoid an extra copy in some cases, but it's safer to use
|
|
SDL_WriteToDataQueue() unless you know what you're doing.
|
|
Returns pointer to buffer of at least (len) bytes, NULL on error.
|
|
*/
|
|
void *SDL_ReserveSpaceInDataQueue(SDL_DataQueue *queue, const size_t len);
|
|
|
|
#endif /* SDL_dataqueue_h_ */
|
|
|
|
/* vi: set ts=4 sw=4 expandtab: */
|
|
|