reflow comments in core/html/*.{cpp,h},core/html/imports

third_party/WebKit/Source/core/html/HTMLMediaElement.h

 /*
- * Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012, 2013 Apple Inc. All rights reserved.
+ * Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012, 2013 Apple Inc. All rights
+ * reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
  *    documentation and/or other materials provided with the distribution.
  *
@@ skipping 196 matching lines @@
                           ExceptionState&);
 
   TextTrackList* textTracks();
   CueTimeline& cueTimeline();
 
   void addTextTrack(TextTrack*);
   void removeTextTrack(TextTrack*);
   void textTracksChanged();
   void notifyMediaPlayerOfTextTrackChanges();
 
-  // Implements the "forget the media element's media-resource-specific tracks" algorithm in the HTML5 spec.
+  // Implements the "forget the media element's media-resource-specific tracks"
+  // algorithm in the HTML5 spec.
   void forgetResourceSpecificTracks();
 
   void didAddTrackElement(HTMLTrackElement*);
   void didRemoveTrackElement(HTMLTrackElement*);
 
   void honorUserPreferencesForAutomaticTextTrackSelection();
 
   bool textTracksAreReady() const;
   void configureTextTrackDisplay();
   void updateTextTrackDisplay();
@@ skipping 52 matching lines @@
   // Checks to see if current media data is CORS-same-origin as the
   // specified origin.
   bool isMediaDataCORSSameOrigin(SecurityOrigin*) const;
 
   void scheduleEvent(Event*);
   void scheduleTimeupdateEvent(bool periodicEvent);
 
   // Returns the "effective media volume" value as specified in the HTML5 spec.
   double effectiveMediaVolume() const;
 
-  // Predicates also used when dispatching wrapper creation (cf. [SpecialWrapFor] IDL attribute usage.)
+  // Predicates also used when dispatching wrapper creation (cf.
+  // [SpecialWrapFor] IDL attribute usage.)
   virtual bool isHTMLAudioElement() const { return false; }
   virtual bool isHTMLVideoElement() const { return false; }
 
   // Temporary callback for crbug.com/487345,402044
   void notifyPositionMayHaveChanged(const IntRect&);
   void updatePositionNotificationRegistration();
 
   WebRemotePlaybackClient* remotePlaybackClient() {
     return m_remotePlaybackClient;
   }
@@ skipping 87 matching lines @@
   void playbackProgressTimerFired(TimerBase*);
   void startPlaybackProgressTimer();
   void startProgressEventTimer();
   void stopPeriodicTimers();
 
   void seek(double time);
   void finishSeek();
   void checkIfSeekNeeded();
   void addPlayedRange(double start, double end);
 
-  void scheduleEvent(
-      const AtomicString&
-          eventName);  // FIXME: Rename to scheduleNamedEvent for clarity.
+  // FIXME: Rename to scheduleNamedEvent for clarity.
+  void scheduleEvent(const AtomicString& eventName);
 
   // loading
   void invokeLoadAlgorithm();
   void invokeResourceSelectionAlgorithm();
   void loadInternal();
   void selectMediaResource();
   void loadResource(const WebMediaPlayerSource&, const ContentType&);
   void startPlayerLoad(const KURL& playerProvidedUrl = KURL());
   void setPlayerPreload();
   WebMediaPlayer::LoadType loadType() const;
@@ skipping 31 matching lines @@
   void pauseInternal();
 
   void allowVideoRendering();
 
   void updateVolume();
   void updatePlayState();
   bool potentiallyPlaying() const;
   bool stoppedDueToErrors() const;
   bool couldPlayIfEnoughData() const;
 
-  // Generally the presence of the loop attribute should be considered to mean playback
-  // has not "ended", as "ended" and "looping" are mutually exclusive. See
+  // Generally the presence of the loop attribute should be considered to mean
+  // playback has not "ended", as "ended" and "looping" are mutually exclusive.
+  // See
   // https://html.spec.whatwg.org/multipage/embedded-content.html#ended-playback
   enum class LoopCondition { Included, Ignored };
   bool endedPlayback(LoopCondition = LoopCondition::Included) const;
 
   void setShouldDelayLoadEvent(bool);
   void invalidateCachedTime();
   void refreshCachedTime() const;
 
   void ensureMediaControls();
   void configureMediaControls();
 
   TextTrackContainer& ensureTextTrackContainer();
 
   EventDispatchHandlingState* preDispatchEventHandler(Event*) final;
 
   void changeNetworkStateFromLoadingToIdle();
 
   bool isAutoplaying() const { return m_autoplaying; }
 
   void setAllowHiddenVolumeControls(bool);
 
   WebMediaPlayer::CORSMode corsMode() const;
 
   // Returns the "direction of playback" value as specified in the HTML5 spec.
   enum DirectionOfPlayback { Backward, Forward };
   DirectionOfPlayback getDirectionOfPlayback() const;
 
-  // Creates placeholder AudioTrack and/or VideoTrack objects when WebMemediaPlayer objects
-  // advertise they have audio and/or video, but don't explicitly signal them via
-  // addAudioTrack() and addVideoTrack().
-  // FIXME: Remove this once all WebMediaPlayer implementations properly report their track info.
+  // Creates placeholder AudioTrack and/or VideoTrack objects when
+  // WebMemediaPlayer objects advertise they have audio and/or video, but don't
+  // explicitly signal them via addAudioTrack() and addVideoTrack().
+  // FIXME: Remove this once all WebMediaPlayer implementations properly report
+  // their track info.
   void createPlaceholderTracksIfNecessary();
 
   // Sets the selected/enabled tracks if they aren't set before we initially
   // transition to kHaveMetadata.
   void selectInitialTracksIfNecessary();
 
   // Return true if and only if a user gesture is required to unlock this
   // media element for unrestricted autoplay / script control.  Don't confuse
   // this with isGestureNeededForPlayback().  The latter is usually what one
   // should use, if checking to see if an action is allowed.
@@ skipping 143 matching lines @@
   Member<CueTimeline> m_cueTimeline;
 
   HeapVector<Member<ScriptPromiseResolver>> m_playPromiseResolvers;
   std::unique_ptr<CancellableTaskFactory> m_playPromiseResolveTask;
   std::unique_ptr<CancellableTaskFactory> m_playPromiseRejectTask;
   HeapVector<Member<ScriptPromiseResolver>> m_playPromiseResolveList;
   HeapVector<Member<ScriptPromiseResolver>> m_playPromiseRejectList;
   ExceptionCode m_playPromiseErrorCode;
 
   // This is a weak reference, since m_audioSourceNode holds a reference to us.
-  // TODO(Oilpan): Consider making this a strongly traced pointer with oilpan where strong cycles are not a problem.
+  // TODO(Oilpan): Consider making this a strongly traced pointer with oilpan
+  // where strong cycles are not a problem.
   GC_PLUGIN_IGNORE("http://crbug.com/404577")
   WeakMember<AudioSourceProviderClient> m_audioSourceNode;
 
   // AudioClientImpl wraps an AudioSourceProviderClient.
   // When the audio format is known, Chromium calls setFormat().
   class AudioClientImpl final
       : public GarbageCollectedFinalized<AudioClientImpl>,
         public WebAudioSourceProviderClient {
    public:
     explicit AudioClientImpl(AudioSourceProviderClient* client)
@@ skipping 59 matching lines @@
 
 inline bool isHTMLMediaElement(const HTMLElement& element) {
   return isHTMLAudioElement(element) || isHTMLVideoElement(element);
 }
 
 DEFINE_HTMLELEMENT_TYPE_CASTS_WITH_FUNCTION(HTMLMediaElement);
 
 }  // namespace blink
 
 #endif  // HTMLMediaElement_h