1 /* 2 * Copyright (C) 2009 Apple Inc. All rights reserved. 3 * Copyright (C) 2009 Google Inc. All rights reserved. 4 * Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY 16 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 18 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR 19 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 20 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 22 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY 23 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 25 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 */ 27 28 #ifndef Uint8ClampedArray_h 29 #define Uint8ClampedArray_h 30 31 #include "wtf/Uint8Array.h" 32 #include "wtf/MathExtras.h" 33 34 namespace WTF { 35 36 class Uint8ClampedArray : public Uint8Array { 37 public: 38 static inline PassRefPtr<Uint8ClampedArray> create(unsigned length); 39 static inline PassRefPtr<Uint8ClampedArray> create(const unsigned char* array, unsigned length); 40 static inline PassRefPtr<Uint8ClampedArray> create(PassRefPtr<ArrayBuffer>, unsigned byteOffset, unsigned length); 41 42 // Should only be used when it is known the entire array will be filled. Do 43 // not return these results directly to JavaScript without filling first. 44 static inline PassRefPtr<Uint8ClampedArray> createUninitialized(unsigned length); 45 46 // It's only needed to potentially call this method if the array 47 // was created uninitialized -- the default initialization paths 48 // zero the allocated memory. 49 inline void zeroFill(); 50 51 using TypedArrayBase<unsigned char>::set; 52 inline void set(unsigned index, double value); 53 54 inline PassRefPtr<Uint8ClampedArray> subarray(int start) const; 55 inline PassRefPtr<Uint8ClampedArray> subarray(int start, int end) const; 56 57 virtual ViewType getType() const 58 { 59 return TypeUint8Clamped; 60 } 61 62 private: 63 inline Uint8ClampedArray(PassRefPtr<ArrayBuffer>, 64 unsigned byteOffset, 65 unsigned length); 66 // Make constructor visible to superclass. 67 friend class TypedArrayBase<unsigned char>; 68 }; 69 70 PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::create(unsigned length) 71 { 72 return TypedArrayBase<unsigned char>::create<Uint8ClampedArray>(length); 73 } 74 75 PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::create(const unsigned char* array, unsigned length) 76 { 77 return TypedArrayBase<unsigned char>::create<Uint8ClampedArray>(array, length); 78 } 79 80 PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::create(PassRefPtr<ArrayBuffer> buffer, unsigned byteOffset, unsigned length) 81 { 82 return TypedArrayBase<unsigned char>::create<Uint8ClampedArray>(buffer, byteOffset, length); 83 } 84 85 PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::createUninitialized(unsigned length) 86 { 87 return TypedArrayBase<unsigned char>::createUninitialized<Uint8ClampedArray>(length); 88 } 89 90 void Uint8ClampedArray::zeroFill() 91 { 92 zeroRange(0, length()); 93 } 94 95 void Uint8ClampedArray::set(unsigned index, double value) 96 { 97 if (index >= m_length) 98 return; 99 if (std::isnan(value) || value < 0) 100 value = 0; 101 else if (value > 255) 102 value = 255; 103 data()[index] = static_cast<unsigned char>(lrint(value)); 104 } 105 106 Uint8ClampedArray::Uint8ClampedArray(PassRefPtr<ArrayBuffer> buffer, unsigned byteOffset, unsigned length) 107 : Uint8Array(buffer, byteOffset, length) 108 { 109 } 110 111 PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::subarray(int start) const 112 { 113 return subarray(start, length()); 114 } 115 116 PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::subarray(int start, int end) const 117 { 118 return subarrayImpl<Uint8ClampedArray>(start, end); 119 } 120 121 } // namespace WTF 122 123 using WTF::Uint8ClampedArray; 124 125 #endif // Uint8ClampedArray_h 126