7f40c3f477
## Summary Continue my changes to introduce the HAL infrastructure from https://github.com/crosspoint-reader/crosspoint-reader/pull/522 This PR touches quite a lot of files, but most of them are just name changing. It should not have any impacts to the end behavior. ## Additional Context My plan is to firstly add this small shim layer, which sounds useless at first, but then I'll implement an emulated driver which can be helpful for testing and for development. Currently, on my fork, I'm using a FS driver that allow "mounting" a local directory from my computer to the device, much like the `-v` mount option on docker. This allows me to quickly reset `.crosspoint` directory if anything goes wrong. I plan to upstream this feature when this PR get merged. --- ### AI Usage While CrossPoint doesn't have restrictions on AI tools in contributing, please be transparent about their usage as it helps set the right context for reviewers. Did you use AI tools to help write this code? NO
113 lines
3.1 KiB
C++
113 lines
3.1 KiB
C++
#pragma once
|
|
|
|
#include <HalStorage.h>
|
|
|
|
#include <algorithm>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
class BookMetadataCache {
|
|
public:
|
|
struct BookMetadata {
|
|
std::string title;
|
|
std::string author;
|
|
std::string language;
|
|
std::string coverItemHref;
|
|
std::string textReferenceHref;
|
|
};
|
|
|
|
struct SpineEntry {
|
|
std::string href;
|
|
size_t cumulativeSize;
|
|
int16_t tocIndex;
|
|
|
|
SpineEntry() : cumulativeSize(0), tocIndex(-1) {}
|
|
SpineEntry(std::string href, const size_t cumulativeSize, const int16_t tocIndex)
|
|
: href(std::move(href)), cumulativeSize(cumulativeSize), tocIndex(tocIndex) {}
|
|
};
|
|
|
|
struct TocEntry {
|
|
std::string title;
|
|
std::string href;
|
|
std::string anchor;
|
|
uint8_t level;
|
|
int16_t spineIndex;
|
|
|
|
TocEntry() : level(0), spineIndex(-1) {}
|
|
TocEntry(std::string title, std::string href, std::string anchor, const uint8_t level, const int16_t spineIndex)
|
|
: title(std::move(title)),
|
|
href(std::move(href)),
|
|
anchor(std::move(anchor)),
|
|
level(level),
|
|
spineIndex(spineIndex) {}
|
|
};
|
|
|
|
private:
|
|
std::string cachePath;
|
|
size_t lutOffset;
|
|
uint16_t spineCount;
|
|
uint16_t tocCount;
|
|
bool loaded;
|
|
bool buildMode;
|
|
|
|
FsFile bookFile;
|
|
// Temp file handles during build
|
|
FsFile spineFile;
|
|
FsFile tocFile;
|
|
|
|
// Index for fast href→spineIndex lookup (used only for large EPUBs)
|
|
struct SpineHrefIndexEntry {
|
|
uint64_t hrefHash; // FNV-1a 64-bit hash
|
|
uint16_t hrefLen; // length for collision reduction
|
|
int16_t spineIndex;
|
|
};
|
|
std::vector<SpineHrefIndexEntry> spineHrefIndex;
|
|
bool useSpineHrefIndex = false;
|
|
|
|
static constexpr uint16_t LARGE_SPINE_THRESHOLD = 400;
|
|
|
|
// FNV-1a 64-bit hash function
|
|
static uint64_t fnvHash64(const std::string& s) {
|
|
uint64_t hash = 14695981039346656037ull;
|
|
for (char c : s) {
|
|
hash ^= static_cast<uint8_t>(c);
|
|
hash *= 1099511628211ull;
|
|
}
|
|
return hash;
|
|
}
|
|
|
|
uint32_t writeSpineEntry(FsFile& file, const SpineEntry& entry) const;
|
|
uint32_t writeTocEntry(FsFile& file, const TocEntry& entry) const;
|
|
SpineEntry readSpineEntry(FsFile& file) const;
|
|
TocEntry readTocEntry(FsFile& file) const;
|
|
|
|
public:
|
|
BookMetadata coreMetadata;
|
|
|
|
explicit BookMetadataCache(std::string cachePath)
|
|
: cachePath(std::move(cachePath)), lutOffset(0), spineCount(0), tocCount(0), loaded(false), buildMode(false) {}
|
|
~BookMetadataCache() = default;
|
|
|
|
// Building phase (stream to disk immediately)
|
|
bool beginWrite();
|
|
bool beginContentOpfPass();
|
|
void createSpineEntry(const std::string& href);
|
|
bool endContentOpfPass();
|
|
bool beginTocPass();
|
|
void createTocEntry(const std::string& title, const std::string& href, const std::string& anchor, uint8_t level);
|
|
bool endTocPass();
|
|
bool endWrite();
|
|
bool cleanupTmpFiles() const;
|
|
|
|
// Post-processing to update mappings and sizes
|
|
bool buildBookBin(const std::string& epubPath, const BookMetadata& metadata);
|
|
|
|
// Reading phase (read mode)
|
|
bool load();
|
|
SpineEntry getSpineEntry(int index);
|
|
TocEntry getTocEntry(int index);
|
|
int getSpineCount() const { return spineCount; }
|
|
int getTocCount() const { return tocCount; }
|
|
bool isLoaded() const { return loaded; }
|
|
};
|