Difference between revisions of "3D"

From Official Kodi Wiki
Jump to: navigation, search
(Video filenames)
Line 8: Line 8:
 
{{-}}
 
{{-}}
  
== Video filenames ==
+
== 3D detection ==
 +
XBMC has three ways to detect whether a videofile is a 3D video.
 +
these methods are checked in the following order:
 +
=== Embedded streaminfo ===
 +
First, XBMC tries to detect the stereoscopic mode for a video when extracting streamdetails from the videofile.
 +
 
 
Video files must have a 3D "token" in their filename to properly trigger a 3D mode.
 
Video files must have a 3D "token" in their filename to properly trigger a 3D mode.
  
 +
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, XBMC will remember this setting and use it as the second method to detect the stereoscopic mode of a videofile.
 +
=== Video filenames ===
 +
The third and final method is detection through the filename of the video.
 +
 +
XBMC uses regular expressions to check for certain tags in the filename.
 +
 +
In order to properly detect the stereomode, two tags need to be present in the filename.
 +
First, a '3D' tag must be present that matches the following regex: '''[-. _]3d[-. _]'''
 +
 +
In addition to this, either a 'SBS' tag '''[-. _]h?sbs[-. _]''' or a 'TAB' tag '''[-. _]h?tab[-. _]''' must be present in the filename.
 +
 +
 +
Regex matching is done case-insensitive, so for example either .3d. and .3D. will work.
 +
 +
Please note, tags need be be surrounded be either a space ( ), hyphen (-), dot (.) or underscore (_).
 +
 +
See below table for some examples:
 
{| class="wikitable"
 
{| class="wikitable"
! Stereoscopic side-by-side !! Stereoscopic tab
+
! 3D !! Stereoscopic side-by-side !! Stereoscopic tab
 
|-
 
|-
| <poem>3DSBS
+
| <poem>.3D.
3D.SBS
+
-3d-
HSBS
+
3d
H.SBS
+
_3d_
H-SBS
+
.3D-
FULL-SBS
+
3D.</poem>
FULL.SBS
+
| <poem>.sbs.
FULLSBS
+
.SBS.
HALF-SBS
+
.HSBS.
FSBS
+
-hsbs-
_SBS_</poem>
+
_sbs_
| <poem>3DTAB
+
SBS  
3D.TAB
+
sbs
HTAB
+
-SBS  
H.TAB
+
HSBS_</poem>
3DOU
+
| <poem>.tab.
3D.OU
+
.TAB.
3D.HOU
+
.HTAB.
HALF-TAB
+
-htab-
_HOU_
+
_tab_
_OU_</poem>
+
TAB
 +
tab
 +
-TAB  
 +
HTAB_</poem>
 
|}
 
|}
  
;Examples
+
;Filename examples
 
* moviename (year).3d.hsbs.mkv
 
* moviename (year).3d.hsbs.mkv
 
+
* moviename 3d sbs.mkv
 +
* moviename.3D-HTAB.mkv
 +
* moviename-3D.sbs-720p.mkv
 
== Platform specific info ==
 
== Platform specific info ==
  

Revision as of 16:27, 9 March 2014

Future.png GOTHAM FEATURE:
This page or section describes features that were added as a part of XBMC v13 with codename "Gotham".
Wiki logo.png Wiki revamp:
This page or section of the wiki undergoing a revamp. Content is still being added and organized. Please pardon the dust and anything that might not be working.

Starting in v13, XBMC supports a number of passive 3D movie formats encoded in SBS, TAB, anaglyph or interlaced.

1 Interface and menus

Starting in XBMC v13 "Gotham", XBMC has 3D UI support

Over-under 3D.png


2 3D detection

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

2.1 Embedded streaminfo

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

Video files must have a 3D "token" in their filename to properly trigger a 3D mode.

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

2.2 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, XBMC will remember this setting and use it as the second method to detect the stereoscopic mode of a videofile.

2.3 Video filenames

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

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

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

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


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

Please note, tags need be be surrounded be either a space ( ), hyphen (-), dot (.) or underscore (_).

See below table for some examples:

3D Stereoscopic side-by-side Stereoscopic tab

.3D.
-3d-
 3d
_3d_
.3D-
 3D.

.sbs.
.SBS.
.HSBS.
-hsbs-
_sbs_
 SBS
 sbs
-SBS
 HSBS_

.tab.
.TAB.
.HTAB.
-htab-
_tab_
 TAB
 tab
-TAB
 HTAB_

Filename examples
  • moviename (year).3d.hsbs.mkv
  • moviename 3d sbs.mkv
  • moviename.3D-HTAB.mkv
  • moviename-3D.sbs-720p.mkv

3 Platform specific info

3.1 General

  • 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 Settings -> System -> Video output must use normal "Full screen" and not "Full screen window".

3.2 Windows

  • 3D Stereoscopic Support in video driver must be turned off