Copyright | (c) Sven Panne 2002-2019 |
---|---|
License | BSD3 |
Maintainer | Sven Panne <svenpanne@gmail.com> |
Stability | stable |
Portability | portable |
Safe Haskell | None |
Language | Haskell2010 |
This module corresponds to section 2.7 (Vertex Specification) of the OpenGL 2.1 specs.
Synopsis
- class Vertex a where
- class VertexComponent a
- currentTextureCoords :: StateVar (TexCoord4 GLfloat)
- class TexCoord a where
- texCoord :: a -> IO ()
- texCoordv :: Ptr a -> IO ()
- multiTexCoord :: TextureUnit -> a -> IO ()
- multiTexCoordv :: TextureUnit -> Ptr a -> IO ()
- class TexCoordComponent a
- newtype TexCoord1 a = TexCoord1 a
- data TexCoord2 a = TexCoord2 !a !a
- data TexCoord3 a = TexCoord3 !a !a !a
- data TexCoord4 a = TexCoord4 !a !a !a !a
- currentNormal :: StateVar (Normal3 GLfloat)
- class Normal a where
- class NormalComponent a
- data Normal3 a = Normal3 !a !a !a
- currentFogCoord :: StateVar (FogCoord1 GLfloat)
- class FogCoord a where
- class FogCoordComponent a
- newtype FogCoord1 a = FogCoord1 a
- rgbaMode :: GettableStateVar Bool
- currentColor :: StateVar (Color4 GLfloat)
- class Color a where
- currentSecondaryColor :: StateVar (Color3 GLfloat)
- class SecondaryColor a where
- secondaryColor :: a -> IO ()
- secondaryColorv :: Ptr a -> IO ()
- class ColorComponent a
- data Color3 a = Color3 !a !a !a
- data Color4 a = Color4 !a !a !a !a
- currentIndex :: StateVar (Index1 GLint)
- class Index a where
- class IndexComponent a
- newtype Index1 a = Index1 a
- data IntegerHandling
- newtype AttribLocation = AttribLocation GLuint
- currentVertexAttrib :: AttribLocation -> StateVar (Vertex4 GLfloat)
- currentVertexAttribI :: AttribLocation -> StateVar (Vertex4 GLint)
- currentVertexAttribIu :: AttribLocation -> StateVar (Vertex4 GLuint)
- class VertexAttrib a where
- vertexAttrib :: IntegerHandling -> AttribLocation -> a -> IO ()
- vertexAttribv :: IntegerHandling -> AttribLocation -> Ptr a -> IO ()
- class (Storable a, Num a) => VertexAttribComponent a where
- vertexAttrib1 :: AttribLocation -> a -> IO ()
- vertexAttrib2 :: AttribLocation -> a -> a -> IO ()
- vertexAttrib3 :: AttribLocation -> a -> a -> a -> IO ()
- vertexAttrib4 :: AttribLocation -> a -> a -> a -> a -> IO ()
- vertexAttrib1N :: AttribLocation -> a -> IO ()
- vertexAttrib2N :: AttribLocation -> a -> a -> IO ()
- vertexAttrib3N :: AttribLocation -> a -> a -> a -> IO ()
- vertexAttrib4N :: AttribLocation -> a -> a -> a -> a -> IO ()
- vertexAttrib1I :: AttribLocation -> a -> IO ()
- vertexAttrib2I :: AttribLocation -> a -> a -> IO ()
- vertexAttrib3I :: AttribLocation -> a -> a -> a -> IO ()
- vertexAttrib4I :: AttribLocation -> a -> a -> a -> a -> IO ()
- vertexAttrib1v :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib2v :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib3v :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib4v :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib1Nv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib2Nv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib3Nv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib4Nv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib1Iv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib2Iv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib3Iv :: AttribLocation -> Ptr a -> IO ()
- vertexAttrib4Iv :: AttribLocation -> Ptr a -> IO ()
- newtype TextureUnit = TextureUnit GLuint
- maxTextureUnit :: GettableStateVar TextureUnit
Vertex Coordinates
Specify the (x, y, z, w) coordinates of a four-dimensional vertex.
This must only be done during
renderPrimitive
, otherwise the
behaviour is unspecified. The current values of the auxiliary vertex
attributes are associated with the vertex.
Note that there is no such thing as a "current vertex" which could be retrieved.
Instances
VertexComponent a => Vertex (Vertex4 a) Source # | |
VertexComponent a => Vertex (Vertex3 a) Source # | |
VertexComponent a => Vertex (Vertex2 a) Source # | |
class VertexComponent a Source #
The class of all types which can be used as a vertex coordinate.
vertex2, vertex3, vertex4, vertex2v, vertex3v, vertex4v
Auxiliary Vertex Attributes
Apart from its coordinates in four-dimensional space, every vertex has associated auxiliary attributes: Its texture coordinates, a normal, a fog coordinate, and a color plus a secondary color. For every attribute, the OpenGL state contains its current value, which can be changed at any time.
Every attribute has a "natural" format via which it can be manipulated
directly as part of the OpenGL state, e.g. the current texture coordinates
are internally handled as
. Different formats are
converted to this format, e.g. the s, r, and t coordinates of a
TexCoord4
GLfloat
are converted to floating point values and a q
coordinate of 1.0 is implicitly assumed.TexCoord3
GLint
Consequently, the vast majority of classes, functions, and data types in this module are for convenience only and offer no additional functionality.
Texture Coordinates
currentTextureCoords :: StateVar (TexCoord4 GLfloat) Source #
The current texture coordinates (s, t, r, q) for the current
texture unit (see activeTexture
).
The initial value is (0,0,0,1) for all texture units.
class TexCoord a where Source #
Change the current texture coordinates of the current or given texture unit.
texCoord :: a -> IO () Source #
texCoordv :: Ptr a -> IO () Source #
multiTexCoord :: TextureUnit -> a -> IO () Source #
multiTexCoordv :: TextureUnit -> Ptr a -> IO () Source #
Instances
TexCoordComponent a => TexCoord (TexCoord4 a) Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec | |
TexCoordComponent a => TexCoord (TexCoord3 a) Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec | |
TexCoordComponent a => TexCoord (TexCoord2 a) Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec | |
TexCoordComponent a => TexCoord (TexCoord1 a) Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec |
class TexCoordComponent a Source #
The class of all types which can be used as a texture coordinate.
texCoord1, texCoord2, texCoord3, texCoord4, texCoord1v, texCoord2v, texCoord3v, texCoord4v, multiTexCoord1, multiTexCoord2, multiTexCoord3, multiTexCoord4, multiTexCoord1v, multiTexCoord2v, multiTexCoord3v, multiTexCoord4v
Instances
Texture coordinates with t=0, r=0, and q=1.
Instances
Texture coordinates with r=0 and q=1.
TexCoord2 !a !a |
Instances
Texture coordinates with q=1.
TexCoord3 !a !a !a |
Instances
Fully-fledged four-dimensional texture coordinates.
TexCoord4 !a !a !a !a |
Instances
Normal
currentNormal :: StateVar (Normal3 GLfloat) Source #
The current normal (x, y, z). The initial value is the unit vector (0, 0, 1).
Change the current normal. Integral arguments are converted to floating-point with a linear mapping that maps the most positive representable integer value to 1.0, and the most negative representable integer value to -1.0.
Normals specified with normal
or normalv
need not have unit length.
If normalize
is enabled, then
normals of any length specified with normal
or normalv
are normalized
after transformation. If
rescaleNormal
is enabled, normals
are scaled by a scaling factor derived from the modelview matrix.
rescaleNormal
requires that the
originally specified normals were of unit length, and that the modelview
matrix contains only uniform scales for proper results. Normalization is
initially disabled.
class NormalComponent a Source #
The class of all types which can be used as a component of a normal.
normal3, normal3v
Normal3 !a !a !a |
Instances
Fog Coordinate
currentFogCoord :: StateVar (FogCoord1 GLfloat) Source #
The current fog coordinate. The initial value is 0.
class FogCoordComponent a Source #
The class of all types which can be used as the fog coordinate.
fogCoord1, fogCoord1v
Instances
FogCoordComponent GLfloat Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec | |
FogCoordComponent GLdouble Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec |
A fog coordinate.
Instances
Color and Secondary Color
Change the current color.
Instances
ColorComponent a => Color (Color4 a) Source # | |
ColorComponent a => Color (Color3 a) Source # | |
class SecondaryColor a where Source #
Change the current secondary color.
secondaryColor :: a -> IO () Source #
secondaryColorv :: Ptr a -> IO () Source #
Instances
ColorComponent a => SecondaryColor (Color3 a) Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec |
class ColorComponent a Source #
The class of all types which can be used as a color component.
color3, color4, color3v, color4v, secondaryColor3, secondaryColor3v
Instances
Color3 !a !a !a |
Instances
A fully-fledged RGBA color.
Color4 !a !a !a !a |
Instances
Change the current color index.
class IndexComponent a Source #
The class of all types which can be used as a color index.
index1, index1v
A color index.
Index1 a |
Instances
Generic Vertex Attributes
data IntegerHandling Source #
Instances
Eq IntegerHandling Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec (==) :: IntegerHandling -> IntegerHandling -> Bool # (/=) :: IntegerHandling -> IntegerHandling -> Bool # | |
Ord IntegerHandling Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec compare :: IntegerHandling -> IntegerHandling -> Ordering # (<) :: IntegerHandling -> IntegerHandling -> Bool # (<=) :: IntegerHandling -> IntegerHandling -> Bool # (>) :: IntegerHandling -> IntegerHandling -> Bool # (>=) :: IntegerHandling -> IntegerHandling -> Bool # max :: IntegerHandling -> IntegerHandling -> IntegerHandling # min :: IntegerHandling -> IntegerHandling -> IntegerHandling # | |
Show IntegerHandling Source # | |
Defined in Graphics.Rendering.OpenGL.GL.VertexSpec showsPrec :: Int -> IntegerHandling -> ShowS # show :: IntegerHandling -> String # showList :: [IntegerHandling] -> ShowS # |
newtype AttribLocation Source #
Instances
Eq AttribLocation Source # | |
Defined in Graphics.Rendering.OpenGL.GL.QueryUtils.VertexAttrib (==) :: AttribLocation -> AttribLocation -> Bool # (/=) :: AttribLocation -> AttribLocation -> Bool # | |
Ord AttribLocation Source # | |
Defined in Graphics.Rendering.OpenGL.GL.QueryUtils.VertexAttrib compare :: AttribLocation -> AttribLocation -> Ordering # (<) :: AttribLocation -> AttribLocation -> Bool # (<=) :: AttribLocation -> AttribLocation -> Bool # (>) :: AttribLocation -> AttribLocation -> Bool # (>=) :: AttribLocation -> AttribLocation -> Bool # max :: AttribLocation -> AttribLocation -> AttribLocation # min :: AttribLocation -> AttribLocation -> AttribLocation # | |
Show AttribLocation Source # | |
Defined in Graphics.Rendering.OpenGL.GL.QueryUtils.VertexAttrib showsPrec :: Int -> AttribLocation -> ShowS # show :: AttribLocation -> String # showList :: [AttribLocation] -> ShowS # |
class VertexAttrib a where Source #
vertexAttrib :: IntegerHandling -> AttribLocation -> a -> IO () Source #
vertexAttribv :: IntegerHandling -> AttribLocation -> Ptr a -> IO () Source #
Instances
class (Storable a, Num a) => VertexAttribComponent a where Source #
The class of all types which can be used as a generic vertex attribute. NOTE: Do not use the methods of this class directly, they were only exported by accident and will be hidden in future versions of this package.
vertexAttrib1 :: AttribLocation -> a -> IO () Source #
vertexAttrib2 :: AttribLocation -> a -> a -> IO () Source #
vertexAttrib3 :: AttribLocation -> a -> a -> a -> IO () Source #
vertexAttrib4 :: AttribLocation -> a -> a -> a -> a -> IO () Source #
vertexAttrib1N :: AttribLocation -> a -> IO () Source #
vertexAttrib2N :: AttribLocation -> a -> a -> IO () Source #
vertexAttrib3N :: AttribLocation -> a -> a -> a -> IO () Source #
vertexAttrib4N :: AttribLocation -> a -> a -> a -> a -> IO () Source #
vertexAttrib1I :: AttribLocation -> a -> IO () Source #
vertexAttrib2I :: AttribLocation -> a -> a -> IO () Source #
vertexAttrib3I :: AttribLocation -> a -> a -> a -> IO () Source #
vertexAttrib4I :: AttribLocation -> a -> a -> a -> a -> IO () Source #
vertexAttrib1v :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib2v :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib3v :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib4v :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib1Nv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib2Nv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib3Nv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib4Nv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib1Iv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib2Iv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib3Iv :: AttribLocation -> Ptr a -> IO () Source #
vertexAttrib4Iv :: AttribLocation -> Ptr a -> IO () Source #
Instances
Texture Units
newtype TextureUnit Source #
Identifies a texture unit via its number, which must be in the range of
(0 .. maxTextureUnit
).
Instances
maxTextureUnit :: GettableStateVar TextureUnit Source #
An implementation must support at least 2 texture units, but it may support up to 32 ones. This state variable can be used to query the actual implementation limit.