[v0.3.32] enhance description about player_set_display_visible

Change-Id: Ia23de656fba393a63ec4ade83e12fcc31665dd7e

diff --git a/include/player.h b/include/player.h
index 21e427de7e1a52f6992577845b2629f646acca68..07939f1c7d5546f3cabf5bcd3189109c22c4311b 100644 (file)
--- a/include/player.h
+++ b/include/player.h
@@ -685,6 +685,7 @@ int player_get_audio_latency_mode(player_h player, audio_latency_mode_e *latency
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks Sound can be mixed with other sounds if you don't control the stream focus in sound-manager module since 3.0.\n
  * You can refer to @ref CAPI_MEDIA_SOUND_MANAGER_MODULE.
+ * @remarks Even if you don't set visible to true by calling player_set_display_visible, the video will be shown on #PLAYER_STATE_PLAYING state.
  * @details Plays current media content, or resumes play if paused.
  *
  * @param[in]   player The handle to the media player
@@ -710,6 +711,7 @@ int player_get_audio_latency_mode(player_h player, audio_latency_mode_e *latency
  * @see player_set_progressive_download_path()
  * @see player_set_progressive_download_message_cb()
  * @see player_pd_message_cb()
+ * @see player_set_display_visible()
  */
 int player_start(player_h player);
 
@@ -1192,6 +1194,7 @@ int player_set_display_roi_area(player_h player, int x, int y, int width, int he
  * @brief Sets the visibility of the video display
  * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
  * @remarks If no display is set, no operation is performed.
+ * @remarks If you set visible before calling player_set_display, it will be applied on #PLAYER_STATE_READY state.
  * @param[in] player   The handle to the media player
  * @param[in] visible The visibility of the display (@c true = visible, @c false = non-visible )
  * @return @c 0 on success,