WebGLTexture.h revision 2fc2651226baac27029e38c9d6ef883fa32084db
1/*
2 * Copyright (C) 2009 Apple Inc. All rights reserved.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 * 1. Redistributions of source code must retain the above copyright
8 *    notice, this list of conditions and the following disclaimer.
9 * 2. Redistributions in binary form must reproduce the above copyright
10 *    notice, this list of conditions and the following disclaimer in the
11 *    documentation and/or other materials provided with the distribution.
12 *
13 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24 */
25
26#ifndef WebGLTexture_h
27#define WebGLTexture_h
28
29#include "WebGLObject.h"
30
31#include <wtf/PassRefPtr.h>
32#include <wtf/RefCounted.h>
33#include <wtf/Vector.h>
34
35namespace WebCore {
36
37class WebGLTexture : public WebGLObject {
38public:
39    virtual ~WebGLTexture() { deleteObject(); }
40
41    static PassRefPtr<WebGLTexture> create(WebGLRenderingContext*);
42
43    void setTarget(GC3Denum target, GC3Dint maxLevel);
44    void setParameteri(GC3Denum pname, GC3Dint param);
45    void setParameterf(GC3Denum pname, GC3Dfloat param);
46
47    GC3Denum getTarget() const { return m_target; }
48
49    int getMinFilter() const { return m_minFilter; }
50
51    void setLevelInfo(GC3Denum target, GC3Dint level, GC3Denum internalFormat, GC3Dsizei width, GC3Dsizei height, GC3Denum type);
52
53    bool canGenerateMipmaps();
54    // Generate all level information.
55    void generateMipmapLevelInfo();
56
57    GC3Denum getInternalFormat(GC3Denum target, GC3Dint level) const;
58    GC3Denum getType(GC3Denum target, GC3Dint level) const;
59    GC3Dsizei getWidth(GC3Denum target, GC3Dint level) const;
60    GC3Dsizei getHeight(GC3Denum target, GC3Dint level) const;
61
62    // Whether width/height is NotPowerOfTwo.
63    static bool isNPOT(GC3Dsizei, GC3Dsizei);
64
65    bool isNPOT() const;
66    // Determine if texture sampling should always return [0, 0, 0, 1] (OpenGL ES 2.0 Sec 3.8.2).
67    bool needToUseBlackTexture() const;
68
69    bool hasEverBeenBound() const { return object() && m_target; }
70
71    static GC3Dint computeLevelCount(GC3Dsizei width, GC3Dsizei height);
72
73protected:
74    WebGLTexture(WebGLRenderingContext*);
75
76    virtual void deleteObjectImpl(Platform3DObject);
77
78private:
79    class LevelInfo {
80    public:
81        LevelInfo()
82            : valid(false)
83            , internalFormat(0)
84            , width(0)
85            , height(0)
86            , type(0)
87        {
88        }
89
90        void setInfo(GC3Denum internalFmt, GC3Dsizei w, GC3Dsizei h, GC3Denum tp)
91        {
92            valid = true;
93            internalFormat = internalFmt;
94            width = w;
95            height = h;
96            type = tp;
97        }
98
99        bool valid;
100        GC3Denum internalFormat;
101        GC3Dsizei width;
102        GC3Dsizei height;
103        GC3Denum type;
104    };
105
106    virtual bool isTexture() const { return true; }
107
108    void update();
109
110    int mapTargetToIndex(GC3Denum) const;
111
112    const LevelInfo* getLevelInfo(GC3Denum target, GC3Dint level) const;
113
114    GC3Denum m_target;
115
116    GC3Denum m_minFilter;
117    GC3Denum m_magFilter;
118    GC3Denum m_wrapS;
119    GC3Denum m_wrapT;
120
121    Vector<Vector<LevelInfo> > m_info;
122
123    bool m_isNPOT;
124    bool m_isComplete;
125    bool m_needToUseBlackTexture;
126};
127
128} // namespace WebCore
129
130#endif // WebGLTexture_h
131