This API provides interfaces for managing stereoscopic 3D effects for television signals.
Modern TVs and projectors can display two images, a left image and a right image, which are displayed to the left and right eyes respectively. This technique creates an illusion of depth, which is perceived by users as a 3D image.
There are several formats of input images supported by the stereoscopy plugin:
Side-by-side: Left and right images are merged into one picture. The left image is at the left side and the right image is at the right side. Both images are scaled to fit in the original image ratio.
Top-bottom: Left and right images are merged into one picture. The left image is at the top and the right image is at the bottom. Both images are scaled to fit in the original image ratio.
Line-by-line: Left and right images are interlaced by row. The first row belongs to the left image and the second row belongs to the right image, and so on.
Vertical-strip: Left and right images are interlaced by column. The first column belongs to the left image and the second column belongs to the right image, and so on.
Frame-sequence: Left and right images are interlaced by frames.
Advanced devices are able to computationally generate depth data by processing non-stereoscopic images. Depth data is used to render left and right stereoscopic images from a source image which lacks this information. The quality of such stereoscopic images depends on the computational power used for processing, the algorithms used and the properties of the source data. For more information see this Wikipedia article.
There will be a tizen.tvdisplaycontrol object that allows accessing the functionality of the display control API.
NOT_CONNECTED - The device (e.g. Blu-ray player) supports 3D mode but a 3D display is not connected.
NOT_SUPPORTED - The device does not support 3D mode.
READY - The device supports 3D mode and it can display 3D mode.
2. Interfaces
2.1. DisplayControlManagerObject
This interface defines what is instantiated by the tizen object. There will be a tizen.tvdisplaycontrol object that allows the access to the Display Control API.
with error type SecurityError, if the application does not have the privilege to call this method.
with error type NotSupportedError, if this feature is not supported.
with error type UnknownError, in any other error case.
Code example:
try {
var current3Dmode = tizen.tvdisplaycontrol.get3DEffectMode()
console.log("The current 3D mode is " + current3Dmode + ".");
} catch (error) {
console.log(error.name);
}
is3DModeEnabled
Checks whether playing 3D mode is available or not.
Display3DModeState is3DModeEnabled();
Since: 2.43
Privilege level: public
Privilege: http://tizen.org/privilege/tv.display
Return value:
Display3DModeState The current state to display 3D contents
Exceptions:
WebAPIException
with error type SecurityError, if the application does not have the privilege to call this method.
with error type NotSupportedError, if this feature is not supported.
with error type UnknownError, in any other error case.
Code example:
try {
if (tizen.tvdisplaycontrol.is3DModeEnabled() === "NOT_SUPPORTED") {
console.log("The current device does not support 3D mode.");
} else if (tizen.tvdisplaycontrol.is3DModeEnabled() === "READY") {
console.log("The current device supports 3D mode and can display 3D contents. Maybe it is a 3D TV device or is connected with 3D display device.");
} else {
console.log("The current device supports 3D mode but cannot display 3D contents. It may be a 3D Blu-ray player device which is not connected with 3D display device.");
}
} catch (error) {
console.log(error.name);
}
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.