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