1 /*
2 * Copyright (C) 2006 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17 #ifndef SkUtils_DEFINED
18 #define SkUtils_DEFINED
19
20 #include "SkTypes.h"
21
22 ///////////////////////////////////////////////////////////////////////////////
23
24 /** Similar to memset(), but it assigns a 16bit value into the buffer.
25 @param buffer The memory to have value copied into it
26 @param value The 16bit value to be copied into buffer
27 @param count The number of times value should be copied into the buffer.
28 */
29 void sk_memset16_portable(uint16_t dst[], uint16_t value, int count);
30 typedef void (*SkMemset16Proc)(uint16_t dst[], uint16_t value, int count);
31 SkMemset16Proc SkMemset16GetPlatformProc();
32
33 /** Similar to memset(), but it assigns a 32bit value into the buffer.
34 @param buffer The memory to have value copied into it
35 @param value The 32bit value to be copied into buffer
36 @param count The number of times value should be copied into the buffer.
37 */
38 void sk_memset32_portable(uint32_t dst[], uint32_t value, int count);
39 typedef void (*SkMemset32Proc)(uint32_t dst[], uint32_t value, int count);
40 SkMemset32Proc SkMemset32GetPlatformProc();
41
42 #if defined(ANDROID) && !defined(SK_BUILD_FOR_ANDROID_NDK)
43 #include "cutils/memory.h"
44
45 #define sk_memset16(dst, value, count) android_memset16(dst, value, (count) << 1)
46 #define sk_memset32(dst, value, count) android_memset32(dst, value, (count) << 2)
47 #endif
48
49 #ifndef sk_memset16
50 extern SkMemset16Proc sk_memset16;
51 #endif
52
53 #ifndef sk_memset32
54 extern SkMemset32Proc sk_memset32;
55 #endif
56
57 ///////////////////////////////////////////////////////////////////////////////
58
59 #define kMaxBytesInUTF8Sequence 4
60
61 #ifdef SK_DEBUG
62 int SkUTF8_LeadByteToCount(unsigned c);
63 #else
64 #define SkUTF8_LeadByteToCount(c) ((((0xE5 << 24) >> ((unsigned)c >> 4 << 1)) & 3) + 1)
65 #endif
66
SkUTF8_CountUTF8Bytes(const char utf8[])67 inline int SkUTF8_CountUTF8Bytes(const char utf8[]) {
68 SkASSERT(utf8);
69 return SkUTF8_LeadByteToCount(*(const uint8_t*)utf8);
70 }
71
72 int SkUTF8_CountUnichars(const char utf8[]);
73 int SkUTF8_CountUnichars(const char utf8[], size_t byteLength);
74 SkUnichar SkUTF8_ToUnichar(const char utf8[]);
75 SkUnichar SkUTF8_NextUnichar(const char**);
76 SkUnichar SkUTF8_PrevUnichar(const char**);
77
78 /** Return the number of bytes need to convert a unichar
79 into a utf8 sequence. Will be 1..kMaxBytesInUTF8Sequence,
80 or 0 if uni is illegal.
81 */
82 size_t SkUTF8_FromUnichar(SkUnichar uni, char utf8[] = NULL);
83
84 ///////////////////////////////////////////////////////////////////////////////
85
86 #define SkUTF16_IsHighSurrogate(c) (((c) & 0xFC00) == 0xD800)
87 #define SkUTF16_IsLowSurrogate(c) (((c) & 0xFC00) == 0xDC00)
88
89 int SkUTF16_CountUnichars(const uint16_t utf16[]);
90 int SkUTF16_CountUnichars(const uint16_t utf16[],
91 int numberOf16BitValues);
92 // returns the current unichar and then moves past it (*p++)
93 SkUnichar SkUTF16_NextUnichar(const uint16_t**);
94 // this guy backs up to the previus unichar value, and returns it (*--p)
95 SkUnichar SkUTF16_PrevUnichar(const uint16_t**);
96 size_t SkUTF16_FromUnichar(SkUnichar uni, uint16_t utf16[] = NULL);
97
98 size_t SkUTF16_ToUTF8(const uint16_t utf16[], int numberOf16BitValues,
99 char utf8[] = NULL);
100
101 ///////////////////////////////////////////////////////////////////////////////
102
103 class SkAutoTrace {
104 public:
105 /** NOTE: label contents are not copied, just the ptr is
106 retained, so DON'T DELETE IT.
107 */
SkAutoTrace(const char label[])108 SkAutoTrace(const char label[]) : fLabel(label) {
109 SkDebugf("--- trace: %s Enter\n", fLabel);
110 }
~SkAutoTrace()111 ~SkAutoTrace() {
112 SkDebugf("--- trace: %s Leave\n", fLabel);
113 }
114 private:
115 const char* fLabel;
116 };
117
118 ///////////////////////////////////////////////////////////////////////////////
119
120 class SkAutoMemoryUsageProbe {
121 public:
122 /** Record memory usage in constructor, and dump the result
123 (delta and current total) in the destructor, with the optional
124 label. NOTE: label contents are not copied, just the ptr is
125 retained, so DON'T DELETE IT.
126 */
127 SkAutoMemoryUsageProbe(const char label[]);
128 ~SkAutoMemoryUsageProbe();
129 private:
130 const char* fLabel;
131 size_t fBytesAllocated;
132 };
133
134 #endif
135
136