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
34namespace WTF {
35
36class Uint8ClampedArray final : public Uint8Array {
37public:
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
62private:
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
70PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::create(unsigned length)
71{
72    return TypedArrayBase<unsigned char>::create<Uint8ClampedArray>(length);
73}
74
75PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::create(const unsigned char* array, unsigned length)
76{
77    return TypedArrayBase<unsigned char>::create<Uint8ClampedArray>(array, length);
78}
79
80PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::create(PassRefPtr<ArrayBuffer> buffer, unsigned byteOffset, unsigned length)
81{
82    return TypedArrayBase<unsigned char>::create<Uint8ClampedArray>(buffer, byteOffset, length);
83}
84
85PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::createUninitialized(unsigned length)
86{
87    return TypedArrayBase<unsigned char>::createUninitialized<Uint8ClampedArray>(length);
88}
89
90void Uint8ClampedArray::zeroFill()
91{
92    zeroRange(0, length());
93}
94
95void 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
106Uint8ClampedArray::Uint8ClampedArray(PassRefPtr<ArrayBuffer> buffer, unsigned byteOffset, unsigned length)
107: Uint8Array(buffer, byteOffset, length)
108{
109}
110
111PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::subarray(int start) const
112{
113    return subarray(start, length());
114}
115
116PassRefPtr<Uint8ClampedArray> Uint8ClampedArray::subarray(int start, int end) const
117{
118    return subarrayImpl<Uint8ClampedArray>(start, end);
119}
120
121} // namespace WTF
122
123using WTF::Uint8ClampedArray;
124
125#endif // Uint8ClampedArray_h
126