|
| library_t * | library_open (const library_config_t *cfg) |
| | loads an existing index if present
|
| |
| void | library_close (library_t *lib) |
| |
| int | library_scan (library_t *lib, bool full_rebuild, lib_scan_cb_t cb, void *user) |
| | Incremental scan (new/changed/removed files). Blocking; run it in a worker thread.
|
| |
| bool | library_is_scanning (const library_t *lib) |
| |
| uint32_t | library_track_count (const library_t *lib) |
| |
| uint32_t | library_view_count (library_t *lib, lib_view_t view, lib_id_t parent) |
| | Number of rows in a view (parent = LIB_ID_NONE when the view has no parent).
|
| |
| int | library_view_item (library_t *lib, lib_view_t view, lib_id_t parent, uint32_t index, lib_item_t *out) |
| |
| uint32_t | library_view_find_letter (library_t *lib, lib_view_t view, lib_id_t parent, uint32_t letter) |
| | Index of the first row whose sort letter is >= letter (for jump-to-letter).
|
| |
| uint32_t | library_view_track_ids (library_t *lib, lib_view_t view, lib_id_t parent, lib_id_t *out, uint32_t max) |
| | Track ids of a view in display order (for "play all" / queue building).
|
| |
| int | library_get_track (library_t *lib, lib_id_t track_id, lib_track_t *out) |
| |
| lib_id_t | library_find_path (library_t *lib, const char *path) |
| | LIB_ID_NONE if not indexed.
|
| |
| uint32_t | library_generation (const library_t *lib) |
| | Track ids belong to one snapshot of the index: a completed scan renumbers them.
|
| |
| bool | library_translate_ids (library_t *lib, uint32_t *gen, lib_id_t *ids, uint32_t n) |
| |
| int | library_save_position (library_t *lib, const char *path, uint32_t position_ms) |
| | Audiobook / long-file positions and simple bookmarks (stored in db_dir/positions.bin).
|
| |
| uint32_t | library_load_position (library_t *lib, const char *path) |
| | 0 if none
|
| |
Music library index stored on the SD card (no LevelDB, no SQLite).
Files in <db_dir> (for example "/sdcard/.music/db"), named after the snapshot generation ("tracks-0a1b2c3d.bin"): tracks.bin fixed-size records (path/title/artist/... as offsets into strings.bin) strings.bin UTF-8 string pool *.idx sorted uint32 arrays for each view (artists, albums, tracks, genres...) files.bin path -> (size, mtime) for incremental rescans A scan writes the files of a new generation next to the loaded one and swaps it in atomically, so readers keep working on the old snapshot while scanning and never wait for card writes at the swap. After a crash the last complete generation is used. All queries are thread-safe (core locks).
Memory: index arrays live in RAM (4 bytes per entry and view), records and strings are read from the card through a small block cache.
| typedef void(* lib_throttle_cb_t) (void *user) |
Scanner pacing, called from the scanning thread: between files and folders (the platform may block here while the audio buffer is low, so indexing never causes dropouts), and at least every ~5 ms of pure CPU work (the sorts that finish a scan of a large library).
A platform whose scanning task runs above its idle task should let it run here (e.g. sleep one tick when the last sleep is a few ms ago), or the task watchdog fires.
| uint32_t library_generation |
( |
const library_t * |
lib | ) |
|
Track ids belong to one snapshot of the index: a completed scan renumbers them.
The generation names the snapshot (0 = none); reading it takes no lock, so it is cheap to poll. library_translate_ids() brings ids of snapshot *gen into the current one, in place (LIB_ID_NONE for files that are gone), and sets *gen to the current generation. It works for ids of the current or the previous snapshot; for older ones it returns false and changes nothing, so holders of ids (the play queue) translate after every scan.
