DevIL Manual (1265192), страница 5
Текст из файла (страница 5)
Otherwise,iluBuildMipmaps generates mipmaps for the image.The mipmaps built are always powers of 2. If the original image does not have power-of2 dimensions, iluBuildMipmaps resizes the original image via iluScale to have powerof-2 dimensions.Mipmap AccessAccess mipmaps through the iluActiveMipmap function:ILboolean ilActiveMipmap(ILuint MipNum);Listing 4-1. Syntax of the mipmap access functioniluActiveMipmap sets the current image to the MipNum mipmap level of the currentimage.
If there are no mipmaps present, then iluActiveMipmap returns IL_FALSE, elseit returns IL_TRUE. The base image is mipmap level 0, so specify 0 for MipNum toreturn to the base image. The only other method for setting the current image to the baseimage is to call ilBindImage again.AnimationsAnimations are similar to mipmaps, but instead of being smaller successive images, theimages are the same size but have different data. The successive animation chains inDevIL can be used to create animations in your programs. File formats that nativelysupport animations are .gif and .mng.
You can also create your own sub- images asanimations.Developer’s Image Library Manual 25Animation Chain CreationAnimation Chain AccessAccess animations through the iluActiveImage function:ILboolean ilActiveImage(ILuint ImageNum);Listing 4-2. Syntax of the mipmap access functioniluActiveImage sets the current image to the ImageNum mipmap level of the currentimage. If there are no mipmaps present, then iluActiveImage returns IL_FALSE, else itreturns IL_TRUE.
The base image is mipmap level 0, so specify 0 for ImageNum toreturn to the base image. The only other method for setting the current image to the baseimage is to call ilBindImage again.iluActiveImage is functionally equivalent to iluActiveMipmap, except that it deals withanimatio ns and not mipmaps.LayersDevIL does not have a full layer implementation yet.Sub-Image MixingAn image can have both mipmaps and animations at the same time. Every image in ananimation chain can have its own set of mipmaps, though it is not necessary by anymeans.
If you “activate” an animation image in the base image’s animation chain, theactive image becomes the new “base” image. Therefore, if you call iluActiveMipmap,the new active image will become the new active image,26 Developer’s Image Library ManualAppendix A: Common DevIL Error CodesErrors sometimes occur within DevIL.
To get the error code of the last error thatoccurred, call ilGetError with no parameters. To get a human-readable string of an errorcode, call iluErrorString with the error code. A table of error codes follows:Error Code #defineIL_NO_ERRORIL_INVALID_ENUMIL_OUT_OF_MEMORYIL_FORMAT_NOT_SUPPORTEDIL_INTERNAL_ERRORIL_INVALID_VALUEIL_ILLEGAL_OPERATIONIL_ILLEGAL_FILE_VALUEIL_INVALID_FILE_HEADERIL_INVALID_PARAMIL_COULD_NOT_OPEN_FILEIL_INVALID_EXTENSIONIL_FILE_ALREADY_EXISTSIL_OUT_FORMAT_SAMEIL_STACK_OVERFLOWIL_STACK_UNDERFLOWIL_INVALID_CONVERSIONIL_LIB_GIF_ERRORIL_LIB_JPEG_ERRORIL_LIB_PNG_ERRORIL_LIB_TIFF_ERRORIL_LIB_MNG_ERRORIL_UNKNOWN_ERRORHexadecimal ValueDecimal Value0x0000x5010x5020x5030x5040x5050x5060x5070x5080x5090x50A0x50B0x50C0x50D0x50E0x50F0x5100x5E10x5E20x5E30x5E40x5E50x5FF01281128212831284128512861287128812891290129112921293129412951296150515061507150815091535Table A-1.
DevIL error codesDeveloper’s Image Library Manual 27Appendix B: Supported File FormatsDevIL supports loading and saving of a large number of image formats. Table B-1 liststhe formats DevIL supports.Formats Supported by DevILLoadingTypeSavingExtension(s)TypeExtension(s)Windows Bitmap.bmpWindows Bitmap.bmpDr. Halo Cut FileDirectDraw SurfaceGraphicsInterchange FormatIcons.cut.ddsC-style headerDirectDraw Surface.h.dds.gifJpeg.jpg, .jpe, .jpeg.ico, .curPalette.palJpeg.jpg, .jpe, .jpeg.pcxInterlaced Bitmap.lbmHomeworld File.lifZSoft PCXPortable NetworkGraphicsPnmDoom Walls / FlatsHalf- Life Model.lmp.mdlRaw DataSilicon Graphics.raw.sgi, .bw, .rgb, .rgbaMng Animation.mngTarga.tgaPhotoCDZSoft PCX.pcd.pcxTIF.tif, .tiffPICPortable NetworkGraphics.pic.pbm, .pgm, .ppm.pngPhotoShopSilicon Graphics.pbm, .pgm, .ppm,.pnm.psd.sgi, .bw, .rgb, .rgbaTarga.tgaTIFQuake2 Texture.tif, .tiff.walRaw DataAnyPnm.pngTable B-1.
Types of image file formats DevIL supports28 Developer’s Image Library ManualilLoad, ilLoadF and ilLoadL all accept a Type parameter. Possible values for the Typeparameter for each function are listed below. If you use an unsupported value for Type,then the function generates an IL_INVALID_ENUM error and returns IL_FALSE.Supported Loading TypesIL_BMPIL_CUTHexValue0x4200x421DecimalValue10561057Supportedby ilLoadvvSupportedby ilLoadFvvSupportedby ilLoadLvvIL_DCX0x4381080vvvIL_DDSIL_DOOM0x4370x42210791058vvvvvvIL_DOOM_FLAT0x4231059vvvIL_GIFIL_ICO0x4360x42410781060vvvvIL_JNG0x4351077vvvIL_JPG (IJL)IL_JPG (libjpeg)0x4250x42510611061vvvvvIL_LBM0x4261062vvvIL_LIFIL_MDL0x4340x43110761073vvvvvvIL_MNG0x4351077vvvIL_OILIL_PCD0x4330x42710751063vvvvvvIL_PCX0x4281064vvvIL_PICIL_PNG0x4290x42A10651066vvvvvvIL_PNM0x42B1067vvvIL_PSDIL_RAW0x4390x43010811072vvvvvvIL_SGI0x42C1068vvvIL_TGAIL_TIF0x42D0x42E10691070vvvvvvIL_WAL0x4321074vvvDevIL #defineTable B-2.
Values for the Type parameterDeveloper’s Image Library Manual 29ilSave, ilSaveF and ilSaveL all accept a Type parameter. Possible values for the Typeparameter for each function are listed below. If you use an unsupported value for Type,then the function generates an IL_INVALID_ENUM error and returns IL_FALSE.Supported Saving TypesIL_BMPIL_CHEADHexValue0x4200x42FDecimalValue10561071Supportedby ilSavevvSupportedby ilSaveFvvSupportedby ilSaveLvvIL_DDS0x4371079vvvIL_JPG (IJL)IL_JPG (libjpeg)0x4250x42510611061vvIL_OIL0x4331075vvvIL_PCXIL_PNG0x4280x42A10641066vvvvIL_PNM0x42B1067vvvIL_RAWIL_SGI0x4300x42C10721068vvvvvvIL_TGA0x42D1069vvvIL_TIF0x42E1070vDevIL #defineTable B-3.
Values for the Type parameter30 Developer’s Image Library ManualIndex.
![](https://s.studizba.com/z.php?f=/templates/si/i/noavatar.png&w=100&h=100&t=1"){kind=avatar}
