Home | History | Annotate | Download | only in base
      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 REMOTING_BASE_UTIL_H_
      6 #define REMOTING_BASE_UTIL_H_
      7 
      8 #include <string>
      9 
     10 #include "media/base/video_frame.h"
     11 #include "third_party/webrtc/modules/desktop_capture/desktop_geometry.h"
     12 
     13 namespace remoting {
     14 
     15 // Return a string that contains the current date formatted as 'MMDD/HHMMSS:'.
     16 std::string GetTimestampString();
     17 
     18 // Calculate the offset of a specific pixel in an RGB32 buffer.
     19 int CalculateRGBOffset(int x, int y, int stride);
     20 
     21 // Calculate the offset of a specific pixel in a YV12/YUV420 buffer. Note that
     22 // the X and Y coordinates must both be even owing to the YV12 buffer layout.
     23 int CalculateYOffset(int x, int y, int stride);
     24 int CalculateUVOffset(int x, int y, int stride);
     25 
     26 // Convert and scale YUV to RGB32 on a specific rectangle. The source and
     27 // destination buffers are assumed to contain only |source_buffer_rect| and
     28 // |dest_buffer_rect| areas correspondingly. The scaling factor is determined
     29 // as ratio between |dest_size| and |source_size|. The target rectangle
     30 // |dect_rect| is specified in the destination coordinates.
     31 //
     32 // |source_buffer_rect| and |dest_buffer_rect| must fall entirely within
     33 // the source and destination dimensions, respectively. |dest_rect| must be
     34 // completely contained within the source and destinations buffers boundaries
     35 // including the case when scaling is requested.
     36 //
     37 // N.B. The top left corner coordinates of YUV buffer should have even X and Y
     38 // coordinates.
     39 void ConvertAndScaleYUVToRGB32Rect(
     40     const uint8* source_yplane,
     41     const uint8* source_uplane,
     42     const uint8* source_vplane,
     43     int source_ystride,
     44     int source_uvstride,
     45     const webrtc::DesktopSize& source_size,
     46     const webrtc::DesktopRect& source_buffer_rect,
     47     uint8* dest_buffer,
     48     int dest_stride,
     49     const webrtc::DesktopSize& dest_size,
     50     const webrtc::DesktopRect& dest_buffer_rect,
     51     const webrtc::DesktopRect& dest_rect);
     52 
     53 // Convert RGB32 to YUV on a specific rectangle.
     54 void ConvertRGB32ToYUVWithRect(const uint8* rgb_plane,
     55                                uint8* y_plane,
     56                                uint8* u_plane,
     57                                uint8* v_plane,
     58                                int x,
     59                                int y,
     60                                int width,
     61                                int height,
     62                                int rgb_stride,
     63                                int y_stride,
     64                                int uv_stride);
     65 
     66 int RoundToTwosMultiple(int x);
     67 
     68 // Align the sides of the rectangle to multiples of 2 (expanding outwards).
     69 webrtc::DesktopRect AlignRect(const webrtc::DesktopRect& rect);
     70 
     71 // Scales the supplied rectangle from |in_size| coordinates to |out_size|.
     72 // If the result has non-integer coordinates then the smallest integer-
     73 // coordinate rectangle that wholly encloses it is returned.
     74 webrtc::DesktopRect ScaleRect(const webrtc::DesktopRect& rect,
     75                               const webrtc::DesktopSize& in_size,
     76                               const webrtc::DesktopSize& out_size);
     77 
     78 // Copy content of a rectangle in a RGB32 image.
     79 void CopyRGB32Rect(const uint8* source_buffer,
     80                    int source_stride,
     81                    const webrtc::DesktopRect& source_buffer_rect,
     82                    uint8* dest_buffer,
     83                    int dest_stride,
     84                    const webrtc::DesktopRect& dest_buffer_rect,
     85                    const webrtc::DesktopRect& dest_rect);
     86 
     87 // Replaces every occurrence of "\n" in a string by "\r\n".
     88 std::string ReplaceLfByCrLf(const std::string& in);
     89 
     90 // Replaces every occurrence of "\r\n" in a string by "\n".
     91 std::string ReplaceCrLfByLf(const std::string& in);
     92 
     93 // Checks if the given string is a valid UTF-8 string.
     94 bool StringIsUtf8(const char* data, size_t length);
     95 
     96 bool DoesRectContain(const webrtc::DesktopRect& a,
     97                      const webrtc::DesktopRect& b);
     98 
     99 }  // namespace remoting
    100 
    101 #endif  // REMOTING_BASE_UTIL_H_
    102