OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // Contains code that should be used for initializing, or querying the state | 5 // Contains code that should be used for initializing, or querying the state |
6 // of the media library as a whole. | 6 // of the media library as a whole. |
7 | 7 |
8 #ifndef MEDIA_BASE_MEDIA_H_ | 8 #ifndef MEDIA_BASE_MEDIA_H_ |
9 #define MEDIA_BASE_MEDIA_H_ | 9 #define MEDIA_BASE_MEDIA_H_ |
10 | 10 |
11 #include "media/base/media_export.h" | 11 #include "media/base/media_export.h" |
12 | 12 |
13 namespace base { | 13 namespace base { |
14 class FilePath; | 14 class FilePath; |
15 } | 15 } |
16 | 16 |
17 namespace media { | 17 namespace media { |
18 | 18 |
19 // Initializes media libraries (e.g. ffmpeg) as well as CPU specific media | 19 // Attempts to initialize the media library (loading DLLs, DSOs, etc.). |
20 // features. | 20 // |
21 MEDIA_EXPORT void InitializeMediaLibrary(); | 21 // If |module_dir| is the empty string, then the system default library paths |
| 22 // are searched for the dynamic libraries. If a |module_dir| is provided, then |
| 23 // only the specified |module_dir| will be searched for the dynamic libraries. |
| 24 // |
| 25 // If multiple initializations are attempted with different |module_dir|s |
| 26 // specified then the first one to succeed remains effective for the lifetime |
| 27 // of the process. |
| 28 // |
| 29 // Returns true if everything was successfully initialized, false otherwise. |
| 30 MEDIA_EXPORT bool InitializeMediaLibrary(const base::FilePath& module_dir); |
| 31 |
| 32 // Helper function for unit tests to avoid boiler plate code everywhere. This |
| 33 // function will crash if it fails to load the media library. This ensures tests |
| 34 // fail if the media library is not available. |
| 35 MEDIA_EXPORT void InitializeMediaLibraryForTesting(); |
| 36 |
| 37 // Use this if you need to check whether the media library is initialized |
| 38 // for the this process, without actually trying to initialize it. |
| 39 MEDIA_EXPORT bool IsMediaLibraryInitialized(); |
| 40 |
| 41 // Use this if you need to initialize CPU specific features WITHOUT loading |
| 42 // DLLs, DSOs, etc. Only necessary if InitializeMediaLibrary() is not called; |
| 43 // does nothing if the media library has already been initialized. |
| 44 MEDIA_EXPORT void InitializeCPUSpecificMediaFeatures(); |
22 | 45 |
23 } // namespace media | 46 } // namespace media |
24 | 47 |
25 #endif // MEDIA_BASE_MEDIA_H_ | 48 #endif // MEDIA_BASE_MEDIA_H_ |
OLD | NEW |