remoting/base/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 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/skia/include/core/SkRect.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(const uint8* source_yplane,
  40                                    const uint8* source_uplane,
  41                                    const uint8* source_vplane,
  42                                    int source_ystride,
  43                                    int source_uvstride,
  44                                    const SkISize& source_size,
  45                                    const SkIRect& source_buffer_rect,
  46                                    uint8* dest_buffer,
  47                                    int dest_stride,
  48                                    const SkISize& dest_size,
  49                                    const SkIRect& dest_buffer_rect,
  50                                    const SkIRect& dest_rect);
  51
  52 // Convert RGB32 to YUV on a specific rectangle.
  53 void ConvertRGB32ToYUVWithRect(const uint8* rgb_plane,
  54                                uint8* y_plane,
  55                                uint8* u_plane,
  56                                uint8* v_plane,
  57                                int x,
  58                                int y,
  59                                int width,
  60                                int height,
  61                                int rgb_stride,
  62                                int y_stride,
  63                                int uv_stride);
  64
  65 int RoundToTwosMultiple(int x);
  66
  67 // Align the sides of the rectangle to multiples of 2 (expanding outwards).
  68 SkIRect AlignRect(const SkIRect& rect);
  69
  70 // Scales the supplied rectangle from |in_size| coordinates to |out_size|.
  71 // If the result has non-integer coordinates then the smallest integer-
  72 // coordinate rectangle that wholly encloses it is returned.
  73 SkIRect ScaleRect(const SkIRect& rect,
  74                   const SkISize& in_size,
  75                   const SkISize& out_size);
  76
  77 // Copy content of a rectangle in a RGB32 image.
  78 void CopyRGB32Rect(const uint8* source_buffer,
  79                    int source_stride,
  80                    const SkIRect& source_buffer_rect,
  81                    uint8* dest_buffer,
  82                    int dest_stride,
  83                    const SkIRect& dest_buffer_rect,
  84                    const SkIRect& dest_rect);
  85
  86 // Replaces every occurrence of "\n" in a string by "\r\n".
  87 std::string ReplaceLfByCrLf(const std::string& in);
  88
  89 // Replaces every occurrence of "\r\n" in a string by "\n".
  90 std::string ReplaceCrLfByLf(const std::string& in);
  91
  92 // Checks if the given string is a valid UTF-8 string.
  93 bool StringIsUtf8(const char* data, size_t length);
  94
  95 // Returns the username associated with this process, or the empty string on
  96 // error or if not implemented.
  97 std::string GetUsername();
  98
  99 }  // namespace remoting
 100
 101 #endif  // REMOTING_BASE_UTIL_H_