1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_UI_TABS_TAB_UTILS_H_
#define CHROME_BROWSER_UI_TABS_TAB_UTILS_H_
#include <vector>
#include "base/memory/scoped_ptr.h"
#include "base/strings/string16.h"
class TabStripModel;
namespace content {
class WebContents;
} // namespace content
namespace gfx {
class Animation;
class Image;
} // namespace gfx
// Media state for a tab. In reality, more than one of these may apply. See
// comments for GetTabMediaStateForContents() below.
enum TabMediaState {
TAB_MEDIA_STATE_NONE,
TAB_MEDIA_STATE_RECORDING, // Audio/Video being recorded, consumed by tab.
TAB_MEDIA_STATE_CAPTURING, // Tab contents being captured.
TAB_MEDIA_STATE_AUDIO_PLAYING, // Audible audio is playing from the tab.
TAB_MEDIA_STATE_AUDIO_MUTING, // Tab audio is being muted.
};
namespace chrome {
// Logic to determine which components (i.e., close button, favicon, and media
// indicator) of a tab should be shown, given current state. |capacity|
// specifies how many components can be shown, given available tab width.
//
// Precedence rules for deciding what to show when capacity is insufficient to
// show everything:
//
// Active tab: Always show the close button, then the media indicator, then
// the favicon.
// Inactive tab: Media indicator, then the favicon, then the close button.
// Pinned tab: Show only the media indicator, or only the favicon
// (TAB_MEDIA_STATE_NONE). Never show the close button.
bool ShouldTabShowFavicon(int capacity,
bool is_pinned_tab,
bool is_active_tab,
bool has_favicon,
TabMediaState media_state);
bool ShouldTabShowMediaIndicator(int capacity,
bool is_pinned_tab,
bool is_active_tab,
bool has_favicon,
TabMediaState media_state);
bool ShouldTabShowCloseButton(int capacity,
bool is_pinned_tab,
bool is_active_tab);
// Returns whether the given |contents| is playing audio. We might choose to
// show an audio favicon indicator for this tab.
bool IsPlayingAudio(content::WebContents* contents);
// Returns the media state to be shown by the tab's media indicator. When
// multiple states apply (e.g., tab capture with audio playback), the one most
// relevant to user privacy concerns is selected.
TabMediaState GetTabMediaStateForContents(content::WebContents* contents);
// Returns a cached image, to be shown by the media indicator for the given
// |media_state|. Uses the global ui::ResourceBundle shared instance.
const gfx::Image& GetTabMediaIndicatorImage(TabMediaState media_state);
// Returns the cached image, to be shown by the media indicator button for mouse
// hover/pressed, when the indicator is in the given |media_state|. Uses the
// global ui::ResourceBundle shared instance.
const gfx::Image& GetTabMediaIndicatorAffordanceImage(
TabMediaState media_state);
// Returns a non-continuous Animation that performs a fade-in or fade-out
// appropriate for the given |next_media_state|. This is used by the tab media
// indicator to alert the user that recording, tab capture, or audio playback
// has started/stopped.
scoped_ptr<gfx::Animation> CreateTabMediaIndicatorFadeAnimation(
TabMediaState next_media_state);
// Returns the text to show in a tab's tooltip: The contents |title|, followed
// by a break, followed by a localized string describing the |media_state|.
base::string16 AssembleTabTooltipText(const base::string16& title,
TabMediaState media_state);
// Returns true if the experimental tab audio mute feature is enabled.
bool IsTabAudioMutingFeatureEnabled();
// Returns true if audio mute can be activated/deactivated for the given
// |contents|.
bool CanToggleAudioMute(content::WebContents* contents);
// Indicates/Sets whether all audio output from |contents| is muted.
bool IsTabAudioMuted(content::WebContents* contents);
void SetTabAudioMuted(content::WebContents* contents, bool mute);
// Returns true if the tabs at the |indices| in |tab_strip| are all muted.
bool AreAllTabsMuted(const TabStripModel& tab_strip,
const std::vector<int>& indices);
} // namespace chrome
#endif // CHROME_BROWSER_UI_TABS_TAB_UTILS_H_
|
