[692] | 1 | /*
|
---|
| 2 | -----------------------------------------------------------------------------
|
---|
| 3 | This source file is part of OGRE
|
---|
| 4 | (Object-oriented Graphics Rendering Engine)
|
---|
| 5 | For the latest info, see http://www.ogre3d.org/
|
---|
| 6 |
|
---|
| 7 | Copyright (c) 2000-2005 The OGRE Team
|
---|
| 8 | Also see acknowledgements in Readme.html
|
---|
| 9 |
|
---|
| 10 | This program is free software; you can redistribute it and/or modify it under
|
---|
| 11 | the terms of the GNU Lesser General Public License as published by the Free Software
|
---|
| 12 | Foundation; either version 2 of the License, or (at your option) any later
|
---|
| 13 | version.
|
---|
| 14 |
|
---|
| 15 | This program is distributed in the hope that it will be useful, but WITHOUT
|
---|
| 16 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
|
---|
| 17 | FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
|
---|
| 18 |
|
---|
| 19 | You should have received a copy of the GNU Lesser General Public License along with
|
---|
| 20 | this program; if not, write to the Free Software Foundation, Inc., 59 Temple
|
---|
| 21 | Place - Suite 330, Boston, MA 02111-1307, USA, or go to
|
---|
| 22 | http://www.gnu.org/copyleft/lesser.txt.
|
---|
| 23 | -----------------------------------------------------------------------------
|
---|
| 24 | */
|
---|
| 25 | #include "OgreStableHeaders.h"
|
---|
| 26 | #include "OgreLogManager.h"
|
---|
| 27 | #include "OgreHardwarePixelBuffer.h"
|
---|
| 28 | #include "OgreImage.h"
|
---|
| 29 | #include "OgreTexture.h"
|
---|
| 30 | #include "OgreException.h"
|
---|
| 31 | #include "OgreResourceManager.h"
|
---|
| 32 |
|
---|
| 33 | namespace Ogre {
|
---|
| 34 | //--------------------------------------------------------------------------
|
---|
| 35 | Texture::Texture(ResourceManager* creator, const String& name,
|
---|
| 36 | ResourceHandle handle, const String& group, bool isManual,
|
---|
| 37 | ManualResourceLoader* loader)
|
---|
| 38 | : Resource(creator, name, handle, group, isManual, loader),
|
---|
| 39 | // init defaults; can be overridden before load()
|
---|
| 40 | mHeight(512),
|
---|
| 41 | mWidth(512),
|
---|
| 42 | mDepth(1),
|
---|
| 43 | mNumRequestedMipmaps(0),
|
---|
| 44 | mNumMipmaps(0),
|
---|
| 45 | mMipmapsHardwareGenerated(false),
|
---|
| 46 | mGamma(1.0f),
|
---|
| 47 | mTextureType(TEX_TYPE_2D),
|
---|
| 48 | mFormat(PF_A8R8G8B8),
|
---|
| 49 | mUsage(TU_DEFAULT),
|
---|
| 50 | // mSrcBpp inited later on
|
---|
| 51 | mSrcWidth(0),
|
---|
| 52 | mSrcHeight(0),
|
---|
| 53 | mSrcDepth(0), mInternalResourcesCreated(false),
|
---|
| 54 | // mFinalBpp inited later on by enable32bit
|
---|
| 55 | mHasAlpha(false)
|
---|
| 56 | {
|
---|
| 57 |
|
---|
| 58 | enable32Bit(false);
|
---|
| 59 |
|
---|
| 60 | if (createParamDictionary("Texture"))
|
---|
| 61 | {
|
---|
| 62 | // Define the parameters that have to be present to load
|
---|
| 63 | // from a generic source; actually there are none, since when
|
---|
| 64 | // predeclaring, you use a texture file which includes all the
|
---|
| 65 | // information required.
|
---|
| 66 | }
|
---|
| 67 |
|
---|
| 68 |
|
---|
| 69 | }
|
---|
| 70 | //-------------------------------------------------------------------------- //--------------------------------------------------------------------------
|
---|
| 71 | void Texture::loadRawData( DataStreamPtr& stream,
|
---|
| 72 | ushort uWidth, ushort uHeight, PixelFormat eFormat)
|
---|
| 73 | {
|
---|
| 74 | Image img;
|
---|
| 75 | img.loadRawData(stream, uWidth, uHeight, eFormat);
|
---|
| 76 | loadImage(img);
|
---|
| 77 | }
|
---|
| 78 | //--------------------------------------------------------------------------
|
---|
| 79 | void Texture::setFormat(PixelFormat pf)
|
---|
| 80 | {
|
---|
| 81 | mFormat = pf;
|
---|
| 82 | // This should probably change with new texture access methods, but
|
---|
| 83 | // no changes made for now
|
---|
| 84 | mSrcBpp = PixelUtil::getNumElemBytes(mFormat);
|
---|
| 85 | mHasAlpha = PixelUtil::getFlags(mFormat) & PFF_HASALPHA;
|
---|
| 86 | }
|
---|
| 87 | //--------------------------------------------------------------------------
|
---|
| 88 | size_t Texture::calculateSize(void) const
|
---|
| 89 | {
|
---|
| 90 | return getNumFaces() * PixelUtil::getMemorySize(mWidth, mHeight, mDepth, mFormat);
|
---|
| 91 | }
|
---|
| 92 | //--------------------------------------------------------------------------
|
---|
| 93 | size_t Texture::getNumFaces(void) const
|
---|
| 94 | {
|
---|
| 95 | return getTextureType() == TEX_TYPE_CUBE_MAP ? 6 : 1;
|
---|
| 96 | }
|
---|
| 97 | //--------------------------------------------------------------------------
|
---|
| 98 | void Texture::_loadImages( const std::vector<const Image*>& images )
|
---|
| 99 | {
|
---|
| 100 | if(images.size() < 1)
|
---|
| 101 | OGRE_EXCEPT(Exception::ERR_INVALIDPARAMS, "Cannot load empty vector of images",
|
---|
| 102 | "Texture::loadImages");
|
---|
| 103 |
|
---|
| 104 | if( mIsLoaded )
|
---|
| 105 | {
|
---|
| 106 | LogManager::getSingleton().logMessage(
|
---|
| 107 | LML_NORMAL, "Texture: "+mName+": Unloading Image");
|
---|
| 108 | unload();
|
---|
| 109 | }
|
---|
| 110 |
|
---|
| 111 | // Set desired texture size and properties from images[0]
|
---|
| 112 | mSrcWidth = mWidth = images[0]->getWidth();
|
---|
| 113 | mSrcHeight = mHeight = images[0]->getHeight();
|
---|
| 114 | mSrcDepth = mDepth = images[0]->getDepth();
|
---|
| 115 | if (mHasAlpha && images[0]->getFormat() == PF_L8)
|
---|
| 116 | {
|
---|
| 117 | mFormat = PF_A8;
|
---|
| 118 | mSrcBpp = 8;
|
---|
| 119 | }
|
---|
| 120 | else
|
---|
| 121 | {
|
---|
| 122 | mFormat = images[0]->getFormat();
|
---|
| 123 | mSrcBpp = PixelUtil::getNumElemBits(mFormat);
|
---|
| 124 | mHasAlpha = PixelUtil::hasAlpha(mFormat);
|
---|
| 125 | }
|
---|
| 126 |
|
---|
| 127 | if (mFinalBpp == 16)
|
---|
| 128 | {
|
---|
| 129 | // Drop down texture internal format
|
---|
| 130 | switch (mFormat)
|
---|
| 131 | {
|
---|
| 132 | case PF_R8G8B8:
|
---|
| 133 | case PF_X8R8G8B8:
|
---|
| 134 | mFormat = PF_R5G6B5;
|
---|
| 135 | break;
|
---|
| 136 |
|
---|
| 137 | case PF_B8G8R8:
|
---|
| 138 | case PF_X8B8G8R8:
|
---|
| 139 | mFormat = PF_B5G6R5;
|
---|
| 140 | break;
|
---|
| 141 |
|
---|
| 142 | case PF_A8R8G8B8:
|
---|
| 143 | case PF_R8G8B8A8:
|
---|
| 144 | case PF_A8B8G8R8:
|
---|
| 145 | case PF_B8G8R8A8:
|
---|
| 146 | mFormat = PF_A4R4G4B4;
|
---|
| 147 | break;
|
---|
| 148 | }
|
---|
| 149 | }
|
---|
| 150 |
|
---|
| 151 | // The custom mipmaps in the image have priority over everything
|
---|
| 152 | size_t imageMips = images[0]->getNumMipmaps();
|
---|
| 153 |
|
---|
| 154 | if(imageMips > 0) {
|
---|
| 155 | mNumMipmaps = images[0]->getNumMipmaps();
|
---|
| 156 | // Disable flag for auto mip generation
|
---|
| 157 | mUsage &= ~TU_AUTOMIPMAP;
|
---|
| 158 | }
|
---|
| 159 |
|
---|
| 160 | // Create the texture
|
---|
| 161 | createInternalResources();
|
---|
| 162 | // Check if we're loading one image with multiple faces
|
---|
| 163 | // or a vector of images representing the faces
|
---|
| 164 | size_t faces;
|
---|
| 165 | bool multiImage; // Load from multiple images?
|
---|
| 166 | if(images.size() > 1)
|
---|
| 167 | {
|
---|
| 168 | faces = images.size();
|
---|
| 169 | multiImage = true;
|
---|
| 170 | }
|
---|
| 171 | else
|
---|
| 172 | {
|
---|
| 173 | faces = images[0]->getNumFaces();
|
---|
| 174 | multiImage = false;
|
---|
| 175 | }
|
---|
| 176 |
|
---|
| 177 | // Check wether number of faces in images exceeds number of faces
|
---|
| 178 | // in this texture. If so, clamp it.
|
---|
| 179 | if(faces > getNumFaces())
|
---|
| 180 | faces = getNumFaces();
|
---|
| 181 |
|
---|
| 182 | // Say what we're doing
|
---|
| 183 | StringUtil::StrStreamType str;
|
---|
| 184 | str << "Texture: " << mName << ": Loading " << faces << " faces"
|
---|
| 185 | << "(" << PixelUtil::getFormatName(images[0]->getFormat()) << "," <<
|
---|
| 186 | images[0]->getWidth() << "x" << images[0]->getHeight() << "x" << images[0]->getDepth() <<
|
---|
| 187 | ") with ";
|
---|
| 188 | if (!(mMipmapsHardwareGenerated && mNumMipmaps == 0))
|
---|
| 189 | str << mNumMipmaps;
|
---|
| 190 | if(mUsage & TU_AUTOMIPMAP)
|
---|
| 191 | {
|
---|
| 192 | if (mMipmapsHardwareGenerated)
|
---|
| 193 | str << " hardware";
|
---|
| 194 |
|
---|
| 195 | str << " generated mipmaps";
|
---|
| 196 | }
|
---|
| 197 | else
|
---|
| 198 | {
|
---|
| 199 | str << " custom mipmaps";
|
---|
| 200 | }
|
---|
| 201 | if(multiImage)
|
---|
| 202 | str << " from multiple Images.";
|
---|
| 203 | else
|
---|
| 204 | str << " from Image.";
|
---|
| 205 | // Scoped
|
---|
| 206 | {
|
---|
| 207 | // Print data about first destination surface
|
---|
| 208 | HardwarePixelBufferSharedPtr buf = getBuffer(0, 0);
|
---|
| 209 | str << " Internal format is " << PixelUtil::getFormatName(buf->getFormat()) <<
|
---|
| 210 | "," << buf->getWidth() << "x" << buf->getHeight() << "x" << buf->getDepth() << ".";
|
---|
| 211 | }
|
---|
| 212 | LogManager::getSingleton().logMessage(
|
---|
| 213 | LML_NORMAL, str.str());
|
---|
| 214 |
|
---|
| 215 | // Main loading loop
|
---|
| 216 | // imageMips == 0 if the image has no custom mipmaps, otherwise contains the number of custom mips
|
---|
| 217 | for(size_t mip = 0; mip<=imageMips; ++mip)
|
---|
| 218 | {
|
---|
| 219 | for(size_t i = 0; i < faces; ++i)
|
---|
| 220 | {
|
---|
| 221 | PixelBox src;
|
---|
| 222 | if(multiImage)
|
---|
| 223 | {
|
---|
| 224 | // Load from multiple images
|
---|
| 225 | src = images[i]->getPixelBox(0, mip);
|
---|
| 226 | }
|
---|
| 227 | else
|
---|
| 228 | {
|
---|
| 229 | // Load from faces of images[0]
|
---|
| 230 | src = images[0]->getPixelBox(i, mip);
|
---|
| 231 |
|
---|
| 232 | if (mHasAlpha && src.format == PF_L8)
|
---|
| 233 | src.format = PF_A8;
|
---|
| 234 | }
|
---|
| 235 |
|
---|
| 236 | if(mGamma != 1.0f) {
|
---|
| 237 | // Apply gamma correction
|
---|
| 238 | // Do not overwrite original image but do gamma correction in temporary buffer
|
---|
| 239 | MemoryDataStreamPtr buf; // for scoped deletion of conversion buffer
|
---|
| 240 | buf.bind(new MemoryDataStream(
|
---|
| 241 | PixelUtil::getMemorySize(
|
---|
| 242 | src.getWidth(), src.getHeight(), src.getDepth(), src.format)));
|
---|
| 243 |
|
---|
| 244 | PixelBox corrected = PixelBox(src.getWidth(), src.getHeight(), src.getDepth(), src.format, buf->getPtr());
|
---|
| 245 | PixelUtil::bulkPixelConversion(src, corrected);
|
---|
| 246 |
|
---|
| 247 | Image::applyGamma(static_cast<uint8*>(corrected.data), mGamma, corrected.getConsecutiveSize(),
|
---|
| 248 | PixelUtil::getNumElemBits(src.format));
|
---|
| 249 |
|
---|
| 250 | // Destination: entire texture. blitFromMemory does the scaling to
|
---|
| 251 | // a power of two for us when needed
|
---|
| 252 | getBuffer(i, mip)->blitFromMemory(corrected);
|
---|
| 253 | }
|
---|
| 254 | else
|
---|
| 255 | {
|
---|
| 256 | // Destination: entire texture. blitFromMemory does the scaling to
|
---|
| 257 | // a power of two for us when needed
|
---|
| 258 | getBuffer(i, mip)->blitFromMemory(src);
|
---|
| 259 | }
|
---|
| 260 |
|
---|
| 261 | }
|
---|
| 262 | }
|
---|
| 263 | // Update size (the final size, not including temp space)
|
---|
| 264 | mSize = getNumFaces() * PixelUtil::getMemorySize(mWidth, mHeight, mDepth, mFormat);
|
---|
| 265 |
|
---|
| 266 | mIsLoaded = true;
|
---|
| 267 | }
|
---|
| 268 | //-----------------------------------------------------------------------------
|
---|
| 269 | void Texture::createInternalResources(void)
|
---|
| 270 | {
|
---|
| 271 | if (!mInternalResourcesCreated)
|
---|
| 272 | {
|
---|
| 273 | createInternalResourcesImpl();
|
---|
| 274 | mInternalResourcesCreated = true;
|
---|
| 275 | }
|
---|
| 276 | }
|
---|
| 277 | //-----------------------------------------------------------------------------
|
---|
| 278 | void Texture::freeInternalResources(void)
|
---|
| 279 | {
|
---|
| 280 | if (mInternalResourcesCreated)
|
---|
| 281 | {
|
---|
| 282 | freeInternalResourcesImpl();
|
---|
| 283 | mInternalResourcesCreated = false;
|
---|
| 284 | }
|
---|
| 285 | }
|
---|
| 286 | //-----------------------------------------------------------------------------
|
---|
| 287 | void Texture::unloadImpl(void)
|
---|
| 288 | {
|
---|
| 289 | freeInternalResources();
|
---|
| 290 | }
|
---|
| 291 | //-----------------------------------------------------------------------------
|
---|
| 292 | void Texture::copyToTexture( TexturePtr& target )
|
---|
| 293 | {
|
---|
| 294 | if(target->getNumFaces() != getNumFaces())
|
---|
| 295 | {
|
---|
| 296 | OGRE_EXCEPT(Exception::ERR_INVALIDPARAMS,
|
---|
| 297 | "Texture types must match",
|
---|
| 298 | "Texture::copyToTexture");
|
---|
| 299 | }
|
---|
| 300 | size_t numMips = std::min(getNumMipmaps(), target->getNumMipmaps());
|
---|
| 301 | if((mUsage & TU_AUTOMIPMAP) || (target->getUsage()&TU_AUTOMIPMAP))
|
---|
| 302 | numMips = 0;
|
---|
| 303 | for(int face=0; face<getNumFaces(); face++)
|
---|
| 304 | {
|
---|
| 305 | for(int mip=0; mip<=numMips; mip++)
|
---|
| 306 | {
|
---|
| 307 | target->getBuffer(face, mip)->blit(getBuffer(face, mip));
|
---|
| 308 | }
|
---|
| 309 | }
|
---|
| 310 | }
|
---|
| 311 |
|
---|
| 312 |
|
---|
| 313 | }
|
---|