View source for 3D

{{mininav| [[Video library]] | [[Video playback|Playback]] }}
<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" />

==Limitations==
===MVC software decoding not supported===
Kodi does not yet support software video decoding of [[w:Multiview Video Coding|MVC (Multiview Video Coding)]] encoded 3D videos, which is the format most commonly used in raw Blu-ray 3D backups/rips (and on original Blu-ray Disc media with stereoscopic video.

However, hardware decoding of [[w:Multiview Video Coding|MVC (Multiview Video Coding)]] encoded 3D videos is supported in Kodi on some platforms/operating-systems if the device drivers and hardware supports it, like it does for the Raspberry Pi.

For software video decoding Kodi depends on the third-party decoder libraries from the [http://ffmpeg.org/FFmpeg (ffmpeg.org)] project as well as code from its sister-project [http://libav.org/ Libav (libav.org)]. The fact is that Kodi will not support software video decoding of MVC encoded 3D videos until the developers of those projects have written and added code for it first, and as those projects just like Kodi are also non-profit organizations run by volunteers working for free is impossible to estimate when (if ever) someone will write and add code for MVC decoding support to FFmpeg and/or Libav (before it can be added to Kodi).

For more information see the wikipedia article about [[w:Multiview Video Coding|MVC (Multiview Video Coding)]] or read the more development-oriented description written by the Libav developers on their wiki here: http://wiki.libav.org/Blueprint/MVC

== Interface and menus ==
{{incomplete}}
[[File:Over-under 3D.png|500px|right]]
{{-}}

== 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 playback#OSD video settings|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 ===
{{see also|Naming video files}}
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: <code>'''[-. _]3d[-. _]'''</code>

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

You can customize these regular expressions through the [[Advancedsettings.xml#video|Advancedsettings.xml]] file.


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

{{note| the tags need be be surrounded be either a hyphen <code>-</code>, space <code>&nbsp;</code>, dot <code>.</code> or underscore <code>_</code>.}}


See the table below for some examples:

{|class="prettytable" style="text-align: center;"
! 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


{{see also|Media_flags#Video_flags}}
For other filename flags examples.

==Subtitiles==
?

== 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 {{highlight|bordered=yes|[[Settings/System#Video output|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.

== Other guides ==
* brazen1's 3D guide: http://forum.kodi.tv/showthread.php?tid=229692

{{Gotham updated}}

[[Category:Video library]]
[[Category:Manual]]