Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: orxonox.OLD/trunk/src/lib/graphics/importer/texture.cc @ 8373

Last change on this file since 8373 was 8366, checked in by bensch, 18 years ago

orxonox/trunk: some doxytags in Texture.

File size: 9.6 KB
Line 
1/*
2   orxonox - the future of 3D-vertical-scrollers
3
4   Copyright (C) 2004 orx
5
6   This program is free software; you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation; either version 2, or (at your option)
9   any later version.
10
11   ### File Specific:
12   main-programmer: Benjamin Grauer
13   co-programmer: ...
14*/
15
16#define DEBUG_SPECIAL_MODULE DEBUG_MODULE_IMPORTER
17
18#include "texture.h"
19
20#include "debug.h"
21#include "compiler.h"
22
23#ifdef HAVE_SDL_SDL_H
24#include <SDL/SDL_image.h>
25#include <SDL/SDL_endian.h>
26#include <SDL/SDL_byteorder.h>
27#else
28#include <SDL_endian.h>
29#include <SDL_image.h>
30#include <SDL_byteorder.h>
31#endif
32#if SDL_BYTEORDER == SDL_BIG_ENDIAN
33/*
34 * On the BIG_ENDIAN architecture, the 24 and 32bit bitmaps have
35 * different masks. If you don't do this distinction properly,
36 * you will get weird-looking textures.
37 */
38Uint32 alphaMask[] = {
39                       0xFF000000,
40                       0x00FF0000,
41                       0x0000FF00,
42                       0x000000FF,
43                     };
44
45Uint32 opaqueMask[] = {
46                        0x00FF0000,
47                        0x0000FF00,
48                        0x000000FF,
49                        0xFF000000
50                      };
51#else
52/*
53* On the LIL_ENDIAN architecture everything is fine and easy. The 24
54* and 32bit bitmaps have the same masks.
55*/
56Uint32 alphaMask[] = {
57                       0x000000FF,
58                       0x0000FF00,
59                       0x00FF0000,
60                       0xFF000000,
61                     };
62
63Uint32 *opaqueMask = alphaMask;
64#endif
65
66
67
68/**
69 * @brief creates an Empty Texture,
70 *
71 * onto this Texture you can load non-empty textures with the =
72 * operator.
73 */
74Texture::Texture()
75{
76  this->init();
77}
78
79/**
80 * @brief Creates a Texture from another Texture (copy Constructor)
81 * @param texture the Texture to copy.
82 *
83 * @note only the Data-Pointer will be shared.
84 */
85Texture::Texture(const Texture& texture)
86    : data(texture.data)
87{
88  this->setClassID(CL_TEXTURE, "Texture");
89  this->priority = 0.5;
90}
91
92/**
93 * @brief Creates a new empty Texture with the below properties.
94 * @param target: the GL-Target.
95 * @param width: the Width of the Texture.
96 * @param height: The Hight of the Texture.
97 * @param channels: also known as BitsPerPixel.
98 * @param type the Type of Texture.
99 */
100Texture::Texture(GLenum target, unsigned int width, unsigned int height, unsigned int channels, GLenum type)
101{
102  this->init();
103
104  SDL_Surface * surface = SDL_CreateRGBSurface(SDL_HWSURFACE, width, height, channels,
105                          alphaMask[0], alphaMask[1], alphaMask[2], alphaMask[3]);
106
107  if(surface != NULL)
108  {
109    this->data->loadSurface(surface, target);
110    SDL_FreeSurface(surface);
111  }
112}
113
114/**
115 * @brief Constructor for a Texture
116 * @param imageName: the Name of the Texutre (FileName)
117 * @param target: the GL-Target to load the Texture to.
118 */
119Texture::Texture(const std::string& imageName, GLenum target)
120{
121  this->init();
122
123  if (!imageName.empty())
124  {
125    this->setName(imageName);
126    this->loadImage(imageName, target);
127  }
128}
129
130
131/**
132 * @brief creates a Texture out of a SDL_Surface.
133 * @param surface: the Surface to load.
134 * @param target: the GL-Target to load this to.
135 */
136Texture::Texture(SDL_Surface* surface, GLenum target)
137{
138  this->init();
139
140  if(surface != NULL)
141  {
142    this->data->loadSurface(surface, target);
143  }
144}
145
146/**
147 * @brief Initializes the Texture.
148 */
149void Texture::init()
150{
151  this->setClassID(CL_TEXTURE, "Texture");
152
153  this->data = CountPointer<TextureData>(new TextureData());
154
155  this->priority = 0.5;
156}
157
158/**
159 * @brief Destructor of a Texture
160 *
161 * Frees Data, and deletes the textures from GL
162 */
163Texture::~Texture()
164{}
165
166
167/**
168 * @brief loads an Image from a file to a Texture
169 * @param imageName The image to load
170*/
171bool Texture::loadImage(const std::string& imageName, GLenum target)
172{
173  if (Texture::texturesEnabled)
174  {
175    if (!imageName.empty())
176    {
177      SDL_Surface* tmpSurf;
178
179      // load the new Image to memory
180      tmpSurf = IMG_Load(imageName.c_str());
181      if(tmpSurf != NULL)
182      {
183        this->data->loadSurface(tmpSurf, target);
184        SDL_FreeSurface(tmpSurf);
185        return true;
186      }
187      else
188      {
189        PRINTF(1)("IMG_Load: %s\n", IMG_GetError());
190        this->setTexture(0);
191        return false;
192      }
193    }
194    else
195    {
196      PRINTF(2)("Image-Name not specified\n");
197      return false;
198    }
199  }
200  return false;
201}
202
203/**
204 * @brief rebuilds the texture.
205 *
206 * reloads the Texture from Memory to OpenGL.
207 */
208bool Texture::rebuild()
209{
210  this->data->setTexture(0);
211
212  if (this->data->getStoredImage() != NULL)
213  {
214    PRINTF(3)("Reloading Texture of %s '%s'\n", this->getClassName(), this->getName());
215    this->setTexture(Texture::loadTexToGL(this->data->getStoredImage()));
216  }
217  return true;
218}
219
220bool Texture::texturesEnabled = true;
221
222/**
223 * @brief enables, disables textures
224 * @param texturesEnabled true if the textures should be enabled
225 */
226void Texture::setTextureEnableState(bool texturesEnabled)
227{
228  Texture::texturesEnabled = texturesEnabled;
229}
230
231
232//////////////////////////////////////
233// UTILITY FUNCTIONALITY OF TEXTURE //
234//////////////////////////////////////
235/**
236 * @brief converts surface to a new SDL_Surface, that is loadable by openGL
237 * @param surface the Surface to convert
238 * @param hasAlpha if the newly created Surface has an alpha channel, true is returned otherwise false.
239 * @returns a !!new!! Surface, that is loadable by openGL.
240 */
241SDL_Surface* Texture::prepareSurface(SDL_Surface* surface, bool& hasAlpha)
242{
243  assert(surface != NULL);
244  PRINTF(4)("Loading texture to OpenGL-Environment.\n");
245
246  SDL_Surface* retSurface;
247  SDL_Rect area;
248  Uint32 saved_flags;
249  Uint8  saved_alpha;
250  hasAlpha = false;
251  int pixelDepth = 24;
252
253  Uint32* mask = opaqueMask;
254
255  /* Save the alpha blending attributes */
256  saved_flags = surface->flags&(SDL_SRCALPHA | SDL_RLEACCELOK);
257  saved_alpha = surface->format->alpha;
258  if ( saved_flags & SDL_SRCALPHA )
259  {
260    SDL_SetAlpha(surface, 0, 0);
261    hasAlpha = true;
262    pixelDepth = 32;
263    mask = alphaMask;
264  }
265
266  retSurface = SDL_CreateRGBSurface(SDL_HWSURFACE,
267                                    surface->w, surface->h,
268                                    pixelDepth,
269                                    mask[0], mask[1], mask[2], mask[3] );
270  if ( retSurface == NULL )
271    return NULL;
272
273  /* Copy the surface into the GL texture this->data->getStoredImage() */
274  area.x = 0;
275  area.y = 0;
276  area.w = surface->w;
277  area.h = surface->h;
278  SDL_BlitSurface(surface, &area, retSurface, &area);
279
280  /* Restore the alpha blending attributes */
281  if ( (saved_flags & SDL_SRCALPHA) == SDL_SRCALPHA )
282  {
283    SDL_SetAlpha(surface, saved_flags | SDL_OPENGL, saved_alpha);
284    hasAlpha = true;
285  }
286
287  return (retSurface);
288}
289
290
291/**
292 * @brief Loads a Texture to the openGL-environment.
293 * @param surface the Image to load to openGL
294 * @returns The ID of the texture.
295 */
296GLuint Texture::loadTexToGL (const SDL_Surface* surface, GLenum target)
297{
298  //   if (this->data->getTexture() != 0 && glIsTexture(this->data->getTexture()))
299  //     glDeleteTextures(1, &this->data->getTexture());
300  //   this->data->getTexture() = 0;
301  assert(surface != NULL);
302
303  int      errorCode = 0;           //!< the error code for the texture loading functions
304  GLuint   texture = 0;             //!< the OpenGL texture handle
305  //int      mipmapLevel = 0;         //!< the maximum mipmap level for this texture
306  //int      mipmapWidth = 0;         //!< the width of the mipmap
307  //int      mipmapHight = 0;         //!< the height of the mipmap
308  GLenum   format = GL_RGB;
309  if (surface->format->BitsPerPixel == 32)
310  {
311    format = GL_RGBA;
312    assert(surface->format->BitsPerPixel == 32);
313  }
314  else
315  {
316    assert(surface->format->BitsPerPixel == 24);
317  }
318
319  /* Create an OpenGL texture for the this->data->getStoredImage() */
320  Texture::generateTexture(texture, target);
321
322  //   glTexImage2D(target,  0,  format,
323  //                surface->w,  surface->h,
324  //                0, format,  GL_UNSIGNED_BYTE,
325  //                surface->pixels);
326
327  ///  glTexParameteri(target, GL_TEXTURE_WRAP_S, GL_REPEAT);
328  ///  glTexParameteri(target, GL_TEXTURE_WRAP_R, GL_REPEAT);
329
330  /// TODO CHECK THIS BACK in
331  //glTexParameterf(GL_TEXTURE_ENV, GL_TEXTURE_PRIORITY, this->priority);
332
333  /* build the Texture  OpenGL V >= 1.1 */
334
335  //  printf("%s, w:%d h:%d, 0x%x\n", this->getName(), surface->w, surface->h, target);
336
337  /* control the mipmap levels */
338  glTexParameterf(GL_TEXTURE_ENV, GL_TEXTURE_MIN_LOD, 5);
339  glTexParameterf(GL_TEXTURE_ENV, GL_TEXTURE_MAX_LOD, 0);
340
341  // build the MipMaps automaticaly
342  errorCode = gluBuild2DMipmaps(target, format,
343                                surface->w,  surface->h,
344                                format,  GL_UNSIGNED_BYTE,
345                                surface->pixels
346                               );
347  if(unlikely(errorCode != 0))
348    PRINTF(1)("Error while loading texture (mipmap generation), gluBuild2DMipmaps returned %i\n", errorCode);
349
350  return texture;
351}
352
353/**
354 * @brief creates a new Texture.
355 * @param texture: the Texture is loaded here (should be 0 and will be set to the Value of the New Texture.)
356 * @param target: The GL-Target to generate the texture on.
357 *
358 * @note this is the real GL-texture-creat-wrapper, where the Texture is Created
359 */
360void Texture::generateTexture(GLuint& texture, GLenum target)
361{
362  if (texture == 0 && !glIsTexture(texture))
363  {
364    glGenTextures(1, &texture);
365  }
366  glBindTexture(target, texture);
367
368  glTexParameteri(target, GL_TEXTURE_WRAP_S, GL_REPEAT);
369  glTexParameteri(target, GL_TEXTURE_WRAP_R, GL_REPEAT);
370
371  glTexParameteri(target, GL_TEXTURE_MIN_FILTER, GL_LINEAR_MIPMAP_LINEAR);
372  glTexParameteri(target, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
373
374}
Note: See TracBrowser for help on using the repository browser.