Bug 1476 - Update OpenAL Headers
Summary: Update OpenAL Headers
Alias: None
Product: Joal
Classification: JogAmp
Component: core (show other bugs)
Version: 2.6.0
Hardware: All all
: P4 enhancement
Assignee: Mathieu Féry (MathiusD)
Depends on:
Reported: 2023-11-22 14:36 CET by Mathieu Féry (MathiusD)
Modified: 2023-11-28 21:05 CET (History)
3 users (show)

See Also:
SCM Refs:
Workaround: ---


Note You need to log in before you can comment on or make changes to this bug.
Description Mathieu Féry (MathiusD) 2023-11-22 14:36:35 CET
Bump OpenAL includes to latest version of openal-soft embedded, except for eax.h because usable reference header are located inside submodule openal-soft/al/eax/api.h but this header contains many symbol not processed by Gluegen like constexpr and other c++ feature

Following extensions has been added :
   * AL_EXT_BFORMAT -> https://github.com/Raulshc/OpenAL-EXT-Repository/blob/master/AL%20Extensions/AL_EXT_BFORMAT.txt
   * AL_EXT_MULAW_BFORMAT -> https://github.com/Raulshc/OpenAL-EXT-Repository/blob/master/AL%20Extensions/AL_EXT_MULAW_BFORMAT.txt
   * AL_SOFT_deferred_updates -> https://openal-soft.org/openal-extensions/SOFT_deferred_updates.txt
   * AL_SOFT_block_alignment -> https://openal-soft.org/openal-extensions/SOFT_block_alignment.txt
   * AL_SOFT_MSADPCM -> https://openal-soft.org/openal-extensions/SOFT_MSADPCM.txt
   * AL_SOFT_source_length -> https://openal-soft.org/openal-extensions/SOFT_source_length.txt
   * AL_SOFT_buffer_length_query -> https://openal-soft.org/openal-extensions/SOFT_buffer_length_query.txt
   * AL_SOFT_gain_clamp_ex -> https://openal-soft.org/openal-extensions/SOFT_gain_clamp_ex.txt
   * AL_SOFT_source_resampler -> https://openal-soft.org/openal-extensions/SOFT_source_resampler.txt
   * AL_SOFT_source_spatialize -> https://openal-soft.org/openal-extensions/SOFT_source_spatialize.txt
   * AL_SOFT_direct_channels_remix -> https://openal-soft.org/openal-extensions/SOFT_direct_channels_remix.txt
   * AL_SOFT_bformat_ex -> https://openal-soft.org/openal-extensions/SOFT_bformat_ex.txt
   * AL_SOFT_effect_target -> https://openal-soft.org/openal-extensions/SOFT_effect_target.txt
   * AL_SOFT_callback_buffer -> https://openal-soft.org/openal-extensions/SOFT_callback_buffer.txt
   * AL_SOFT_UHJ -> https://openal-soft.org/openal-extensions/SOFT_UHJ.txt
   * AL_SOFT_UHJ_ex -> https://openal-soft.org/openal-extensions/SOFT_UHJ_ex.txt
   * AL_SOFT_source_start_delay -> https://openal-soft.org/openal-extensions/SOFT_source_start_delay.txt
   * ALC_EXT_DEFAULT_FILTER_ORDER -> https://github.com/Raulshc/OpenAL-EXT-Repository/blob/master/ALC%20Extensions/ALC_EXT_DEFAULT_FILTER_ORDER.txt
   * ALC_SOFT_pause_device -> https://openal-soft.org/openal-extensions/SOFT_pause_device.txt
   * ALC_SOFT_HRTF -> https://openal-soft.org/openal-extensions/SOFT_HRTF.txt
   * ALC_SOFT_output_limiter -> https://openal-soft.org/openal-extensions/SOFT_output_limiter.txt
   * ALC_SOFT_device_clock -> https://openal-soft.org/openal-extensions/SOFT_device_clock.txt
   * ALC_SOFT_loopback_bformat -> https://openal-soft.org/openal-extensions/SOFT_loopback_bformat.txt
   * ALC_SOFT_reopen_device -> https://openal-soft.org/openal-extensions/SOFT_reopen_device.txt
   * ALC_SOFT_output_mode -> https://openal-soft.org/openal-extensions/SOFT_output_mode.txt
Comment 1 Mathieu Féry (MathiusD) 2023-11-22 14:38:33 CET
I've made a patch available here : https://github.com/MathiusD/joal in 1476-bump-al-headers
Comment 2 Julien Gouesse 2023-11-23 10:02:05 CET
(In reply to Mathieu Féry (MathiusD) from comment #1)
Comment 3 Sven Gothel 2023-11-26 09:31:01 CET
I knew one should update the extensions 
when I added AL_SOFT_events extension for our ALAudioSink,
but .. ;-)
Comment 4 Mathieu Féry (MathiusD) 2023-11-27 13:52:37 CET
Yes, I understand, AL_SOFT_events are very useful :)
Btw, the next openal-soft version, atm unreleased, contains new extensions :
 * ALC_EXT_debug
 * ALC_SOFT_system_events
Both seems very useful!
Comment 5 Sven Gothel 2023-11-28 12:36:47 CET
Thank you!


commit 4c286a85fb8b8e469d39de1811c2daebcc534a37

    Bug 1476: Reviewed updated OpenAL header (extensions) via make/scripts/cmpOld2New.sh
    No API change of old methods or fields!
Comment 6 Sven Gothel 2023-11-28 12:46:39 CET
(In reply to Mathieu Féry (MathiusD) from comment #4)
While I am snooping through OpenAL-Soft git commits,
I see that Chris works on supporting EAX now?
Hence .. shall we revert Bug 1477 and leave it in?
Comment 7 Sven Gothel 2023-11-28 13:02:23 CET
(In reply to Sven Gothel from comment #6)
btw, nice stuff Mathieu https://github.com/kcat/openal-soft/commit/c03603b58d4cf6a25d36bca00305970bc9f163b4
Comment 8 Mathieu Féry (MathiusD) 2023-11-28 17:03:11 CET
(In reply to Sven Gothel from comment #7)
Thanks! :) (Even though we've talked more about specification than coding per se xD)
Comment 9 Mathieu Féry (MathiusD) 2023-11-28 17:09:34 CET
(In reply to Sven Gothel from comment #6)
I must admit that I hadn't found a C header, but only this file in openal-soft: al/eax/api.h, which contains a large number of keywords not managed by Gluegen. And it seems to me that by default Chris only compiles the EAX API for Windows targets (although this can be changed in the compilation options of the Jogamp fork).
So I'm not sure whether to revert Bug 1477 or update the EAX headers? (for example, based on the DOOM3 headers quoted in the file I mentioned earlier, as I must confess I haven't found the original header files :c)
Comment 10 Sven Gothel 2023-11-28 21:05:31 CET
(In reply to Mathieu Féry (MathiusD) from comment #9)
yeah, let's keep it as is now (dropped EAX)