Other projects

General changes:

• The prerequisites to run Ravioli Game Tools have changed:
  • The .NET Framework 4.5.1 or higher is now required.
  • The minimum supported operating system is now Windows 7 with SP1 and update KB2758857.
  • The Visual C++ 2005 SP1 Runtime is no longer needed.

Framework changes:

• Added support for hybrid sound formats. The reported file type stays the same, while the actual sound format can vary between different files, similar to containers. This changes how the file type can be handled, for example the formats in which a sound can be converted to.
• When converting sounds, it is now possible to specify multiple sound formats to convert to. If a sound plug-in does not support converting a loaded sound to a target sound format, conversion to the next target sound format in the list is attempted.
• The CompressedItemsArchive class now allows specification of an alternate data file for extraction and a compression type for every item.
• Improved handling of nested archives for game viewers in AbstractorArchive class.
• The GenericArchive class now allows overriding the whole data extraction workflow implemented in the CopyData method. Overriding CopyData should be done with care and the only use case where this was required so far was to switch the input stream on the fly.

Ravioli Explorer application changes:

• Added an extraction option "Fallback sound format". If conversion of a sound to a specified target sound format is not supported, the application attempts to convert to the specified fallback format.
• Fixed a problem with sorting the file list by size if there are files with unknown size.
• Added a cache that improves performance for navigating the directory tree of large archives (more than 100000 files).

Ravioli Extractor application changes:

• Added an extraction option "Fallback sound format" (command line: /fallbacksoundformat or /fsf). If conversion of a sound to a specified target sound format is not supported, the application attempts to convert to the specified fallback format.

Changes in file format support:

• Added archive format: League of Legends WPK File (*.wpk)
  • Usually contains files of type "Wwise Encoded Media" (*.wem)

• Added archive format: League of Legends WAD File (*.wad)
  • This format does not contain file names, only numeric identifiers.
  • Files with the same identifiers would have the same file names. The file extensions are determined from the content.
  • Files with unidentified content are assigned the file extension ".dat".
  • Format versions 2 and 3 are supported.

• Added archive format: League of Legends RAF File (*.raf)
  • The uncompressed sizes of the files in this format are not known.

• Added game viewer: League of Legends
  • All versions of plug-in assets and file archives are combined in ascending order. Files in newer versions replace existing older files.

• Added archive format: Minecraft PCK File (*.pck)
  • Metadata is presented as text files (*.txt) along with the original items, encoded as UTF-8.
  • Tested with files from PlayStation 3, Wii U and Xbox 360 versions.

• Updated image format: DirectDraw Surface (*.dds)
  • Added a workaround to allow loading of DDS files created by older versions of ImageMagick (before version 6.3.9-3), as these versions produce DDS files with malformed headers.
  • The DDS scanner was also updated to be able to detect such malformed DDS files.

• Added sound format: Wwise Encoded Media (*.wem)
  • This is the official name and file extension for Wwise sounds.
  • Replaces existing Wwise sound formats (Wwise PCM/ADPCM/Vorbis, *.wwise_p/a/v).
  • To convert sound from this format into the best possible target format, set "Ogg Vorbis" as target format and "Wave" as fallback format. Conversion to Wave is always possible.
  • The Wwise scanner was also updated to detect the new format.

• Updated archive format: Elite Dangerous OVL File (*.ovl)
  • Fixed reading audio banks.
  • Improved error message for unsupported resource types.

General changes:

• Beginning with this version, there is the official possibility for other software developers to write their own plug-ins for the Ravioli Game Tools. This is made possible using a separate Software Development Kit (SDK) download, called the "Ravioli SDK", which contains interface libraries, documentation and sample code.
  
  Experience in .NET programming, preferably in the C# language, is required. Using an appropriate development environment, like Microsoft Visual Studio, is highly recommended.
  
  The first version of the SDK supports only development of new archive plug-ins. Other Ravioli extension points are not officially supported until documented in the Ravioli SDK.

Framework changes:

• Added support for nested archives in Game Viewers in a generic way. Only one nesting level is supported.
• Added the possibility to specify multiple archive types for a file in Game Viewers. Only the plug-in for which the archive type is valid loads the file. An error occurs if the file is not valid for any of the specified types.
• The ArchiveBase class now implements a new set of operations to support opening an archive from a stream and not directly from a file, for example when using nested archives in a Game Viewer. This is an automatic opt-in for all archives based on ArchiveBase, but the individual archive implementations must still be written correctly to make this actually work.
• Added an archive base class CompressedArchive that supports archives whose items are compressed.
• Extended the sound player interface ISoundPlayer2 to also return the duration of a sound.

Ravioli Explorer application changes:

• The status bar in the preview and view windows now show also the duration of a sound.
• Fixed a crash that can occur when a potential long-running operation (opening an archive, for example) is already completed before the "Please wait" dialog is shown.
• If an image or sound conversion fails, the affected file is no longer extracted automatically without conversion.

Ravioli Extractor application changes:

• If an image or sound conversion fails, the affected file is no longer extracted automatically without conversion.

Ravioli Scanner application changes:

• Fixed a crash that can occur when a potential long-running operation (extracting, for example) is already completed before the "Please wait" dialog is shown.
• Improved the "Combine" function: The dialog to confirm enlarging a file that is smaller than the original file now contains a "Yes to all" button to enlarge all further files automatically without asking again.

Added support for archive, sound and image files:

• Archive types of the Saints Row series
  • Saints Row 3/4 BNK_PC (VWSB) File (*.bnk_pc)
  • Saints Row 3/4 BNK_PC (WWISE) File (*.bnk_pc)
  • Saints Row 3/4 STR2_PC File (*.str2_pc)
  • Saints Row 3/4 VPP_PC (SB) File (*.vpp_pc)
  • Saints Row 3/4 VPP_PC File (*.vpp_pc)
• Reverge Package File (*.gfs)
  • Used by games like Skullgirls.
• Elite Dangerous OVL File (*.ovl)
• FMOD Sample Bank (FSB3) (*.fsb, *.fsb3)
  • Used by games like BioShock.
  • This is a backport of the FSB4 format with the data structures updated to match the FSB3 format.
  • Only the file extraction from BioShock files has been tested. Sound playing and conversion should work in the same way as with FSB4.
• Wwise ADPCM (*.wwise_a)
  • Can be played and converted to Wave files within the application.
  • Conversion happens via the external tool wwise_ima_adpcm (v1.15).
  • The use of external tools requires writing the files to disk for any operation. This may cause delays for large files.
  • Tested with files from World of Tanks and Mass Effect 2.
  • The official file extension for all Wwise formats is WEM (Wwise Encoded Media), but this is not used here to be able to distinguish the Wwise formats easier.
• Wwise PCM (*.wwise_p)
  • Can be played and converted to Wave files within the application.
  • Some data is written to disk during the conversion. This may cause delays for large files.
  • Tested with files from Elite Dangerous.
  • The official file extension for all Wwise formats is WEM (Wwise Encoded Media), but this is not used here to be able to distinguish the Wwise formats easier.

Updated support for archive, sound and image files:

• Star Trek Online HOGG File (*.hogg)
  • Renamed from "STO HOGG File"
  • Fixed errors when opening files of this type.
• Star Trek Online WTEX Texture (*.wtex)
  • Renamed from "STO WTEX Texture".
• Tomb Raider Big File (*.000)
  • Improved file type recognition so that the program does no longer attempt to open arbitrary *.000 files.
• Wave (*.wav), MPEG Layer 3 Audio (*.mp3), Ogg Vorbis (*.ogg)
  • Updated to support reading the duration of a sound.
• Wwise Vorbis (*.wwise_v)
  • Updated to use the file extension .wwise_v instead of .wwise.
  • Updated to support reading the duration of a sound.
  • Updated ww2ogg to version 0.24 to support more file format variants.
  • Improved RevorbWrapper.
  • The official file extension for all Wwise formats is WEM (Wwise Encoded Media), but this is not used here to be able to distinguish the Wwise formats easier.
• Wwise Package File (*.PCK)
  • Renamed from "Wwise PCK File".
  • Updated to support PCK files of the game "Dishonored".
• FMOD Sample Bank (FSB4) (*.fsb, *.fsb4)
  • Updated to support 8-bit encoded raw PCM sounds.

Added new game viewers:

• Saints Row series
  • Saints Row: The Third
  • Saints Row: The Third - Initiation Station
  • Saints Row IV
  • Saints Row IV: Inauguration Station
  
  Nested sound files (*_media.bnk_pc) are loaded automatically. Nested texture files (*.str2_pc) are not loaded at all because the high number of small files make the loading process very long and navigation in the Explorer very slow.
• Skullgirls

Updated the following game viewers:

• Tomb Raider Legend, Anniversary and Underworld
  • Fixed loading errors when opening the viewer.
• Half-Life
  • Fixed loading errors because of the no longer existing "gldrv" directory in Steam versions.

Added scanning support for the following file types:

• Wwise ADPCM (*.wwise_a)
• Wwise PCM (*.wwise_p)

Updated scanning support for the following file types:

• Wwise Vorbis (*.wwise_v)
  • Updated to use the file extension .wwise_v instead of .wwise.

Framework changes:

• Scanning plug-ins are now loaded dynamically.
• If a conversion between two sound formats is not supported, the error message that is generated while extracting a file now contains the names of the formats involved.

Ravioli Explorer application changes:

• Fixed highlighting of installed games in the "Open Game" dialog on Windows 7.
• Added support for files in archives where the size is unknown at load time. The following behavior happens now for such files:
  • In the file list in details view, a question mark (?) is shown in the "Size" column.
  • The total size in the status bar at the bottom of the screen shows the known size plus a question mark to indicate that the total size is not exact (ex. "120 MB +?").
  • When previewing a file and the size of the file is found to be larger than the internal preview size limit while reading its contents, the content is discarded and the preview is skipped.
• Changed the default size of the "View" window to be the same as the "View" window in the "Ravioli Scanner" application.

Added support for archive, sound and image files:

• STO HOGG File (*.hogg) (Star Trek Online)
  • The main archive format for "Star Trek Online".
• STO WTEX Texture (*.wtex)
  • These textures are found inside STO HOGG files (*.hogg).
  • Multiple format versions of WTEX textures exist. Only the one format that uses DXT compression is supported.
• Wwise Vorbis (*.wwise)
  • Can be played and converted to Ogg Vorbis within the application.
  • Conversion happens via the external tools ww2ogg (v0.20) and revorb (v0.2).
  • The use of external tools requires writing the files to disk for any operation. This may cause delays for large files.
  • The files can be encoded in different variants, depending on the Wwise version used. To find the correct variant, multiple attempts to convert the sound may be required, and this may cause delays for large files.
  • Tested using files from Saints Row: The Third, Mass Effect 2 and Sleeping Dogs.

Updated support for archive, sound and image files:

• DirectDraw Surface (*.dds)
  • Added support for DDS alpha format (A8).
• Valve Pak (*.vpk)
  • Renamed from "Valve Pack File".
  • Updated to support format version 2.
  • Fixed failing to extract files if the VPK file name contains multiple underscores.
• Wwise Sound Bank (*.bnk) and Wwise PCK File (*.pck)
  • Wwise Vorbis files are now given a separate file extension (*.wwise) to distinguish them clearly from standard Wave files (*.wav).
  • Added a way to distinguish PC and Xbox 360 variants automatically. This is not 100 percent fail-safe but worked for all files it was tested with. Tested using files from Sleeping Dogs and Zumba Fitness Core (Xbox 360).
• FMOD Sample Bank (FSB4) (*.fsb, *.fsb4)
  • Renamed from "FSB4 Sound Bank".
  • Added support for Raw PCM and MPEG (MP2/MP3) formats.
  • Raw PCM sounds are converted to standalone Wave files (*.wav).
  • MP2/MP3 sounds (incl. streaming sounds) are converted to standalone files (*.mp2/*.mp3).
• Ogg Vorbis (*.ogg)
  • Allows exporting the sound in its own format, just copies the source data.
• MPEG Layer 3 Audio (*.mp3)
  • Allows exporting the sound in its own format, just copies the source data.

Added new game viewers:

• Star Trek Online
  • The sounds in the FSB files (*.fsb) cannot be listened to directly.
  • Not all texture formats are supported. In WTEX files (*.wtex), only one texture format is supported and HTEX files (*.htex) are not supported at all.
• Team Fortress 2
  • Only the SteamPipe version is supported, older GCF-based versions are not.
• Angry Birds

Updated the following game viewers:

• Updated the following game viewers to work with the new formats used by the SteamPipe content distribution system:
  • Half-Life
  • Half-Life: Counter-Strike
  • Half-Life: Opposing Force
  • Half-Life: Blue Shift
  • Half-Life: Source
  • Counter-Strike: Source
  • Half-Life 2
  • Half-Life 2: Episode One
  • Half-Life 2: Episode Two
  • Portal
  • Portal 2

  For the games "Half-Life", "Half-Life: Counter-Strike", "Half-Life: Opposing Force" and "Half-Life: Blue Shift", files for the optional "Half-Life High Definition Pack" are also loaded if they exist (in "valve_hd", "gearbox_hd" and "bshift_hd" subdirectories).

  For the game "Half-Life: Source", files for the optional "Half-Life High Definition Pack" are also loaded if they exist (in "hl1_hd" subdirectory).

Added scanning support for the following file types:

• FMOD Sample Bank (FSB4) (*.fsb)
  • Container format for audio files.
• FMOD Event File (*.fev)
  • This file type does not contain any multimedia content but is used together with FSB files.
• Wwise Vorbis (*.wwise)

Updated scanning support for the following file types:

• Added support for APEv2 tags in MPEG audio files (*.mp1/*.mp2/*.mp3)
  • If the tag is detected, it is saved along with the audio data.
  • The tag must be present after the audio data and must have a header.