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
131
132
133
134
135
136
137
138
139
140
141
142
|
/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*- vi:set ts=8 sts=4 sw=4: */
/*
Sonic Visualiser
An audio file viewer and annotation editor.
Centre for Digital Music, Queen Mary, University of London.
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 (at your option) any later version. See the file
COPYING included with this distribution for more information.
*/
/*
This is a modified version of a source file from the
Rosegarden MIDI and audio sequencer and notation editor.
This file copyright 2005-2011 Chris Cannam and the Rosegarden
development team.
*/
#ifndef SV_RESOURCE_FINDER_H
#define SV_RESOURCE_FINDER_H
#include <QString>
#include "Debug.h"
namespace sv {
class ResourceFinder
{
public:
ResourceFinder() { }
virtual ~ResourceFinder() { }
/**
* Return the location (as a true file path, or a Qt4 ":"-prefixed
* resource path) of the file best matching the given resource
* filename in the given resource category.
*
* Category should be a relative directory path without leading or
* trailing slashes, for example "chords". The fileName is the
* remainder of the file name without any path content, for
* example "user_chords.xml".
*
* Returns an empty string if no matching resource is found.
*
* Use this when you know that a particular resource is required
* and just need to locate it.
*/
QString getResourcePath(QString resourceCat, QString fileName);
/**
* Return a list of full file paths for files with the given file
* extension, found in the given resource category.
*
* Category should be a relative directory path without leading or
* trailing slashes, for example "chords". File extension should
* be the extension without the dot, for example "xml". Returned
* list may mix true file paths in both installed and user
* locations with Qt4 ":"-prefixed resource paths.
*
* Use this when you need to enumerate the options available for
* use directly in the program (rather than e.g. offering the user
* a file-open dialog).
*/
QStringList getResourceFiles(QString resourceCat, QString fileExt);
/**
* Return the true file path for installed resource files in the
* given resource category. Category should be a relative
* directory path without leading or trailing slashes, for example
* "chords". Note that resources may also exist in the Qt4
* resource bundle; this method only returns the external
* (installed) resource location. Use getResourceFiles instead to
* return an authoritative list of available resources of a given
* type.
*
* Use this when you need a file path, e.g. for use in a file
* finder dialog.
*/
QString getResourceDir(QString resourceCat);
/**
* Return the true file path for the location in which the named
* resource file in the given resource category should be saved.
* ResourceFinder will make a best effort to ensure this directory
* actually exists, before returning.
*/
QString getResourceSavePath(QString resourceCat, QString fileName);
/**
* Return the true file path for the location in which resource
* files in the given resource category should be saved.
*/
QString getResourceSaveDir(QString resourceCat);
/**
* If the named resource file in the given resource category is
* available only as a bundled resource, copy it out into the user
* location returned by getResourceSavePath so that it can be read
* by non-Qt code. Any subsequent call to getResourcePath for
* this resource should return a true file path (if the resource
* exists) in either user or system location, or an empty string
* (if the resource does not exist), but never a ":"-prefixed
* resource path. This function does not overwrite any existing
* unbundled copy of the resource.
*
* Return false if a system error occurs during unbundling
* (e.g. disk full).
*/
bool unbundleResource(QString resourceCat, QString fileName);
/**
* Return the root path for user-specific resource installation
* for this application (i.e. resources beneath the user's home
* directory).
*/
QString getUserResourcePrefix();
/**
* Return the root paths for systemwide resource installations for
* this application.
*/
QStringList getSystemResourcePrefixList();
/**
* Return all root paths for resource installations for this
* application, in the order in which they will be searched. This
* list consists of the user-specific path
* (getUserResourcePrefix()) followed by the systemwide paths
* (getSystemResourcePrefixList()).
*/
QStringList getResourcePrefixList();
};
} // end namespace sv
#endif
|
