1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
/* GSL - Generic Sound Layer
* Copyright (C) 2001 Tim Janik
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
* Public License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __GSL_DATA_CACHE_H__
#define __GSL_DATA_CACHE_H__
#include <gsl/gslcommon.h>
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/* --- macros --- */
#define GSL_DATA_CACHE_NODE_SIZE(dcache) (((GslDataCache*) (dcache))->node_size)
/* --- typedefs & structures --- */
typedef gfloat GslDataType;
typedef struct _GslDataCacheNode GslDataCacheNode;
struct _GslDataCache
{
GslDataHandle *dhandle;
guint open_count;
GslMutex mutex;
guint ref_count;
guint node_size; /* power of 2, const for all dcaches */
guint padding; /* n_values around blocks */
guint max_age;
gboolean low_persistency;
guint n_nodes;
GslDataCacheNode **nodes;
};
struct _GslDataCacheNode
{
gsize offset;
guint ref_count;
guint age;
GslDataType *data; /* NULL while busy */
};
typedef enum
{
GSL_DATA_CACHE_REQUEST = FALSE, /* node->data may be NULL and will be filled */
GSL_DATA_CACHE_DEMAND_LOAD = TRUE, /* blocks until node->data != NULL */
GSL_DATA_CACHE_PEEK = 2 /* may return NULL node, data != NULL otherwise */
} GslDataCacheRequest;
/* --- prototypes --- */
GslDataCache* gsl_data_cache_new (GslDataHandle *dhandle,
guint padding);
GslDataCache* gsl_data_cache_ref (GslDataCache *dcache);
void gsl_data_cache_unref (GslDataCache *dcache);
void gsl_data_cache_open (GslDataCache *dcache);
void gsl_data_cache_close (GslDataCache *dcache);
GslDataCacheNode* gsl_data_cache_ref_node (GslDataCache *dcache,
gsize offset,
GslDataCacheRequest load_request);
void gsl_data_cache_unref_node (GslDataCache *dcache,
GslDataCacheNode *node);
void gsl_data_cache_free_olders (GslDataCache *dcache,
guint max_age);
GslDataCache* gsl_data_cache_from_dhandle (GslDataHandle *dhandle,
guint min_padding);
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* __GSL_DATA_CACHE_H__ */
|
