Home | History | Annotate | Download | only in stagefright
      1 /*
      2  * Copyright (C) 2015 The Android Open Source Project
      3  *
      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
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     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.
     15  */
     16 
     17 #ifndef MEDIA_CLOCK_H_
     18 
     19 #define MEDIA_CLOCK_H_
     20 
     21 #include <media/stagefright/foundation/ABase.h>
     22 #include <utils/Mutex.h>
     23 #include <utils/RefBase.h>
     24 
     25 namespace android {
     26 
     27 struct AMessage;
     28 
     29 struct MediaClock : public RefBase {
     30     MediaClock();
     31 
     32     void setStartingTimeMedia(int64_t startingTimeMediaUs);
     33 
     34     void clearAnchor();
     35     // It's required to use timestamp of just rendered frame as
     36     // anchor time in paused state.
     37     void updateAnchor(
     38             int64_t anchorTimeMediaUs,
     39             int64_t anchorTimeRealUs,
     40             int64_t maxTimeMediaUs = INT64_MAX);
     41 
     42     void updateMaxTimeMedia(int64_t maxTimeMediaUs);
     43 
     44     void setPlaybackRate(float rate);
     45     float getPlaybackRate() const;
     46 
     47     // query media time corresponding to real time |realUs|, and save the
     48     // result in |outMediaUs|.
     49     status_t getMediaTime(
     50             int64_t realUs,
     51             int64_t *outMediaUs,
     52             bool allowPastMaxTime = false) const;
     53     // query real time corresponding to media time |targetMediaUs|.
     54     // The result is saved in |outRealUs|.
     55     status_t getRealTimeFor(int64_t targetMediaUs, int64_t *outRealUs) const;
     56 
     57 protected:
     58     virtual ~MediaClock();
     59 
     60 private:
     61     status_t getMediaTime_l(
     62             int64_t realUs,
     63             int64_t *outMediaUs,
     64             bool allowPastMaxTime) const;
     65 
     66     mutable Mutex mLock;
     67 
     68     int64_t mAnchorTimeMediaUs;
     69     int64_t mAnchorTimeRealUs;
     70     int64_t mMaxTimeMediaUs;
     71     int64_t mStartingTimeMediaUs;
     72 
     73     float mPlaybackRate;
     74 
     75     DISALLOW_EVIL_CONSTRUCTORS(MediaClock);
     76 };
     77 
     78 }  // namespace android
     79 
     80 #endif  // MEDIA_CLOCK_H_
     81