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 int RoundToTwosMultiple(int x);
     54 
     55 // Align the sides of the rectangle to multiples of 2 (expanding outwards).
     56 webrtc::DesktopRect AlignRect(const webrtc::DesktopRect& rect);
     57 
     58 // Scales the supplied rectangle from |in_size| coordinates to |out_size|.
     59 // If the result has non-integer coordinates then the smallest integer-
     60 // coordinate rectangle that wholly encloses it is returned.
     61 webrtc::DesktopRect ScaleRect(const webrtc::DesktopRect& rect,
     62                               const webrtc::DesktopSize& in_size,
     63                               const webrtc::DesktopSize& out_size);
     64 
     65 // Copy content of a rectangle in a RGB32 image.
     66 void CopyRGB32Rect(const uint8* source_buffer,
     67                    int source_stride,
     68                    const webrtc::DesktopRect& source_buffer_rect,
     69                    uint8* dest_buffer,
     70                    int dest_stride,
     71                    const webrtc::DesktopRect& dest_buffer_rect,
     72                    const webrtc::DesktopRect& dest_rect);
     73 
     74 // Replaces every occurrence of "\n" in a string by "\r\n".
     75 std::string ReplaceLfByCrLf(const std::string& in);
     76 
     77 // Replaces every occurrence of "\r\n" in a string by "\n".
     78 std::string ReplaceCrLfByLf(const std::string& in);
     79 
     80 // Checks if the given string is a valid UTF-8 string.
     81 bool StringIsUtf8(const char* data, size_t length);
     82 
     83 bool DoesRectContain(const webrtc::DesktopRect& a,
     84                      const webrtc::DesktopRect& b);
     85 
     86 }  // namespace remoting
     87 
     88 #endif  // REMOTING_BASE_UTIL_H_
     89