summaryrefslogtreecommitdiff
path: root/src/resources/resourcemanager/resourcemanager.h
blob: c436aed8b7631ddb82731f41d3865df6c11c2bea (plain) (blame)
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
/*
 *  The ManaPlus Client
 *  Copyright (C) 2004-2009  The Mana World Development Team
 *  Copyright (C) 2009-2010  The Mana Developers
 *  Copyright (C) 2011-2017  The ManaPlus Developers
 *
 *  This file is part of The ManaPlus Client.
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  any later version.
 *
 *  This program 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef RESOURCES_RESOURCEMANAGER_RESOURCEMANAGER_H
#define RESOURCES_RESOURCEMANAGER_RESOURCEMANAGER_H

#include <map>
#include <set>
#include <string>

#include "localconsts.h"

class Resource;

struct SDL_Surface;
struct SDL_RWops;

namespace ResourceManager
{
    typedef Resource *(*loader)(SDL_RWops *rw,
                                const std::string &name);
    typedef Resource *(&generator)(const void *const data);

    typedef std::map<std::string, Resource*> Resources;
    typedef Resources::iterator ResourceIterator;
    typedef Resources::const_iterator ResourceCIterator;

    /**
     * Cleans up remaining resources, warning about resources
     * that were still referenced.
     */
    void deleteResourceManager();

    /**
     * Creates a resource and adds it to the resource map.
     *
     * @param idPath The resource identifier path.
     * @param fun    A function for generating the resource.
     * @param data   Extra parameters for the generator.
     * @return A valid resource or <code>NULL</code> if the resource could
     *         not be generated.
     */
    Resource *get(const std::string &idPath,
                  generator fun,
                  const void *const data) A_WARN_UNUSED;

    Resource *getFromCache(const std::string &idPath) A_WARN_UNUSED;

    Resource *getFromCache(const std::string &filename,
                           const int variant) A_WARN_UNUSED;

    bool addResource(const std::string &idPath,
                     Resource *const resource);

    /**
     * Releases a resource, placing it in the set of orphaned resources.
     */
    void release(Resource *const res);

    void clearDeleted(const bool full = true);

    void decRefDelete(Resource *const res);

    /**
     * Move resource to deleted resources list.
     */
    void moveToDeleted(Resource *const res);

    void scheduleDelete(SDL_Surface *const surface);

    void clearScheduled();

    /**
     * Deletes the class instance if it exists.
     */
    void deleteInstance();

    int size() noexcept2 A_WARN_UNUSED;

#if defined(DEBUG_DUMP_LEAKS) || defined(UNITTESTS)
    Resources &getResources() A_WARN_UNUSED;

    Resources &getOrphanedResources() A_WARN_UNUSED;

    const std::set<Resource*> &getDeletedResources() A_WARN_UNUSED;
#endif  // defined(DEBUG_DUMP_LEAKS) || defined(UNITTESTS)

    bool cleanOrphans(const bool always = false);

    void cleanProtected();

    bool isInCache(const std::string &idPath) A_WARN_UNUSED;

    Resource *getTempResource(const std::string &idPath) A_WARN_UNUSED;

    void clearCache();

    int calcMemoryLocal();

    int calcMemoryChilds(const int level);

    int calcMemory(const int level);

    void cleanUp(Resource *const resource);

    void logResource(const Resource *const res);

    void logResources(const std::string &msg);
}  // namespace ResourceManager

#endif  // RESOURCES_RESOURCEMANAGER_RESOURCEMANAGER_H