media/base/video_util.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef MEDIA_BASE_VIDEO_UTIL_H_
   6 #define MEDIA_BASE_VIDEO_UTIL_H_
   7
   8 #include "base/basictypes.h"
   9 #include "media/base/media_export.h"
  10 #include "ui/gfx/rect.h"
  11 #include "ui/gfx/size.h"
  12
  13 namespace media {
  14
  15 class VideoFrame;
  16
  17 // Computes the size of |visible_size| for a given aspect ratio.
  18 MEDIA_EXPORT gfx::Size GetNaturalSize(const gfx::Size& visible_size,
  19                                       int aspect_ratio_numerator,
  20                                       int aspect_ratio_denominator);
  21
  22 // Copies a plane of YUV(A) source into a VideoFrame object, taking into account
  23 // source and destinations dimensions.
  24 //
  25 // NOTE: rows is *not* the same as height!
  26 MEDIA_EXPORT void CopyYPlane(const uint8* source, int stride, int rows,
  27                              VideoFrame* frame);
  28 MEDIA_EXPORT void CopyUPlane(const uint8* source, int stride, int rows,
  29                              VideoFrame* frame);
  30 MEDIA_EXPORT void CopyVPlane(const uint8* source, int stride, int rows,
  31                              VideoFrame* frame);
  32 MEDIA_EXPORT void CopyAPlane(const uint8* source, int stride, int rows,
  33                              VideoFrame* frame);
  34
  35 // Sets alpha plane values to be completely opaque (all 255's).
  36 MEDIA_EXPORT void MakeOpaqueAPlane(int stride, int rows, VideoFrame* frame);
  37
  38 // |plane| is one of VideoFrame::kYPlane, VideoFrame::kUPlane,
  39 // VideoFrame::kVPlane or VideoFrame::kAPlane
  40 MEDIA_EXPORT void CopyPlane(size_t plane, const uint8* source, int stride,
  41                             int rows, VideoFrame* frame);
  42
  43
  44 // Fills |frame| containing YUV data to the given color values.
  45 MEDIA_EXPORT void FillYUV(VideoFrame* frame, uint8 y, uint8 u, uint8 v);
  46
  47 // Creates a border in |frame| such that all pixels outside of
  48 // |view_area| are black. The size and position of |view_area|
  49 // must be even to align correctly with the color planes.
  50 // Only YV12 format video frames are currently supported.
  51 MEDIA_EXPORT void LetterboxYUV(VideoFrame* frame,
  52                                const gfx::Rect& view_area);
  53
  54 // Rotates |src| plane by |rotation| degree with possible flipping vertically
  55 // and horizontally.
  56 // |rotation| is limited to {0, 90, 180, 270}.
  57 // |width| and |height| are expected to be even numbers.
  58 // Both |src| and |dest| planes are packed and have same |width| and |height|.
  59 // When |width| != |height| and rotated by 90/270, only the maximum square
  60 // portion located in the center is rotated. For example, for width=640 and
  61 // height=480, the rotated area is 480x480 located from row 0 through 479 and
  62 // from column 80 through 559. The leftmost and rightmost 80 columns are
  63 // ignored for both |src| and |dest|.
  64 // The caller is responsible for blanking out the margin area.
  65 MEDIA_EXPORT void RotatePlaneByPixels(
  66     const uint8* src,
  67     uint8* dest,
  68     int width,
  69     int height,
  70     int rotation,  // Clockwise.
  71     bool flip_vert,
  72     bool flip_horiz);
  73
  74 // Return the largest centered rectangle with the same aspect ratio of |content|
  75 // that fits entirely inside of |bounds|.  If |content| is empty, its aspect
  76 // ratio would be undefined; and in this case an empty Rect would be returned.
  77 MEDIA_EXPORT gfx::Rect ComputeLetterboxRegion(const gfx::Rect& bounds,
  78                                               const gfx::Size& content);
  79
  80 // Copy an RGB bitmap into the specified |region_in_frame| of a YUV video frame.
  81 // Fills the regions outside |region_in_frame| with black.
  82 MEDIA_EXPORT void CopyRGBToVideoFrame(const uint8* source,
  83                                       int stride,
  84                                       const gfx::Rect& region_in_frame,
  85                                       VideoFrame* frame);
  86
  87 }  // namespace media
  88
  89 #endif  // MEDIA_BASE_VIDEO_UTIL_H_