I have tried to update the wiki page and realized that the whole system is quite messy.
This awful system of translating one values to other values, with total confusion of EAX / EFX values...
And no presets, that's why Judith had to translate them by hand (sorry for that).
I simply don't know how to update the section on properties now.
I think for 2.07 it would make sense to do the following:
- Implement a new set of properties, which will have exactly the same names as the EFX constants (without the leading "AL_EAXREVERB_"). These properties would be passed to EFX as is, no need to convert bells to dolls.
- Implement a "preset" property, similar to what "environment" property meant before EFX update killed it. Enumerate all presets listed in efx-presets.h and make them all available by number.
- All of these changes will be available when "Version 2" is specified in the first line of the file. The "Version 1" definitions continue to work as they do now (forever).
If we do this, then we can simply reference the OpenAL EFX manual in wiki, which already has detailed explanation of all properties.
Also, we can list preset names with their numbers in the wiki --- mappers will most likely simply use this number. The number of available presets will increase of course.
The possible downside is breaking compatibility with Doom 3 and EAX (although kcat recently noted that at least one property is converted incorrectly from EAX to EFX, so EAX compatibility is not perfect now).
But I have a feeling that both are rather dead now, so maintaining this compatiblity does not provide us with any additional knowledge of EFX.
P.S. If we recall another TODO for 2.07, then it is a global revision of all stock sound shaders and putting no_efx in some.