annotate foosdk/sdk/foobar2000/SDK/audio_postprocessor.h @ 1:20d02a178406 default tip

*: check in everything else yay
author Paper <paper@tflc.us>
date Mon, 05 Jan 2026 02:15:46 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
1 #pragma once
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
2
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
3 #include "audio_chunk.h"
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
4 #include "mem_block_container.h"
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
5
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
6 //! This class handles conversion of audio data (audio_chunk) to various linear PCM types, with optional dithering.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
7 class NOVTABLE audio_postprocessor : public service_base
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
8 {
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
9 public:
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
10 //! Processes one chunk of audio data.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
11 //! @param p_chunk Chunk of audio data to process.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
12 //! @param p_output Receives output linear signed PCM data.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
13 //! @param p_out_bps Desired bit depth of output.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
14 //! @param p_out_bps_physical Desired physical word width of output. Must be either 8, 16, 24 or 32, greater or equal to p_out_bps. This is typically set to same value as p_out_bps.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
15 //! @param p_dither Indicates whether dithering should be used. Note that dithering is CPU-heavy.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
16 //! @param p_prescale Value to scale all audio samples by when converting. Set to 1.0 to do nothing.
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
17
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
18 virtual void run(const audio_chunk & p_chunk,
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
19 mem_block_container & p_output,
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
20 t_uint32 p_out_bps,
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
21 t_uint32 p_out_bps_physical,
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
22 bool p_dither,
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
23 audio_sample p_prescale
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
24 ) = 0;
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
25
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
26
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
27
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
28 FB2K_MAKE_SERVICE_COREAPI(audio_postprocessor);
20d02a178406 *: check in everything else
Paper <paper@tflc.us>
parents:
diff changeset
29 };