1 | /* |
2 | Large image displaying library. |
3 | |
4 | Copyright (C) 2004 Maks Orlovich (maksim@kde.org) |
5 | |
6 | Permission is hereby granted, free of charge, to any person obtaining a copy |
7 | of this software and associated documentation files (the "Software"), to deal |
8 | in the Software without restriction, including without limitation the rights |
9 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
10 | copies of the Software, and to permit persons to whom the Software is |
11 | furnished to do so, subject to the following conditions: |
12 | |
13 | The above copyright notice and this permission notice shall be included in |
14 | all copies or substantial portions of the Software. |
15 | |
16 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
17 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
18 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
19 | AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN |
20 | AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN |
21 | CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
22 | |
23 | */ |
24 | |
25 | #ifndef IMAGE_LOADER_PROVIDER_H |
26 | #define IMAGE_LOADER_PROVIDER_H |
27 | |
28 | #include <QByteArray> |
29 | |
30 | namespace khtmlImLoad |
31 | { |
32 | |
33 | class ImageLoader; |
34 | /** |
35 | To register new image formats, new copies of ImageLoaderProvider's must be |
36 | created and registered with ImageManager::loaderDatabase(). |
37 | */ |
38 | class ImageLoaderProvider |
39 | { |
40 | public: |
41 | virtual ~ImageLoaderProvider() {} |
42 | enum Type { |
43 | Efficient, |
44 | Foreign |
45 | }; |
46 | |
47 | /** |
48 | Returns the type of the loader. An "efficient" loader does not duplicate any data, and will therefore be preferred; |
49 | while a "foreign" loader has to duplicate a large amount of image data to fit in w/the original |
50 | framework, and should therefore only be used when a better loader is not available |
51 | */ |
52 | virtual Type type() = 0; |
53 | |
54 | /** |
55 | Creates a loader for an image format that can decode a file starting with given data, or 0 if that's not possible. |
56 | */ |
57 | virtual ImageLoader *loaderFor(const QByteArray &prefix) = 0; |
58 | }; |
59 | |
60 | } |
61 | |
62 | #endif |
63 | |