3D: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Robot: Changing Category:XBMC Manual to Category:Manual; cosmetic changes)
m (xbmc -> kodi)
Line 1: Line 1:
{{mininav| [[Video library]] | [[Video playback|Playback]] }}
{{mininav| [[Video library]] | [[Video playback|Playback]] }}
<section begin="intro" />Starting in v13, XBMC supports a number of passive 3D video formats such as SBS, TAB, anaglyph or interlaced. This support extends to the XBMC GUI including subtitles and on-screen-controls.<section end="intro" />
<section begin="intro" />Starting in v13, Kodi supports a number of passive 3D video formats such as SBS, TAB, anaglyph or interlaced. This support extends to the Kodi GUI including subtitles and on-screen-controls.<section end="intro" />


== Interface and menus ==
== Interface and menus ==
{{incomplete}}
{{incomplete}}
Starting in XBMC v13 "Gotham", XBMC has 3D UI support
[[File:Over-under 3D.png|500px|right]]
[[File:Over-under 3D.png|500px|right]]
{{-}}
{{-}}


== 3D detection ==
== 3D detection ==
XBMC has three ways to detect whether a videofile is a 3D video.
Kodi has three ways to detect whether a videofile is a 3D video.
These methods are checked in the following order:
These methods are checked in the following order:


=== Embedded streaminfo ===
=== Embedded streaminfo ===
First, XBMC tries to detect the stereoscopic mode for a video when extracting streamdetails from the videofile.
First, Kodi tries to detect the stereoscopic mode for a video when extracting streamdetails from the videofile.


One of the supported fields is the 'Stereomode' field in the Matroska specification:
One of the supported fields is the 'Stereomode' field in the Matroska specification:
Line 21: Line 20:
When playing a video, you can bring up the [[Video playback#OSD video settings|video settings]] dialog to manually select the stereoscopic mode.
When playing a video, you can bring up the [[Video playback#OSD video settings|video settings]] dialog to manually select the stereoscopic mode.


If you've done this before, XBMC will remember this setting and use it as the second method to detect the stereoscopic mode of a videofile.
If you've done this before, Kodi will remember this setting and use it as the second method to detect the stereoscopic mode of a videofile.
=== Video filenames flags ===
=== Video filenames flags ===
{{see also|Naming video files}}
{{see also|Naming video files}}
The third and final method is detection through the filename of the video.
The third and final method is detection through the filename of the video.


XBMC uses regular expressions to check for certain flags in the filename.
Kodi uses regular expressions to check for certain flags in the filename.


In order to properly detect the stereomode, two tags need to be present in the filename.
In order to properly detect the stereomode, two tags need to be present in the filename.
Line 82: Line 81:
=== General ===
=== General ===
* Hardware acceleration is not provided for full SBS or full TAB movies, meaning users will need playback hardware with adequate CPU power.
* Hardware acceleration is not provided for full SBS or full TAB movies, meaning users will need playback hardware with adequate CPU power.
* XBMC's "window mode" in {{highlight|bordered=yes|[[Settings/System#Video output|Settings -> System -> Video output]]}} must use normal '''"Full screen"''' and not "Full screen window".
* Kodi's "window mode" in {{highlight|bordered=yes|[[Settings/System#Video output|Settings -> System -> Video output]]}} must use normal '''"Full screen"''' and not "Full screen window".


=== Windows ===
=== Windows ===

Revision as of 08:46, 19 June 2015

Home icon grey.png   ▶ Video library ▶ Playback ▶ 3D

Starting in v13, Kodi supports a number of passive 3D video formats such as SBS, TAB, anaglyph or interlaced. This support extends to the Kodi GUI including subtitles and on-screen-controls.

Interface and menus

Incomplete.png INCOMPLETE:
This page or section is incomplete. Please add information or correct uncertain data which is marked with a ?
Over-under 3D.png


3D detection

Kodi has three ways to detect whether a videofile is a 3D video. These methods are checked in the following order:

Embedded streaminfo

First, Kodi tries to detect the stereoscopic mode for a video when extracting streamdetails from the videofile.

One of the supported fields is the 'Stereomode' field in the Matroska specification: http://matroska.org/technical/specs/index.html#StereoMode

Manual selection

When playing a video, you can bring up the video settings dialog to manually select the stereoscopic mode.

If you've done this before, Kodi will remember this setting and use it as the second method to detect the stereoscopic mode of a videofile.

Video filenames flags

The third and final method is detection through the filename of the video.

Kodi uses regular expressions to check for certain flags in the filename.

In order to properly detect the stereomode, two tags need to be present in the filename. First, a '3D' tag has to be present that matches the following regex: [-. _]3d[-. _]

In addition to this, either a 'SBS' tag [-. _]h?sbs[-. _] or a 'TAB' flag [-. _]h?tab[-. _] must be present in the filename.

You can customize these regular expressions through the Advancedsettings.xml file.


Regex matching is done case-insensitive, so for example either .3d. and .3D. will work.

Note: the tags need be be surrounded be either a space ( ), hyphen -, dot . or underscore _.


See the table below for some examples:

3D Stereoscopic side-by-side Stereoscopic top-and-bottom
.3D. .sbs. .tab.
-3d- .SBS. .TAB.
3d .HSBS. .HTAB.
_3d_ -hsbs- -htab-
.3D- _sbs_ _tab_
3D. SBS TAB
.3D sbs tab
-SBS -TAB
HSBS_ HTAB_
Filename examples
  • moviename (year).3d.hsbs.mkv
  • moviename 3d sbs.mkv
  • moviename.3D-HTAB.mkv
  • moviename-3D.sbs-720p.mkv


For other filename flags examples.

Platform specific info

General

  • Hardware acceleration is not provided for full SBS or full TAB movies, meaning users will need playback hardware with adequate CPU power.
  • Kodi's "window mode" in Settings -> System -> Video output must use normal "Full screen" and not "Full screen window".

Windows

  • "3D Stereoscopic Support" in the video driver settings must be turned off.

ARM (Android, iOS, Raspberry Pi)

  • 3D modes anaglyph and interlaced are not currently supported on ARM platforms (such as Android, iOS, Raspberry Pi, or other linux-based ARM distros) due to those platforms using OpenGLES rather than OpenGL or DirectX.