WebGLTexture.h revision cad810f21b803229eb11403f9209855525a25d57 
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(unsigned long target, int maxLevel);
44    void setParameteri(unsigned long pname, int param);
45    void setParameterf(unsigned long pname, float param);
46
47    int getMinFilter() const { return m_minFilter; }
48
49    void setLevelInfo(unsigned long target, int level, unsigned long internalFormat, int width, int height, unsigned long type);
50
51    bool canGenerateMipmaps();
52    // Generate all level information.
53    void generateMipmapLevelInfo();
54
55    unsigned long getInternalFormat(unsigned long target, int level) const;
56    unsigned long getType(unsigned long target, int level) const;
57    int getWidth(unsigned long target, int level) const;
58    int getHeight(unsigned long target, int level) const;
59
60    // Whether width/height is NotPowerOfTwo.
61    static bool isNPOT(unsigned, unsigned);
62
63    bool isNPOT() const;
64    // Determine if texture sampling should always return [0, 0, 0, 1] (OpenGL ES 2.0 Sec 3.8.2).
65    bool needToUseBlackTexture() const;
66
67    bool hasEverBeenBound() const { return object() && m_target; }
68
69    static int computeLevelCount(int width, int height);
70
71protected:
72    WebGLTexture(WebGLRenderingContext*);
73
74    virtual void deleteObjectImpl(Platform3DObject);
75
76private:
77    class LevelInfo {
78    public:
79        LevelInfo()
80            : valid(false)
81            , internalFormat(0)
82            , width(0)
83            , height(0)
84            , type(0)
85        {
86        }
87
88        void setInfo(unsigned long internalFmt, int w, int h, unsigned long tp)
89        {
90            valid = true;
91            internalFormat = internalFmt;
92            width = w;
93            height = h;
94            type = tp;
95        }
96
97        bool valid;
98        unsigned long internalFormat;
99        int width;
100        int height;
101        unsigned long type;
102    };
103
104    virtual bool isTexture() const { return true; }
105
106    void update();
107
108    int mapTargetToIndex(unsigned long) const;
109
110    const LevelInfo* getLevelInfo(unsigned long target, int level) const;
111
112    unsigned long m_target;
113
114    int m_minFilter;
115    int m_magFilter;
116    int m_wrapS;
117    int m_wrapT;
118
119    Vector<Vector<LevelInfo> > m_info;
120
121    bool m_isNPOT;
122    bool m_isComplete;
123    bool m_needToUseBlackTexture;
124};
125
126} // namespace WebCore
127
128#endif // WebGLTexture_h
129