Defined in:Returns information about an image file.
virtual EngineResult GetImageFileInfo(const char *name, Integer2D *size, uint32 *flags = nullptr, int32 *count = nullptr) = 0;
||The file name of the image, relative to the engine executable.|
||A pointer to a location that receives the dimensions of the image. This cannot be |
||A pointer to a location that receives flags pertaining to the image. This can be |
||A pointer to a location that receives the number of images stored in the file. This can be |
GetImageFileInfofunction returns information about the image file specified by the
nameparamater. If the function succeeds, then the return value is
kEngineOkay. If an error occurred, then the result code corresponding to the error is returned. The horizontal and vertical dimensions of the image are stored in the location specified by the
sizeparameter. If the
flagsparameter is not
nullptr, then flags pertaining to the image are stored in the location it points to. The flags can be a combination (through logical OR) of the following constants.
||The imported image includes an alpha channel.|
countparameter is not
nullptr, then the number of images in the file is stored in the location it points to. (For most formats, this count is expected to be one.) The
GetImageFileInfofunction must be overridden by subclasses of the