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
|
// =================================================================================================
// Copyright Adobe
// Copyright 2011 Adobe
// All Rights Reserved
//
// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance with the terms
// of the Adobe license agreement accompanying it.
// =================================================================================================
#ifndef MODULEUTILS_H
#define MODULEUTILS_H
#include "XMPFiles/source/XMPFiles_Impl.hpp"
#if XMP_WinBuild
#include <Windows.h>
typedef HMODULE OS_ModuleRef;
#elif XMP_MacBuild
#include <CoreFoundation/CFBundle.h>
#include <memory>
typedef CFBundleRef OS_ModuleRef;
#elif XMP_UNIXBuild
#include <memory>
typedef void* OS_ModuleRef;
#elif XMP_AndroidBuild
#include <memory>
typedef void* OS_ModuleRef;
#else
#error Unsupported operating system
#endif
namespace XMP_PLUGIN
{
/**
* Platform implementation to retrieve a function pointer of the name \param inSymbol from a module \param inOSModule
*/
void* GetFunctionPointerFromModuleImpl( OS_ModuleRef inOSModule, const char* inSymbol );
/**
* @return true if @param inModulePath points to a valid shared library
*/
#if XMP_MacBuild
bool IsValidLibrary( const std::string & inModulePath );
#endif
/**
* Load module specified by absolute path \param inModulePath
*
* Win:
* If \param inOnlyResourceAccess = true, only the image is loaded, no referenced dlls are loaded nor initialization code is executed.
* If the module is already loaded and executable, it behaves as \param inOnlyResourceAccess = false.
* The reference count is increased, so don't forget to call UnloadModule.
*
* Mac:
* If \param inOnlyResourceAccess = true, only the CFBundleRef is created. No code is loaded and executed.
*/
OS_ModuleRef LoadModule( const std::string & inModulePath, bool inOnlyResourceAccess = false );
/**
* Unload module
* @param inModule
* @param inOnlyResourceAccess = true, close resource file (only relevant for Linux !!).
*/
void UnloadModule( OS_ModuleRef inModule, bool inOnlyResourceAccess = false );
/** @brief Read resource file and fill the data in outBuffer
* @param inOSModule Handle of the module.
* @param inResourceName Name of the resource file which needs to be read.
* @param inResourceType Type/Extension of the resource file.
* @param outBuffer Output buffer where data read from the resource file will be stored.
* @return true on success otherwise false
*/
bool GetResourceDataFromModule(
OS_ModuleRef inOSModule,
const std::string & inResourceName,
const std::string & inResourceType,
std::string & outBuffer);
} //namespace XMP_PLUGIN
#endif
|
