mirror of
https://github.com/TwilitRealm/dusklight
synced 2026-08-06 01:18:13 -04:00
Luke Street
50 lines
1.6 KiB
C
50 lines
1.6 KiB
C
#pragma once
|
|
|
|
#include <mods/api.h>
|
|
|
|
#ifdef __cplusplus
|
|
#include <mods/service.hpp>
|
|
#endif
|
|
|
|
/*
|
|
* Read-only access to the res/ tree of the calling mod's own bundle. Reload serves the new
|
|
* bundle's contents. For writable storage, use HostService::mod_dir.
|
|
*/
|
|
|
|
#define RESOURCE_SERVICE_ID "dev.twilitrealm.dusklight.resource"
|
|
#define RESOURCE_SERVICE_MAJOR 1u
|
|
#define RESOURCE_SERVICE_MINOR 0u
|
|
|
|
/*
|
|
* A loaded resource, allocated by the service. Return every successful load with free;
|
|
* buffers still live when the mod is disabled or reloaded are reclaimed with a warning.
|
|
*/
|
|
typedef struct ResourceBuffer {
|
|
uint32_t struct_size;
|
|
void* data;
|
|
size_t size;
|
|
} ResourceBuffer;
|
|
|
|
#define RESOURCE_BUFFER_INIT {sizeof(ResourceBuffer), NULL, 0u}
|
|
|
|
typedef struct ResourceService {
|
|
ServiceHeader header;
|
|
|
|
/*
|
|
* Load a file into a fresh allocation. `relative_path` is resolved against the bundle's
|
|
* res/ directory. Absolute paths and ".." are rejected. MOD_UNAVAILABLE if the file does not
|
|
* exist. An empty file loads as data == NULL with size 0. Previous contents of `out_buffer` are
|
|
* overwritten, not freed.
|
|
*/
|
|
ModResult (*load)(ModContext* ctx, const char* relative_path, ResourceBuffer* out_buffer);
|
|
|
|
/*
|
|
* Release a loaded buffer and reset it to the empty state. Safe to call on an empty or
|
|
* already-freed buffer.
|
|
*/
|
|
void (*free)(ModContext* ctx, ResourceBuffer* buffer);
|
|
} ResourceService;
|
|
|
|
MOD_DECLARE_SERVICE(ResourceService, svc_resource, RESOURCE_SERVICE_ID, RESOURCE_SERVICE_MAJOR,
|
|
RESOURCE_SERVICE_MINOR);
|