Revision Release 2024.3703 Keywords iOS, Solar2D Native, C, CoronaGraphics.h, CoronaExternalPushTexture See also CoronaGraphics.h Corona C Functions
Creates a new Lua TextureResourceExternal object with the given callbacks and user data, then pushes the new texture to the top of the Lua stack. This works similarly to the Lua graphics.newTexture() function except that the returned texture object wraps a bitmap loaded by the caller, and the given callbacks argument provides an interface for Corona to access this bitmap's information and pixel data.
This function will return 1 if the texture object was successfully created and pushed to the top of the Lua stack.
This function will return 0 if it failed to create the texture object and the Lua stack was unchanged. This will happen if invalid arguments are given or if the given Lua state does not belong to an actively running Corona runtime.
Note that pushed textures are subject to manual texture management and must be released when no longer needed.
int CoronaExternalPushTexture( lua_State *L, const CoronaExternalTextureCallbacks *callbacks, void* userData )
Pointer to the Lua state to push the new TextureResourceExternal object to.
Pointer to a CoronaExternalTextureCallbacks structure. This provides callbacks for Corona to invoke when requesting the plugin to provide texture information, perform an operation, and other feedback information. All callbacks will receive the userData value provided to this function. See CoronaExternalTextureCallbacks for more details.
Pointer to user data defined by the caller. This pointer will be passed as an argument to all function callbacks defined in the CoronaExternalTextureCallbacks struct.