Difference between revisions of "Multimedia Files"

From FreeSpace Wiki
Jump to: navigation, search
m (fix title)
(rm silly windows convention of namimg filetypes after their extensions, and cleanup)
Line 1: Line 1:
The FreeSpace 2 Open engine is able to use several different '''mediamedia file formats''' for audio, animation and video playbacks. Retail FreeSpace 2 used the [[Wikipedia:Wav|.WAV]] and '''.ANI''' file formats, but the currently the FreeSpace 2 Open supports several [[Wikipedia:Ogg|.OGG]] container files as well. Support for [[Wikipedia:Mp3|.MP3]] file format was removed in favor of the .OGG. Game engine also supports special '''.EFF''' animations.
+
The FreeSpace 2 Open engine is able to use several different '''multimedia file formats''' for audio, animation and video playback. Retail FreeSpace 2 used the [[Wikipedia:Wav|WAV]] and '''ANI''' file formats, but the currently the FreeSpace 2 Open supports several [[Wikipedia:Ogg|Ogg]] container files as well. Support for the [[Wikipedia:Mp3|MP3]] file format was removed in favor of Ogg. The game engine also supports special '''.EFF''' animations.
  
==OGG==
+
==Ogg==
'''.OGG''', or Ogg (see [[Wikipedia:Ogg|Ogg file format]]), is a file format for compressed multimedia files and a popular competitor to [[Wikipedia:Mp3|.MP3]].  Unlike MP3, Ogg uses an open-source, open-standard format and a permissive license, both of which allow it to be incorporated into the FS2_Open source code.  Also unlike MP3, Ogg is a [[Wikipedia:Container_format|container format]], meaning that it can contain video data (via the [[Wikipedia:Theora|Theora codec ]]) in addition to audio data (via the [[Wikipedia:Vorbis|Vorbis codec]]).
+
'''Ogg''' is a file format for compressed multimedia files.  Unlike MP3, Ogg is an open-source, open-standard container format with a permissive license, both of which allow it to be incorporated into the FS2_Open source code.  Also unlike MP3, Ogg is a [[Wikipedia:Container_format|container format]], meaning that it can contain video data (via the [[Wikipedia:Theora|Theora codec ]]) in addition to audio data (via the [[Wikipedia:Vorbis|Vorbis codec]]).
  
Since Ogg delivers significantly smaller file sizes than [[Wikipedia:Wav|.WAV]], while retaining substantially the same level of audio quality, it is becoming more and more frequently used in FSO-targeted mods.  Ogg is not, however, a lossless format -- i.e., it is not possible to exactly reconstruct the original data from an .OGG file because some is "lost" in the conversion process.  This is not usually a problem, however, because a high-quality .OGG file is usually indistinguishable from the source.  The lossless counterpart to Ogg Vorbis is [[Wikipedia:Free_Lossless_Audio_Codec|.FLAC]], which can be contained in Ogg also.
+
Since Ogg delivers significantly smaller file sizes than [[Wikipedia:Wav|WAV]], while retaining substantially the same level of audio quality, it is becoming more and more frequently used in FSO-targeted mods.  Ogg Vorbis is not, however, a lossless format -- i.e., it is not possible to exactly reconstruct the original data from an Ogg Vorbis file because some is "lost" in the conversion process.  This is not usually a problem, however, because a high-quality Ogg Vorbis file is usually indistinguishable from the source.  The lossless counterpart to Ogg Vorbis is [[Wikipedia:Free_Lossless_Audio_Codec|FLAC]], which can be contained in Ogg also.
  
 
Vorbis uses a quality parameter between -1 and 10 as a measure of quality. 5 is the default, giving around 160kbps. The higher the number, the higher the quality, but anything over 5 is probably pointless.
 
Vorbis uses a quality parameter between -1 and 10 as a measure of quality. 5 is the default, giving around 160kbps. The higher the number, the higher the quality, but anything over 5 is probably pointless.
  
Audacity and Goldwave are two popular programs that allow .WAV files to be converted to .OGG Vorbis audio.  Audacity is Free Software, while Goldwave is shareware that ceases to function after a period of time. [http://www.rarewares.org/ogg-oggdropxpd.php oggdropXPd] is an useful drag-and-drop encoder.
+
Audacity and Goldwave are two popular programs that allow WAV files to be converted to Ogg Vorbis audio.  Audacity is Free Software, while Goldwave is shareware that ceases to function after a period of time.
  
 
Please note that this is a fso feature and is not supported by the original retail FreeSpace 2.
 
Please note that this is a fso feature and is not supported by the original retail FreeSpace 2.
  
 
==WAV==
 
==WAV==
The most common sound file format. WAVs are uncompressed and take up a larger amount of space than almost any other sound file type, so consider converting them to the [[*.OGG|.OGG]] format (supported only by SCP) before including them in your campaign. Audacity and Goldwave are two examples of programs that can make this conversion. [http://www.rarewares.org/ogg-oggdropxpd.php oggdropXPd] is an useful drag-and-drop encoder.
+
The most common sound file format. WAVs are uncompressed and take up a larger amount of space than almost any other sound file type, so consider converting them to the [[*.OGG|Ogg]] Vorbis format (supported only by SCP) before including them in your campaign. Audacity and Goldwave are two examples of programs that can make this conversion. [http://www.rarewares.org/ogg-oggdropxpd.php oggdropXPd] is an useful drag-and-drop encoder.
  
 
==ANI==   
 
==ANI==   
FreeSpace uses the .ANI format for animation effects. It can be used either for an effect (explosions, etc.), an interface animation, or as a ship texture.
+
FreeSpace uses the ANI format for animation effects. It can be used either for an effect (explosions, etc.), an interface animation, or as a ship texture.
*[http://www.swooh.com/lorenzo/files/aniview11.exe AniView, an ANI-viewing utility]
 
*[http://www.swooh.com/lorenzo/files/anib32b2.exe AniBuilder, a utility that can create ANI files out of a series of 16 bit images]
 
  
 
===Creating an ANI file===
 
===Creating an ANI file===
  
Using AniBuilder (link provided above), one can create new .ANI files from .AVI movies.
+
Using [http://www.swooh.com/lorenzo/files/aniview11.exe AniBuilder], one can create new ANI files from AVI movies.
  
To create your own .ANI:
+
To create your own ANI:
  
 
#Set up a scene in a 3D animation program or in FreeSpace. Volition used [[Wikipedia:3ds_Max|3ds Max]] (an expensive modeling program) for their animations.
 
#Set up a scene in a 3D animation program or in FreeSpace. Volition used [[Wikipedia:3ds_Max|3ds Max]] (an expensive modeling program) for their animations.
Line 32: Line 30:
  
 
==EFF==
 
==EFF==
FreeSpace 2 uses the .EFF ASCII format text files to store information about animated effects. These animated effects can be used for various effects such as in game animations and animated textures. Please note that this is a fso feature and is not supported by the original retail FreeSpace 2.
+
FreeSpace 2 uses the EFF ASCII format text files to store information about animated effects. These animated effects can be used for various effects such as in game animations and animated textures. Please note that this is a fso feature and is not supported by the original retail FreeSpace 2.
  
 
===Creation of EFF animation===
 
===Creation of EFF animation===
 
*For EFF animation all the individual frames of the animation have to be present in one of the [[Graphic Files|graphic file formats]] supported by the game engine.
 
*For EFF animation all the individual frames of the animation have to be present in one of the [[Graphic Files|graphic file formats]] supported by the game engine.
*All files related to the .EFF animation have to named so that the name of actual .EFF animation forms the basic structure of the filename.  
+
*All files related to the EFF animation have to named so that the name of actual .EFF animation forms the basic structure of the filename.  
 
**'''Graphic files''' add the 4 digit number - that identifies the frame where the file is used - after the animation name, starting from 0 (example_0000.dds, example_0001.dds etc.)
 
**'''Graphic files''' add the 4 digit number - that identifies the frame where the file is used - after the animation name, starting from 0 (example_0000.dds, example_0001.dds etc.)
 
**'''ASCII file''' contains the information of the animation (example.eff)
 
**'''ASCII file''' contains the information of the animation (example.eff)
  
===Contents of .EFF file===
+
===Contents of a EFF file===
  
 
====$Type:====
 
====$Type:====
*Defines the file format of the graphics file used for the .EFF animation
+
*Defines the file format of the graphics file used for the EFF animation
 
*Syntax: '''''String''''', for example ''DDS''
 
*Syntax: '''''String''''', for example ''DDS''
  
Line 56: Line 54:
 
====Example====
 
====Example====
  
Let's say you have three .dds (tga and pcx are also acceptable) files (named 1_000, 1_0001, and 1_0002) you want to make into an animation, but you don't want to use anibuild and therefore comprimise quality.
+
Let's say you have three dds (TGA and pcx are also acceptable) files (named 1_000, 1_0001, and 1_0002) you want to make into an animation, but you don't want to use anibuild and therefore compromise quality.
  
Your .eff file would be like this:
+
Your EFF file would be like this:
  
 
Filename (the filename, not information to be entered. This must match up with characters before _xxxx in frames): 1.eff
 
Filename (the filename, not information to be entered. This must match up with characters before _xxxx in frames): 1.eff
Line 66: Line 64:
 
  $FPS: 5
 
  $FPS: 5
  
This .eff effect file would display one frame after another at 5 frames a second, skipping back to the beginning at the end. Please note that .eff cannot be used for streaming files (head animations, icons, mainhall, cbanis, ect.) and is meant ONLY for weapon/explosion effects and animated textures.
+
This EFF effect file would display one frame after another at 5 frames a second, skipping back to the beginning at the end. Please note that EFF cannot be used for streaming files (head animations, icons, mainhall, cbanis, ect.) and is meant ONLY for weapon/explosion effects and animated textures.
  
 
[[Category:File Types]]
 
[[Category:File Types]]

Revision as of 11:17, 22 May 2008

The FreeSpace 2 Open engine is able to use several different multimedia file formats for audio, animation and video playback. Retail FreeSpace 2 used the WAV and ANI file formats, but the currently the FreeSpace 2 Open supports several Ogg container files as well. Support for the MP3 file format was removed in favor of Ogg. The game engine also supports special .EFF animations.

Ogg

Ogg is a file format for compressed multimedia files. Unlike MP3, Ogg is an open-source, open-standard container format with a permissive license, both of which allow it to be incorporated into the FS2_Open source code. Also unlike MP3, Ogg is a container format, meaning that it can contain video data (via the Theora codec ) in addition to audio data (via the Vorbis codec).

Since Ogg delivers significantly smaller file sizes than WAV, while retaining substantially the same level of audio quality, it is becoming more and more frequently used in FSO-targeted mods. Ogg Vorbis is not, however, a lossless format -- i.e., it is not possible to exactly reconstruct the original data from an Ogg Vorbis file because some is "lost" in the conversion process. This is not usually a problem, however, because a high-quality Ogg Vorbis file is usually indistinguishable from the source. The lossless counterpart to Ogg Vorbis is FLAC, which can be contained in Ogg also.

Vorbis uses a quality parameter between -1 and 10 as a measure of quality. 5 is the default, giving around 160kbps. The higher the number, the higher the quality, but anything over 5 is probably pointless.

Audacity and Goldwave are two popular programs that allow WAV files to be converted to Ogg Vorbis audio. Audacity is Free Software, while Goldwave is shareware that ceases to function after a period of time.

Please note that this is a fso feature and is not supported by the original retail FreeSpace 2.

WAV

The most common sound file format. WAVs are uncompressed and take up a larger amount of space than almost any other sound file type, so consider converting them to the Ogg Vorbis format (supported only by SCP) before including them in your campaign. Audacity and Goldwave are two examples of programs that can make this conversion. oggdropXPd is an useful drag-and-drop encoder.

ANI

FreeSpace uses the ANI format for animation effects. It can be used either for an effect (explosions, etc.), an interface animation, or as a ship texture.

Creating an ANI file

Using AniBuilder, one can create new ANI files from AVI movies.

To create your own ANI:

  1. Set up a scene in a 3D animation program or in FreeSpace. Volition used 3ds Max (an expensive modeling program) for their animations.
  2. Using a free recording software such as for example GameCam to record the scene.
  3. Use for example Bink to convert the AVI into a series of 16-bit (or less) PCX files, as AniBuilder will not accept non-PCX images, or images of more than 16 bit color depth.
  4. Use AniBuilder to convert the PCX files to an ANI.

EFF

FreeSpace 2 uses the EFF ASCII format text files to store information about animated effects. These animated effects can be used for various effects such as in game animations and animated textures. Please note that this is a fso feature and is not supported by the original retail FreeSpace 2.

Creation of EFF animation

  • For EFF animation all the individual frames of the animation have to be present in one of the graphic file formats supported by the game engine.
  • All files related to the EFF animation have to named so that the name of actual .EFF animation forms the basic structure of the filename.
    • Graphic files add the 4 digit number - that identifies the frame where the file is used - after the animation name, starting from 0 (example_0000.dds, example_0001.dds etc.)
    • ASCII file contains the information of the animation (example.eff)

Contents of a EFF file

$Type:

  • Defines the file format of the graphics file used for the EFF animation
  • Syntax: String, for example DDS

$Frames:

  • Defines the length of the number of the frames in the animation
  • Syntax; Integer

$FPS:

  • Used optionally to define the frames per second value for the animation
  • Syntax: Integer

Example

Let's say you have three dds (TGA and pcx are also acceptable) files (named 1_000, 1_0001, and 1_0002) you want to make into an animation, but you don't want to use anibuild and therefore compromise quality.

Your EFF file would be like this:

Filename (the filename, not information to be entered. This must match up with characters before _xxxx in frames): 1.eff

$Type: DDS
$Frames: 3
$FPS: 5

This EFF effect file would display one frame after another at 5 frames a second, skipping back to the beginning at the end. Please note that EFF cannot be used for streaming files (head animations, icons, mainhall, cbanis, ect.) and is meant ONLY for weapon/explosion effects and animated textures.