Home | History | Annotate | Download | only in wtf
      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 final : 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 type() const override
     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