anonymous_namespace{TrackPanel.cpp} Namespace Reference

Classes
struct	ChannelStack
struct	EmptyCell
class	EmptyPanelRect
struct	HorizontalGroup
struct	LabeledChannelGroup
struct	MainGroup
struct	ResizingChannelGroup
struct	Subgroup
struct	VRulerAndChannel
struct	VRulersAndChannels

Enumerations
enum	: int {   DisplaceX = 7 , DisplaceY = 1 , MarginX = 8 , MarginY = 2 ,   MarginsX = 2 * MarginX , MarginsY = 2 * MarginY }

Functions
std::shared_ptr< Track >	FindTrack (TrackPanelCell *pCell)
std::vector< int >	FindAdjustedChannelHeights (Track &t)
Track &	GetTrack (Channel &channel)
const Track &	GetTrack (const Channel &channel)
void	GetTrackNameExtent (wxDC &dc, const Channel &channel, wxCoord *pW, wxCoord *pH)
wxRect	GetTrackNameRect (int leftOffset, const wxRect &trackRect, wxCoord textWidth, wxCoord textHeight)
void	DrawTrackName (int leftOffset, TrackPanelDrawingContext &context, const Channel &channel, const wxRect &rect)

Variables
AttachedWindows::RegisteredFactory	sKey

Enumeration Type Documentation

anonymous enum

anonymous enum : int

Enumerator
DisplaceX
DisplaceY
MarginX
MarginY
MarginsX
MarginsY

Definition at line 1030 of file TrackPanel.cpp.

        : int {
      // Displacement of the rectangle from upper left corner
      DisplaceX = 7, DisplaceY = 1,
      // Size of margins about the text extent that determine the rectangle size
      MarginX = 8, MarginY = 2,
      // Derived constants
      MarginsX = 2 * MarginX, MarginsY = 2 * MarginY,
   };

Function Documentation

DrawTrackName()

void anonymous_namespace{TrackPanel.cpp}::DrawTrackName	(	int	leftOffset,
		TrackPanelDrawingContext &	context,
		const Channel &	channel,
		const wxRect &	rect
	)

Definition at line 1074 of file TrackPanel.cpp.

{
   if (!TrackArtist::Get(context)->mbShowTrackNameInTrack)
      return;
   auto &track = *GetTrack(channel).SubstitutePendingChangedTrack();
   auto name = track.GetName();
   if (name.IsEmpty())
      return;
   if (!track.IsLeader())
      return;
   auto &dc = context.dc;
   wxBrush Brush;
   wxCoord textWidth, textHeight;
   GetTrackNameExtent(dc, channel, &textWidth, &textHeight);
 
   // Logic for name background translucency (aka 'shields')
   // Tracks less than kOpaqueHeight high will have opaque shields.
   // Tracks more than kTranslucentHeight will have maximum translucency for shields.
   const int kOpaqueHeight = 44;
   const int kTranslucentHeight = 124;
 
   // PRL:  to do:  reexamine this strange use of ChannelView::GetHeight,
   // ultimately to compute an opacity
   int h = ChannelView::Get(channel).GetHeight();
 
   // f codes the opacity as a number between 0.0 and 1.0
   float f = wxClip((h-kOpaqueHeight)/(float)(kTranslucentHeight-kOpaqueHeight),0.0,1.0);
   // kOpaque is the shield's alpha for tracks that are not tall
   // kTranslucent is the shield's alpha for tracks that are tall.
   const int kOpaque = 255;
   const int kTranslucent = 140;
   // 0.0 maps to full opacity, 1.0 maps to full translucency.
   int opacity = 255 - (255-140)*f;
 
   const auto nameRect =
      GetTrackNameRect( leftOffset, rect, textWidth, textHeight );
 
#ifdef __WXMAC__
   // Mac dc is a graphics dc already.
   AColor::UseThemeColour( &dc, clrTrackInfoSelected, clrTrackPanelText, opacity );
   dc.DrawRoundedRectangle( nameRect, 8.0 );
#else
   // This little dance with wxImage in order to draw to a graphic dc
   // which we can then paste as a translucent bitmap onto the real dc.
   enum : int {
      SecondMarginX = 1, SecondMarginY = 1,
      SecondMarginsX = 2 * SecondMarginX, SecondMarginsY = 2 * SecondMarginY,
   };
   wxImage image(
      textWidth + MarginsX + SecondMarginsX,
      textHeight + MarginsY + SecondMarginsY );
   image.InitAlpha();
   unsigned char *alpha=image.GetAlpha();
   memset(alpha, wxIMAGE_ALPHA_TRANSPARENT, image.GetWidth()*image.GetHeight());
 
   {
      std::unique_ptr< wxGraphicsContext >
         pGc{ wxGraphicsContext::Create(image) };
      auto &gc = *pGc;
      // This is to a gc, not a dc.
      AColor::UseThemeColour( &gc, clrTrackInfoSelected, clrTrackPanelText, opacity );
      // Draw at 1,1, not at 0,0 to avoid clipping of the antialiasing.
      gc.DrawRoundedRectangle(
         SecondMarginX, SecondMarginY,
         textWidth + MarginsX, textHeight + MarginsY, 8.0 );
      // destructor of gc updates the wxImage.
   }
   wxBitmap bitmap( image );
   dc.DrawBitmap( bitmap,
      nameRect.x - SecondMarginX, nameRect.y - SecondMarginY );
#endif
   dc.SetTextForeground(theTheme.Colour( clrTrackPanelText ));
   dc.DrawText(track.GetName(),
      nameRect.x + MarginX,
      nameRect.y + MarginY);
}

References ThemeBase::Colour(), TrackPanelDrawingContext::dc, ChannelView::Get(), TrackArtist::Get(), ChannelView::GetHeight(), GetTrack(), GetTrackNameExtent(), GetTrackNameRect(), MarginsX, MarginsY, MarginX, MarginY, name, Track::SubstitutePendingChangedTrack(), theTheme, AColor::UseThemeColour(), and wxImage().

Referenced by anonymous_namespace{TrackPanel.cpp}::VRulersAndChannels::Draw().

Here is the call graph for this function:

Here is the caller graph for this function:

FindAdjustedChannelHeights()

std::vector< int > anonymous_namespace{TrackPanel.cpp}::FindAdjustedChannelHeights

(

Track &

t

)

Precondition

t.IsLeader()

Definition at line 896 of file TrackPanel.cpp.

{
   assert(t.IsLeader());
   auto channels = t.Channels();
   assert(!channels.empty());
 
   // Collect heights, and count affordances
   int nAffordances = 0;
   int totalHeight = 0;
   std::vector<int> oldHeights;
   for (auto pChannel : channels) {
      auto &view = ChannelView::Get(*pChannel);
      const auto height = view.GetHeight();
      totalHeight += height;
      oldHeights.push_back(height);
      if (view.GetAffordanceControls())
         ++nAffordances;
   }
 
   // Allocate results
   auto nChannels = static_cast<int>(oldHeights.size());
   std::vector<int> results;
   results.reserve(nChannels);
 
   // Now reallocate the channel heights for the presence of affordances
   // and separators
   auto availableHeight = totalHeight
      - nAffordances * kAffordancesAreaHeight
      - (nChannels - 1) * kChannelSeparatorThickness
      - kTrackSeparatorThickness;
   int cumulativeOldHeight = 0;
   int cumulativeNewHeight = 0;
   for (const auto &oldHeight : oldHeights) {
      // Preserve the porportions among the stored heights
      cumulativeOldHeight += oldHeight;
      const auto newHeight =
         cumulativeOldHeight * availableHeight / totalHeight
            - cumulativeNewHeight;
      cumulativeNewHeight += newHeight;
      results.push_back(newHeight);
   }
 
   return results;
}

References ChannelGroup::Channels(), ChannelView::Get(), Track::IsLeader(), kAffordancesAreaHeight, kChannelSeparatorThickness, and kTrackSeparatorThickness.

Referenced by anonymous_namespace{TrackPanel.cpp}::ChannelStack::Children(), anonymous_namespace{TrackPanel.cpp}::ChannelStack::Draw(), and TrackPanel::UpdateTrackVRuler().

Here is the call graph for this function:

Here is the caller graph for this function:

FindTrack()

std::shared_ptr< Track > anonymous_namespace{TrackPanel.cpp}::FindTrack

(

TrackPanelCell *

pCell

)

Definition at line 537 of file TrackPanel.cpp.

   {
      if (pCell)
         return static_cast<CommonTrackPanelCell*>( pCell )->FindTrack();
      return {};
   }

References FindTrack().

Referenced by MenuButtonHandle::CommitChanges(), StretchHandle::Drag(), FindTrack(), WaveChannelSubView::GetMenuItems(), CloseButtonHandle::HitTest(), MenuButtonHandle::HitTest(), MinimizeButtonHandle::HitTest(), SelectButtonHandle::HitTest(), TrackPanel::OnMouseEvent(), and TrackPanel::ProcessUIHandleResult().

Here is the call graph for this function:

Here is the caller graph for this function:

GetTrack() [1/2]

Track & anonymous_namespace{TrackPanel.cpp}::GetTrack

(

Channel &

channel

)

Definition at line 1039 of file TrackPanel.cpp.

{
   // It is assumed that all channels we ever see are in groups that are
   // also Tracks
   return static_cast<Track &>(channel.GetChannelGroup());
}

References Channel::GetChannelGroup().

Here is the call graph for this function:

GetTrack() [2/2]

const Track & anonymous_namespace{TrackPanel.cpp}::GetTrack

(

const Channel &

channel

)

Definition at line 1046 of file TrackPanel.cpp.

{
   // It is assumed that all channels we ever see are in groups that are
   // also Tracks
   return static_cast<const Track &>(channel.GetChannelGroup());
}

References Channel::GetChannelGroup().

Referenced by anonymous_namespace{TrackPanel.cpp}::EmptyPanelRect::DoFindTrack(), DrawTrackName(), and GetTrackNameExtent().

Here is the call graph for this function:

Here is the caller graph for this function:

GetTrackNameExtent()

void anonymous_namespace{TrackPanel.cpp}::GetTrackNameExtent	(	wxDC &	dc,
		const Channel &	channel,
		wxCoord *	pW,
		wxCoord *	pH
	)

Definition at line 1053 of file TrackPanel.cpp.

{
   wxFont labelFont(12, wxFONTFAMILY_SWISS, wxFONTSTYLE_NORMAL, wxFONTWEIGHT_NORMAL);
   dc.SetFont(labelFont);
   dc.GetTextExtent(GetTrack(channel).GetName(), pW, pH);
}

References GetTrack().

Referenced by anonymous_namespace{TrackPanel.cpp}::VRulersAndChannels::DrawingArea(), and DrawTrackName().

Here is the call graph for this function:

Here is the caller graph for this function:

GetTrackNameRect()

wxRect anonymous_namespace{TrackPanel.cpp}::GetTrackNameRect	(	int	leftOffset,
		const wxRect &	trackRect,
		wxCoord	textWidth,
		wxCoord	textHeight
	)

Definition at line 1061 of file TrackPanel.cpp.

{
   return {
      leftOffset + DisplaceX,
      trackRect.y + DisplaceY,
      textWidth + MarginsX,
      textHeight + MarginsY
   };
}

References DisplaceX, DisplaceY, MarginsX, and MarginsY.

Referenced by anonymous_namespace{TrackPanel.cpp}::VRulersAndChannels::DrawingArea(), and DrawTrackName().

Here is the caller graph for this function:

Variable Documentation

sKey

AttachedWindows::RegisteredFactory anonymous_namespace{TrackPanel.cpp}::sKey

Initial value:

{
   []( AudacityProject &project ) -> wxWeakRef< wxWindow > {
      auto &ruler = AdornedRulerPanel::Get( project );
      auto &viewInfo = ViewInfo::Get( project );
      auto &window = ProjectWindow::Get( project );
      auto mainPage = window.GetTrackListWindow();
      wxASSERT( mainPage ); 
 
      auto &tracks = TrackList::Get( project );
      auto result = safenew TrackPanel(mainPage,
         window.NextWindowID(),
         wxDefaultPosition,
         wxDefaultSize,
         tracks.shared_from_this(),
         &viewInfo,
         &project,
         &ruler);
      SetProjectPanel( project, *result );
      return result;
   }
}

Definition at line 209 of file TrackPanel.cpp.

Referenced by TrackPanel::Destroy(), and TrackPanel::Get().