subsurface/core/picture.h
Berthold Stoeger 989d6a3f96 media: use table instead of linked list for media
For consistency with equipment, use our table macros for pictures.
Generally tables (arrays) are preferred over linked lists, because
they allow random access.

This is mostly copy & paste of the equipment code.

Sadly, our table macros are quite messy and need some revamping.
Therefore, the resulting code is likewise somewhat messy.

Signed-off-by: Berthold Stoeger <bstoeger@mail.tuwien.ac.at>
2020-05-06 13:58:09 -07:00

42 lines
1.2 KiB
C

// SPDX-License-Identifier: GPL-2.0
#ifndef PICTURE_H
#define PICTURE_H
// picture (more precisely media) related strutures and functions
#include "units.h"
#include <stddef.h> // For NULL
#ifdef __cplusplus
extern "C" {
#endif
struct picture {
char *filename;
offset_t offset;
location_t location;
};
static const struct picture empty_picture = { NULL, { 0 }, { { 0 }, { 0 } } };
/* Table of pictures. Attention: this stores pictures,
* *not* pointers to pictures. This has two crucial consequences:
* 1) Pointers to pictures are not stable. They may be
* invalidated if the table is reallocated.
* 2) add_to_picture_table(), etc. take ownership of the
* picture. Notably of the filename. */
struct picture_table {
int nr, allocated;
struct picture *pictures;
};
/* picture table functions */
extern void clear_picture_table(struct picture_table *);
extern void add_to_picture_table(struct picture_table *, int idx, struct picture pic);
extern void copy_pictures(const struct picture_table *s, struct picture_table *d);
extern void add_picture(struct picture_table *, struct picture newpic);
extern bool remove_picture(struct picture_table *, const char *filename);
#ifdef __cplusplus
}
#endif
#endif // PICTURE_H