Ogg (.ogg, .ogv, .ogx, .ogm)
Background & Context

-
- Registered MIME type: video/ogg
- Multimedia container format.
- Can contain multiple video and audio tracks.
- Designed to be used for efficient streaming.
- Supports a variety of video and audio codecs.
- Developed and maintained by Xiph.Org Foundation.
Import & Export

- Import["file.ogg"] imports an Ogg file and returns a Video object.
- Import["file.ogg",elem] imports the specified elements.
- The import format can be specified with Import["file","Ogg"] or Import["file",{"Ogg",elem,…}].
- Export["file.ogg",expr] exports a Video object, list of graphics or images, or a Manipulate expression to the Ogg format.
- Export["file.ogg",expr,"Ogg"] can also be used to export to an Ogg file.
- Export["file.ogg",{expr1,expr2,…}] exports a list of arbitrary expressions to Ogg.
- When exporting a list {expr1,expr2,…}, the video is composed from still pictures corresponding to rasterized images of the expri.
- The duration of the Ogg video is determined from the number of frames and the specified frame rate.
- The exported Ogg video will play at the same speed and will have the same size as the Manipulate object.
- If bookmarks are set in the Manipulate object, Export will create an Ogg file by interpolating between the bookmarks while preserving the speed and duration of the Manipulate.
- Export["file.ogg",{elem1expr1,elem2expr2,…}],"Rules"] uses rules to specify the elements to be exported.
- See the reference pages for full general information on Import and Export.
- ImportString and ExportString support the Ogg format.
Import Elements



- General Import elements:
-
"Elements" list of elements and options available in this file "Rules" full list of rules for each element and option "Options" list of rules for options, properties and settings - Video representation elements:
-
"ImageList" frames represented as a list of images "Video" video file represented as a Video object "VideoData" array of raw bitmap data for each frame "VideoStream" a handle to the video file as a VideoStream object - Audio representation elements:
-
"Audio" in-core Audio object "AudioData" array of audio samples "AudioFile" out-of-core Audio object - Import by default uses the "Video" element if the file has a video track and otherwise uses the "Audio" element.
- A video file may contain multiple video, audio or subtitle tracks. Elements that return the number of tracks:
-
"AudioTrackCount" number of audio tracks "VideoTrackCount" number of video tracks - Video metadata elements:
-
"BitDepth" bits used to represent each color channel in the file "ColorSpace" color encoding used in the file "FrameCount" number of frames in the file "FrameDurations" list of display durations given for each frame "FrameRate" number of frames to be displayed per second "RasterSize" raster dimensions "VideoEncoding" video codec used in the file - Audio metadata elements:
-
"AudioChannels" number of audio channels "AudioBitDepth" bits used to represent each audio sample "AudioEncoding" audio codec used in the file "AudioLength" number of audio samples "BitRate" number of bits per second "SampleRate" number of audio samples per second - Additional metadata elements:
-
"ExactDurations" an association of exact durations for all video, audio and subtitle tracks "Duration" approximate duration of the video given in seconds "MetaInformation" metadata interpreted as quantities, locations, dates, numbers, etc. "RawMetaInformation" uninterpreted metadata as strings and numbers "Summary" summary of the file - $VideoDecoders and $AudioDecoders give a list of decoders available on your computer system.
Options


- General Import options:
-
AudioTrackSelection 1 audio tracks of interest "ImageTopOrientation" Automatic orientation of the video as stored in the file RasterSize Automatic raster dimensions VideoTrackSelection 1 video tracks of interest - Import options for the "Audio" element:
-
"AudioChannels" Automatic number of audio channels SampleRate Automatic samples per second for each channel - General Export options:
-
AudioEncoding Automatic audio encoding for file Background Automatic background color CompressionLevel Automatic compression level to use FrameRate Automatic number of frames shown per second RasterSize Automatic pixel dimensions SampleRate Automatic samples per second for each channel VideoEncoding Automatic video encoding for file - Export options for the "Video" and "VideoStream" elements:
-
AudioTrackSelection All audio tracks of interest VideoTrackSelection All video tracks of interest - Export options when exporting Manipulate expressions:
-
"AnimationDuration" Automatic total animation duration "ControlAppearance" "Generic" how Manipulate control elements are rendered in the exported file - The following settings can be given for "ControlAppearance":
-
Automatic captures user controls exactly as seen in the notebook interface, using the style elements of the local computer system "Generic" renders graphical controls in a generic style None excludes control elements when exporting an animation - $VideoEncoders and $AudioEncoders give a list of encoders available on your computer system.
Examples
open allclose allBasic Examples (4)
Scope (3)
Import a list of video frames:
Import the first 10 seconds of audio data:
Export a Manipulate to Ogg:
Import Elements (28)
Video Elements (3)
"Video" (1)
Import as a Video object:
This is the default import element when at least one video track is available:
"VideoData" (1)
Import video data corresponding to specified frames:
Convert video data stored in a NumericArray object to an image:
"VideoStream" (1)
Number of Tracks (2)
Metadata Elements (7)
"Duration" (2)
"ExactDurations" (2)
Video Tracks (7)
"VideoEncoding" (1)
Audio Tracks (7)
Import Options (7)
AudioTrackSelection (1)
By default, Import extracts data only from the first audio track:
Use the AudioTrackSelection option to extract data from specified audio tracks:
"ImageTopOrientation" (1)
RasterSize (1)
SampleRate (1)
VideoTrackSelection (1)
By default, Import extracts data only from the first video track:
Use the VideoTrackSelection option to extract data from specified video tracks:
Export Options (11)
"AnimationDuration" (1)
Specify the duration of exported Manipulate expressions:
AudioTrackSelection (1)
Background (1)
CompressionLevel (1)
Use the CompressionLevel option to control the file size and the quality of a generated video:
"ControlAppearance" (1)
An animation exported with the default setting "ControlAppearance""Generic" will look the same regardless of the computer system on which it was created:
With "ControlAppearance"None, no user controls are included in the exported video:
FrameRate (1)
By default, the frame rate is preserved when exporting Video or VideoStream objects:
RasterSize (1)
By default, the raster size is preserved when exporting Video or VideoStream objects:
SampleRate (1)
By default, the sample rate is preserved when exporting Video, VideoStream or Audio objects: