core.image.create

local instance = core.image.create(
    path,
    mipmaps = false
)

Only needed if you already know a mipmap-based filter is coming.

Use it when — an image is going to use NEAREST_MIPMAP, LINEAR_MIPMAP, or an ANISOTROPIC filter variant.
Before compressing — if both mipmaps and compression are needed, pass true here; self:compress cannot generate mipmaps, so this is the only opportunity.

Type	Name	Description
`string`	path	File path to a supported image asset Refer Formats section
`bool`	mipmaps	Determines whether to generate a mipmap chain for the underlying image

Type	Name	Description
`image`	instance	Created image instance

Format	Extension	Description
JPEG	`.jpg` \| `.jpeg`	Lossy compressed image, best for photos
PNG	`.png`	Lossless compressed image, supports transparency
WebP	`.webp`	Modern format, supports both lossy and lossless
BMP	`.bmp`	Uncompressed bitmap, no lossy artifacts
DDS	`.dds`	GPU-native compressed format, ideal for 3D assets
KTX	`.ktx` \| `.ktx2`	Khronos texture format, supports GPU compression and mipmaps

Create an image instance from a JPEG file

local entity = core.image.create("assets/photo.jpg")

Create an image instance from a PNG file

local entity = core.image.create("assets/sprite.png")

Create an image instance from a WebP file

local entity = core.image.create("assets/image.webp")

Create an image instance from a DDS file

local entity = core.image.create("assets/terrain.dds")

Create an image with mipmaps

local entity = core.image.create("assets/terrain/cliff_diffuse.png", true)

entity:set_filter(core.image.texture_filter.LINEAR_MIPMAP_ANISOTROPIC)