2 * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
4 * Licensed under the Apache License, Version 2.0 (the License);
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an AS IS BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 namespace Tizen.Multimedia
21 internal enum DisplayType
24 /// Overlay surface display
29 /// Evas image object surface display
34 /// This disposes off buffers
39 internal interface IDisplayable<TError>
41 TError ApplyEvasDisplay(DisplayType type, EvasObject evasObject);
42 TError ApplyEcoreWindow(IntPtr windowHandle);
45 internal interface IDisplaySetter
47 TError SetDisplay<TError>(IDisplayable<TError> target);
50 internal class EvasDisplaySetter : IDisplaySetter
52 private readonly DisplayType _type;
53 private readonly EvasObject _target;
55 internal EvasDisplaySetter(DisplayType type, EvasObject target)
57 if (target == IntPtr.Zero)
59 throw new ArgumentException("The evas object is not realized.");
66 public TError SetDisplay<TError>(IDisplayable<TError> target)
68 return target.ApplyEvasDisplay(_type, _target);
72 internal class EcoreDisplaySetter : IDisplaySetter
74 private readonly IntPtr _windowHandle;
76 internal EcoreDisplaySetter(IntPtr windowHandle)
78 _windowHandle = windowHandle;
81 public TError SetDisplay<TError>(IDisplayable<TError> target)
83 return target.ApplyEcoreWindow(_windowHandle);
88 /// Provides a means to wrap various display types.
90 /// <seealso cref="Player"/>
91 /// <seealso cref="Camera"/>
92 /// <seealso cref="Tizen.Multimedia.Remoting.ScreenMirroring"/>
95 private readonly IDisplaySetter _setter;
98 /// Initializes a new instance of the <see cref="Display"/> class with a <see cref="MediaView"/> class.
100 /// <param name="mediaView">A <see cref="MediaView"/> to display.</param>
101 /// <feature>http://tizen.org/feature/multimedia.raw_video</feature>
102 /// <exception cref="NotSupportedException">The required feature is not supported.</exception>
103 public Display(MediaView mediaView)
105 ValidationUtil.ValidateFeatureSupported(Features.RawVideo);
107 if (mediaView == null)
109 throw new ArgumentNullException(nameof(mediaView));
112 _setter = new EvasDisplaySetter(DisplayType.Surface, mediaView);
116 /// Initializes a new instance of the <see cref="Display"/> class with a <see cref="Window"/> class.
118 /// <param name="window">A <see cref="Window"/> to display.</param>
119 public Display(Window window)
123 throw new ArgumentNullException(nameof(window));
126 _setter = new EvasDisplaySetter(DisplayType.Overlay, window);
130 /// Initializes a new instance of the <see cref="Display"/> class with a <see cref="NUI.Window"/> class.
132 /// <param name="window">A <see cref="NUI.Window"/> to display.</param>
134 /// The <see cref="NUI.Window.BackgroundColor"/> must be <see cref="NUI.Color.Transparent"/>
135 /// for the <see cref="Display"/> to be rendered correctly.
137 public Display(NUI.Window window)
141 throw new ArgumentNullException(nameof(window));
144 _setter = new EcoreDisplaySetter(window.GetNativeWindowHandler());
147 private EvasObject EvasObject { get; }
149 private DisplayType Type { get; }
151 private object _owner;
153 internal object Owner => _owner;
155 internal void SetOwner(object newOwner)
157 if (_owner != null && newOwner != null)
159 throw new ArgumentException("The display has already been assigned to another.");
165 internal TError ApplyTo<TError>(IDisplayable<TError> target)
167 return _setter.SetDisplay(target);