in_opus 0.911

• FIXED: Now url streams should work with MediaMonkey.

• FIXED: The plugin should be compatible with MediaMonkey again. It will be
  in my test list from now, even though MediaMonkey 5 will have native opus
  support.

• NEW: Now the average bitrate can be displayed instead of the instant
  bitrate, set INSTANT_BR=0 in the [IN_OPUS] section of winamp.ini.

• NEW: An option was added to load files with .ogg extension. The option is
  not enabled by default because the plugin will have to open all the ogg
  files to check if they are opus files. Write OGGEXT_HACK=1 in the [IN_OPUS]
  section of the winamp.ini file if you want to enable it.
  Note1: In Winamp 5.x, there will be conflicts with the tags when you mix
  both king of .ogg files, this will lead to tags being not shown for
  the second type of file you load in the session. All files will play though.
  Note2: This is not an issue on Winamp 2.x.

• NEW: The playlist entry will display proper format under winamp 5.x, because
  the winampGetExtendedFileInfo function was implemented.

• NEW: Unified dialog on "Alt+3" can be enabled for Winamp 5.5+ now setting
  the UNIFIED_DIALOG=1 in the [IN_OPUS] section of the winamp.ini file.

== UPDATE 0.892 ==

This is mostly a bug-fix update. Most significantly I would say, is the fix
of long durations. Due to integer overflow, in theory the longest file that
can be played is 2^31 - 1 ms ie ~25 days. I came along a 27day recording,
and decided to fix the bug. Not that I think many of you will need that, but
it costs nothing to share right? The other addition is the support of 24b and
32b output, use the OUT_BITS option. So if you hardware supports 24 or 32b
output, go for it. However keep in mind tht the EQ shall work only for 16b
output on Winamp2.x and will work on 16 and 24b output on Winamp5.3+.

• UPDATE: Now using opusfile 0.12 (with modifications)

• NEW: Support for 8, 24 and 32 bits decoding resolution, the default is
  always 16b. Add the option OUT_BITS=value in the [IN_OPUS] section of
  your .ini file to use this option.

• FIXED: Now dithering is applied even when resampling is used. Note that
  It is not very useful as resampling error tends to make bigger artefacts
  than quantization error. In addition, noise-shaping will be used only for
  16b:48kHz outpt mode, which is the default since the first version.

• FIXED: Now the user's session winamp.ini file will be read. This concerns
  Winamp 5.11+, and when the 'paths.ini' file is in winamp's directory.

• FIXED: Now WACUP users should have Unicode filename enabled by default.

• FIXED: Crash in some conditions. Now the plugin is compatible with XMPlay,
  this is not really useful because of XMPlay's native support for opus.
  However this can fix problems people experienced in some cases with Winamp.

• FIXED: Unnecessary bloat to the dll removed using gcc's -flto option.

• FIXED: The 24 days 20 h 31 min 24 s and 647 ms maximum duration bug.
  Actually, for any length greater than that, time will be displayed in
  hrs:min instead of min:sec format, this applies when jumping in the file
  with Ctrl+J option as well. Now the new limit for track time is thus 60x
  greater hence: 4 years 1 month 1 days 7 h 23 min 38 s and 820 ms.
  Yep u can laugh.
  Note1: the [h:min] flag will be added at the end of the playlist name.
  Note2: Visualisation will look wrong in this context.

• FIXED: Possible memory leaks.

• FIXED: Problem in the resampling code that would lead to NULL output in
  some cases. This should cure random 'not working' when using resampling.

• FIXED: Now the error code will no longer be automatically displayed in
  the PL for the URL streams, because it does causes performances problems.
  The error details will still be displayed in the Info dialog on "Alt+3".

== UPDATE 0.888 ==

This is again a recommended update because it fixes a major interference bug
that might prevent other plugins to load URL streams.

• NEW: Error message will be displayed in the PL when a stream is offline,
  invalid, has a bad header, etc.

• NEW: Added Shoutcast/Icecast server info in the info dialog Box (Alt+3).
  In addition proper error will be displayed in the playlist when a radio
  stream is offline or if it is not an opus stream.

• NEW: Added TARGET_LUFS config variable so that you can decide the target
  loudness at which to play opus files when RG info is available and RG is
  enabled.

• NEW: the plugin will also read the in_opus.ini config file in the plugin
  directory prior to the winamp.ini. If you write options in both files,
  the ones in winamp.ini will dominate when the concerned option is the same,
  otherwise all parameters will be read.

• FIXED: now the plugin should no longer risk to interact with other radio
  streams that he cannot handle. This implies that if the url does not end
  with .opus the plugin will not try to load the url.

  NOTE: If you have an opus stream that does not end with .opus, append
  the string ">.opus" or "?.opus" at the end of URL in order to force
  in_opus to load it.
  eg: "http://ivyrd.wtju.net:8000/wtju-opus-256.ogg" is actually an opus
  stream even though it ends with .ogg (like ogg vorbis file)
  use: http://ivyrd.wtju.net:8000/wtju-opus-256.ogg>.opus to play it.
  In the rare case a radio streams ends with .opus but is not an opus stream,
  add "?.mp3" or "?.aac" to avoid in_opus try and open it.
  eg: http://nebula.shoutca.st:8751/aac320.opus is actually an aac stream,
  use: http://nebula.shoutca.st:8751/aac320.opus?.aac to play it
  eg2: http://radioilusion.es:8000/radioilusion.opus actually an ogg stream
  use: http://radioilusion.es:8000/radioilusion.opus?.ogg to play it

== UPDATE 0.777 ==

CHRISTMAS RELEASE...

• NEW: added an internal volume option, set INTERNAL_VOLUME=1 to enable. In
  this case the volume slider in winamp will adjust volume before decoding,
  this has some use if you want to manually avoid clipping while playing.
  With this option enabled the volume slider goes from -20dB to +0dB.

• NEW: Added resampling option, Now the output can be resampled at any
  sampling rate eg you can set 44100 Hz for compatibility with some old
  soundcards. Set the OUT_SAMPLERATE to the desired value in the [IN_OPUS]
  section of the winamp.ini file. You can also set the quality of resampling
  from 0 (low quality) to 4 (high quality with) the RESAMPLE_Q option.
  The default value is 2 as it already gives a good sound quality and higher
  values are much more CPU heavy. Up-sampling is also supported.

• NEW: PRE_GAIN is now reserved for files and RADIO_GAIN is used
  for radio streams, the default value for RADIO_GAIN is -3dB because
  I experienced a lot of clipping with the radio streams I listened to
  and -3dB is a good value in my opinion. If you want a specific RADIO_GAIN
  value, set it (in dB) in the winamp.ini file.

• NEW: added a value to USE_REPLAY_GAIN, set it to 4 to use the raw opus
  signal without the header gain. I do not recommend this option because the
  Header gain should always be applied, this value is here in case it is
  needed. eg: opus files with a completely broken Header gain.

• FIXED: invalid behaviour in reading .ini file in some conditions.

• FIXED: Now the PRE_GAIN is always applied, even when replay gain is
  disabled. this is useful if you have clipping problems and do not want
  to use replay gain, note that RADIO_GAIN is always applied when playing
  Radio streams.

• FIXED: Now the normal EQ (Winamp 4Front EQ) works on Winamp5.x with this
  plugin. It was a strange bug related to the Info display.

• FIXED: No more flickering of the menu-buttons at the bottom of the winamp
  playlist when playing opus file. Hopefully it should also fix the screen
  tearing some people experienced with previous versions.

== UPDATE 0.666 ==

This update is quite important as it enables UNICODE FILE NAME SUPPORT.
if you use winamp 5.3+ on Windows NT+. Normally you have nothing to do
as the default behaviour is to auto detect the proper conditions to enable
UNICODE filenames support.

This is also the "stable" release including RADIO STREAM SUPPORT.
Most of the work was to remove dependency to OpenSSL which is a pain
to build on windows especially on Win95. In addition OpenSSL is bloated
and unnecessary for my case as I never encountered HTTPS radio streams.

• NEW: Now you can enable support for UNICODE file names by adding the
  option UNICODE_FILE=1 in the [IN_OPUS] section of winamp.ini. You need
  Winamp 5.3 or greater AND windows NT/2000/XP/Vista/7/8/10. This option
  will not do anything under Windows 9x and plugin will fail to load
  if you are using a Winamp version smaller than 5.3 and enabled this option.
  set UNICODE_FILE=2 (default) to enable auto detection. Note that this
  detection is based on the "WHATSNEW.TXT" file in the Winamp directory.
  if the plugin cannot find the specified file it will assume no Unicode
  filenames. Finally set it to 0 if your system cannot handle UNICODE.

• NEW: Value added to the USE_REPLAY_GAIN option. Set it to 3 (Auto mode)
  and it will automatically pick the Album gain except when winamp is in
  Shuffle mode where it will chose the Track gain. This is very sensible
  in my opinion as the purpose of replay gain is to avoid volume changes
  between tracks. In this case if you listen to a full album, the volume
  between tracks will respect the original Album purpose and if you are
  randomly listening to tracks the individual track gain will be applied.

• FIXED: Now the plugin does not rely on Windows Socket 2 but is instead
  compatible with Windows Socket 1 that is included in Win95 by default.

• FIXED: Now the seek-bar is disabled in Radio mode.

• FIXED: Small change to the Info dialog box in the case of Radio streams.

== UPDATE 0.610 (open beta of beta) ==

• NEW: Added radio support. for the moment only http streams are supported.
  I release this version because I am not sure when I will have time to work
  more on the plugin (Hopefully soon). So keep an eye for Release.
  Of course any feedback will be welcome on this beta.

• NOTE: I could not test it at all on Win 9x as I am far from home.
  Theoretically it should work

== UPDATE 0.555 ==

• UPDATED: Now we use libopus 1.3.1 and libopusfile 0.11

• NEW: Added the option to disable dithering. Some people might prefer the
  the way it sounds and it does speed up decoding speed by 30-40%. Generally
  I would recommend to keep dithering enabled which was the behaviour of older
  releases. As usual do not specify a value in the .ini file if you want the
  default behaviour.

• FIXED: MinGW was generating improper code for windows 95. With some options
  checked, the plugin is now 95 compatible (Tested with Windows 95 OSR 2).

• FIXED: By default libopus does a lot of memory allocation on the stack,
  this is very prone to crash, the correct flag was passed to libopus-1.3.1
  to avoid excessive stack allocation. No performance decrease was observed.

• FIXED: The UTF-8 to ANSI conversion table was broken, now it seems correct.

• Small modification to the tag dialog to include more tags that I find
  useful. Labels and accelerators were added for all fields, press Alt+T
  to select Title, Alt+A for Artist, Alt+E for Description etc...

• NEW: Unicode is now supported under Windows NT OSes serie. Under Win98 you
  will still be limited to ANSI. An option was added to select the desired
  mode: TAGS_DISPLAY_MODE. Set it to 0 to dump the raw utf8 string in the
  dialog, hence the character 'é' will be displayed as 'é', not very nice.
  Set it to 1 to force the UTF8 -> ANSI conversion and set it to 2 to force
  the Full Unicode support (UTF-8 -> UTF16). this requires NT. by default the
  value is 3 meaning the program will automatically use full Unicode support
  on NT and convert to ANSI on Win98.

  • NOTE: On NT4 you will not have all Unicode but only USC-2 characters.
    Date, Tracks numbers and URL are always assumed to be ASCII.

• NEW: You can now select the font you Want, just add the line in winamp.ini
  in the section [IN_OPUS]:
  TAGS_FONT=10 Times New Roman
  the first is the size of the font, default is "8 MS Sans serif" you can
  specify a size (12 is the practical max) followed by the font name.
  if the size is 0, the plugin resets to default (8 MS Sans serif).

== UPDATE 0.444 ==

• FIXED: A few bugs in reading tags.

• NEW: ReplayGain supported, it uses the standard R128 tag, in 256th of dB
  there is no configuration box, if you want to enable replay gain, you have
  to write it directly in the Winamp.ini file in winamp's directory.
  If no parameters are written, no replay gain of any kind will be applied.
  The plugin will not write anything into winamp.ini, you have to write those
  options yourself and restart Winamp or go to the config dialog box of
  in_opus, this will read the configuration, you will need to stop and start
  playback again though.

Open "winamp.ini" with notepad and paste at the end the following 4 lines:

[IN_OPUS]
USE_REPLAY_GAIN=1
PRE_GAIN=0.0
THREAD_PRIORITY=1

to use Album gain, set USE_REPLAY_GAIN=1 and set it to 2 for track gain,
or 0 to disable replay gain.

the PRE_GAIN value is a preamplification factor in dB that is applied before
the gain. you should consider putting a negative value if you experience
clipping problems. A common value is -6dB (ultra safe, very rare clipping)
0 is usually OK because the gain is almost always negative anyway.
You should use the same parameters with the others plugins.
If you are reading this, it means you know what you are doing anyway.

You can set the decode priority thread (default is 1, above normal) other
values are: -2: Lowest, -1 Below Normal; 0 Normal; 1 Above Normal; 2 Higher
You can also try -15: Idle or +15: Real Time (not recommended)

Note: the tags name are R128_ALBUM_GAIN and R128_TRACK_GAIN,
the value should be an ASCII string representing in decimal form
a signed 16-interer value in 256th of dB.

  I found foobar2k directly modify the opus specific header gain meaning
  that it will adjust the gain, setting the Album tag value to 0 and the
  track with the correct relative value.
  This is quite strange but why not...

== 0.333 initial release ==