You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Theodosius/include/recomp/recomp.hpp

97 lines
3.0 KiB

#pragma once
#include <decomp/decomp.hpp>
#include <obf/engine.hpp>
#include <recomp/symbol_table.hpp>
/// <summary>
/// this namespace encompasses all recomposition related code.
/// </summary>
namespace theo::recomp {
/// <summary>
/// a function which is called by recomp_t to resolve external symbols
/// </summary>
using resolver_t = std::function<std::uintptr_t(std::string)>;
/// <summary>
/// a function which is called by recomp_t to copy symbols into memory.
/// </summary>
using copier_t = std::function<void(std::uintptr_t, void*, std::uint32_t)>;
/// <summary>
/// a function which is called to allocate space for a symbol.
///
/// the first param is the size of the symbol, the second param is the
/// characteristics of the section which the symbol is allocated in.
/// </summary>
using allocator_t =
std::function<std::uintptr_t(std::uint32_t,
coff::section_characteristics_t)>;
/// <summary>
/// the main class responsible for recomposition
/// </summary>
class recomp_t {
public:
/// <summary>
/// the explicit constructor for the recomp_t class.
/// </summary>
/// <param name="dcmp">pointer to a decomp_t class.</param>
/// <param name="alloc">lambda function which is used to allocate memory for
/// symbols.</param> <param name="copy">lambda function used to copy bytes
/// into allocations.</param> <param name="resolve">lambda function used to
/// resolve external symbols.</param>
explicit recomp_t(decomp::decomp_t* dcmp,
allocator_t alloc,
copier_t copy,
resolver_t resolve);
/// <summary>
/// when called, this function allocates space for every symbol.
/// </summary>
void allocate();
/// <summary>
/// when called, this function resolves all relocations in every symbol.
/// </summary>
void resolve();
/// <summary>
/// when called, this function copies symbols into allocations.
/// </summary>
void copy_syms();
/// <summary>
/// setter for the allocater lambda function.
/// </summary>
/// <param name="alloc">lambda function which allocates memory for
/// symbols.</param>
void allocator(allocator_t alloc);
/// <summary>
/// setter for the copier lambda function.
/// </summary>
/// <param name="copy">copier lambda function used to copy bytes into
/// allocations made by the allocator.</param>
void copier(copier_t copy);
/// <summary>
/// setter for the resolve lambda function.
/// </summary>
/// <param name="resolve">lambda function to resolve external symbols.</param>
void resolver(resolver_t resolve);
/// <summary>
/// resolves the address of a function given its name.
/// </summary>
/// <param name="sym">the name of the symbol to resolve the location
/// of.</param> <returns>the address of the symbol.</returns>
std::uintptr_t resolve(const std::string&& sym);
private:
decomp::decomp_t* m_dcmp;
resolver_t m_resolver;
copier_t m_copier;
allocator_t m_allocator;
};
} // namespace theo::recomp