history-museum/winamp
1
0
Fork 0
mirror of https://github.com/WinampDesktop/winamp.git synced 2025-06-17 10:15:47 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

Initial community commit

Browse Source
This commit is contained in:
Jef
2024-09-24 14:54:57 +02:00
parent 537bcbc862
commit 20d28e80a5
16810 changed files with 4640254 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
Src/Agave/Encode/notes.txt Normal file
View File

@ -0,0 +1,23 @@
notes for encoders
====
two types of encoders:
1) File encoders. These write directly to a file.
2) Stream encoders. These return the encoded audio data in a user-provided buffer
For example, an AAC encoder could implement a file encoder for MP4/M4A files, but these aren't streamable.
ADTS AAC however, would be streamable.
====
Two ways of feeding the data
1) Push model. The user of the class passes data in a user-owned data buffer.
2) Pull model. The implementor of the class pulls data from a user-provided callback (data is stored in an implementor-owned buffer)
Push encoders should be used when the incoming audio data is not immediately available (live recording, CD ripping).
Pull encoders should only be used when all the audio data is immediately available (e.g. WAV file).
When in doubt, use a push encoder. Pull encoders offer a potential advantage of better memory usage (fewer memcpy's in most implementations), but a push encoder should serve all needs.
====
Note that encoders should be as non-blocking as possible (except for, obviously, computation, file I/O and thread synchronization for multi-core-aware encoders).
It it not reommended to Sleep(), select() [network I/O], etc. Stick to what the API was designed for :)