<< lib/codecs/SLCodecController.sleela SLeeLa Standard Library Definition. Definition: Defines the SLeeLa standard-library type SLCodecController used within the codecs library family. >> #sleela 2.5 material; < Family: codecs. The SLeeLa-facing Codec Management Controller — the single > < surface a GUI or application drives to use codecs, mirroring the native > < "Codec Loader / Unloader / Management Controller" > < (codecs/include/sleela_codec_manager.h). The Controller owns each codec's > < loaded/unloaded lifecycle and the backend-registration table, and cooperates > < with the sibling classes: > < > < * SLCodecLoader — classification (nameOf / isNative) and the standalone > < plugin-load contract; > < * SLCodecVerifier — extension/magic resolution and result-code text; > < * SLCodecProcessor — the standalone decode/encode dispatch contract. > < > < As of syntax 1.11 the Controller holds its collaborators as fields and calls > < through them directly (method calls resolve on class-typed fields). create() > < wires an SLCodecVerifier; the Controller keeps its own lifecycle state in > < int[] tables. > < > < Codec ids mirror sleela_codec_id (0-based, registry order): > < 0 PCM_WAV 1 AIFF 2 FLAC 3 ALAC 4 MP3 5 AAC 6 HE_AAC 7 VORBIS > < 8 OPUS 9 SPEEX 10 WMA 11 AC3 12 EAC3 13 AMR_NB 14 AMR_WB > < 15 G711_MULAW 16 G711_ALAW 17 MIDI 18 MATROSKA_AUDIO 19 WEBM_AUDIO > < > < Handler states: 0 native, 1 backend, 2 recognized, 3 container, 4 event. > < Result codes (sleela_codec_result): 0 ok, -1 unsupported, -2 invalid, > < -3 format, -4 io, -5 state(not loaded). > < As of the common-standard refactor this Controller EXTENDS the shared > < lib/core/SLPluginService harness: the registry lifecycle (load/unload/ > < isLoaded/loadedCount/validId/registerBackend/clearBackend/hasBackend/ > < canProcess) and the dispatch gate (dispatchCode) are inherited and no longer > < duplicated here. This class keeps only what is specific to codecs: the 20- > < handler count and native-id mask (wired in create()), the Verifier it owns > < for extension/magic resolution, and the domain verbs decode()/encode(). > class SLCodecController extends SLPluginService { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, or catalog can read and (where appropriate) override this record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 10872; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-10"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 9; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } < The verification collaborator, wired by create() and called via the field. > < (The loaded/backend lifecycle tables and the ready flag are inherited from > < SLPluginService; only the codec-specific Verifier lives here.) > SLCodecVerifier verifier; < ---- lifecycle of the controller itself ----------------------------- > < Build the controller with every codec registered but none loaded. Mirrors > < sleela_codec_manager_create. configure() (inherited) allocates the 20-entry > < lifecycle tables and records the native-id mask; then wire the Verifier. > < Native codecs encode/decode in-package: PCM/WAV (0), AIFF (1), G.711 > < mu-law (15), G.711 A-law (16) -> mask bits 0,1,15,16. > void create() { configure(20, nativeMaskForCodecs()); verifier = new SLCodecVerifier(); } < The native-id bit mask for codecs: bits 0, 1, 15, 16 set. > int nativeMaskForCodecs() { int bit15 = 1; int k = 0; while (k < 15) { bit15 = bit15 * 2; k = k + 1; } return 1 + 2 + bit15 + (bit15 * 2); } < ---- resolution (delegated to the wired Verifier) ------------------- > < Resolve a codec id from a file extension via the Controller's Verifier. > int resolveExtension(String extension) { return verifier.resolveExtension(extension); } < ---- domain verbs (thin wrappers over the inherited dispatch gate) --- > < decode(id) / encode(id): a codec's domain operations. Both are gated by the > < shared dispatchCode(): -2 invalid, -5 not loaded, -1 backend absent, 0 ok. > int decode(int id) { return dispatchCode(id); } int encode(int id) { return dispatchCode(id); } < ---- identity + result text ----------------------------------------- > String serviceName() { return "SLCodecController"; } < Human-readable text for a result code (via the wired Verifier, which uses > < the shared SLServiceResult vocabulary). > String resultText(int code) { return verifier.resultText(code); } }