Major performance tweaks, functional directory hash, parallel processing, updated readme

Author: ef1500

readme.md

@@ -18,19 +18,30 @@ Bound Book Format (.bbf) is a high-performance binary container designed specifi
 ### Compilation
 Linux
 ```bash
-g++ -std=c++17 bbfenc.cpp libbbf.cpp xxhash.c -o bbfmux
+g++ -std=c++17 bbfenc.cpp libbbf.cpp xxhash.c -o bbfmux -pthread
 ```
 
 Windows
 ```bash
-g++ -std=c++17 bbfmux.cpp libbbf.cpp xxhash.c -o bbfmux -municode
+g++ -std=c++17 bbfenc.cpp libbbf.cpp xxhash.c -o bbfmux -municode
 ```
 
 ---
 
 ## Technical Details
+
 BBF is designed as a Footer-indexed binary format. This allows for rapid append-only creation and immediate random access to any page without scanning the entire file.
 
+### Zero-Copy Architecture
+The `bbfmux` reference implementation utilizes **Memory Mapping (mmap/MapViewOfFile)**. Instead of reading file data into intermediate buffers, the tool maps the container directly into the process address space. This allows the CPU to access image data at the speed of your NVMe drive's hardware limit.
+
+### High-Speed Parallel Verification
+Integrity checks now utilize **Parallel XXH3**. On multi-core systems, the verifier splits the asset table into chunks and validates multiple pages simultaneously. This makes BBF verification up to **10x faster** than ZIP/RAR CRC checks.
+
+### 4KB Alignment
+Every asset in a BBF file starts on a **4096-byte boundary**. This alignment is critical for modern hardware, allowing for DirectStorage transfers directly from disk to GPU memory, bypassing CPU bottlenecks entirely.
+
+
 ### Binary Layout
 1. **Header (13 bytes)**: Magic `BBF1`, versioning, and initial padding.
 2. **Page Data**: The raw image payloads (AVIF, PNG, etc.), each padded to **4096-byte boundaries**.
@@ -68,9 +79,6 @@ BBF is designed as a Footer-indexed binary format. This allows for rapid append-
 [7] - PDF supports "Linearization" (Fast Web View), allowing the header and first pages to be read before the rest of the file is downloaded.<br/>
 </font>
 
-### 4KB Alignment & DirectStorage
-Every asset in a BBF file starts on a 4KB boundary. This alignment is critical for modern NVMe-based systems. It allows developers to utilize `mmap` or **DirectStorage** to transfer image data directly from disk to GPU memory, bypassing the CPU-bottlenecked "copy and decompress" cycles found in Zip-based formats.
-
 ---
 
 ## Features
@@ -156,5 +164,65 @@ bbfmux input.bbf --info
 
 ---
 
+## Advanced CLI Features
+
+### Custom Page Ordering (`--order`)
+You can precisely control the reading order using a text file or inline arguments.
+*   **Positive Integers**: Fixed 1-based index (e.g., `cover.png:1`).
+*   **Negative Integers**: Fixed position from the end (e.g., `credits.png:-1` is always the last page).
+*   **Unspecified**: Sorted alphabetically between the fixed pages.
+
+```bash
+# Using an order file
+bbfmux ./images/ --order=pages.txt out.bbf
+
+# pages.txt example:
+cover.png:1
+page1.png:2
+page2.png:3
+credits.png:-1
+```
+
+### Batch Section Import (`--sections`)
+Sections define Chapters or Volumes. You can target a page by its index or filename.
+```bash
+# Target by filename
+bbfmux ./folder/ --section="Chapter 1":"001.png" out.bbf
+
+# Using a sections file
+bbfmux ./folder/ --sections=sectionexample.txt out.bbf
+
+# sectionexample.txt example (Name:Target[:Parent]):
+"Volume 1":"001.png"
+"Chapter 1":"001.png":"Volume 1"
+"Chapter 2":"050.png":"Volume 1"
+```
+
+### Targeted Verification
+BBF allows for verification of data to detect bit-rot.
+```bash
+# Verify everything (All assets and Directory structure)
+bbfmux input.bbf --verify
+
+# Verify only the directory hash (Instant)
+bbfmux input.bbf --verify -1
+
+# Verify a specific asset by index
+bbfmux input.bbf --verify 42
+```
+
+### Range-Key Extraction
+The `--rangekey` option allows you to extract a range of sections. The extractor starts at the specified `--section` and stops when it finds a section whose title matches the `rangekey`.
+
+```bash
+# Extract Chapter 2 up until it hits Chapter 4
+bbfmux manga.bbf --extract --section="Chapter 2" --rangekey="Chapter 4" --outdir="./Ch2_to_Ch4"
+
+# Extract Volume 2 until it encounters the string "Chapter 60"
+bbfmux manga.bbf --extract --section="Volume 2" --rangekey="Chapter 60"
+```
+
+---
+
 ## License
 Distributed under the MIT License. See `LICENSE` for more information.