FreeBSD Manual Pages
alloc_surface(3) Arcan Lua API alloc_surface(3) NAME alloc_surface - Create an empty, non-visible surface with a preset storage. SYNOPSIS vid alloc_surface( int:width, int:height ) alloc_surface( int:width, int:height, bool:noalpha ) alloc_surface( int:width, int:height, bool:noalpha, int:quality ) DESCRIPTION Some operations, particularly record and rendertargets need a storage buffer to work with. While fill_surface could also be used for such opera- tions, this function will result in one one less transfer and, optionally, some control over storage format and quality. If noalpha is set (true, !0) the texture format for the underlying backing store will be set to one where the alpha channel corresponds to fullbright (ignore/nobright). qual- ity can be set to one of the following: ALLOC_QUALITY_LOW , ALLOC_QUAL- ITY_NORMAL , ALLOC_QUALITY_HIGH , ALLOC_QUALITY_FLOAT 16, ALLOC_QUAL- ITY_FLOAT 32. NOTES 1 Only ALLOC_QUALITY_NORMAL is guaranteed to be a valid target for map_video_display and similar operations. 2 Note that not all storage modes will support all forms of filtering, or mipmapping. If in doubt, disable vfilter and manually sample in a shader. EXAMPLE function alloc_surface0() local vid = fill_surface(640, 480); assert(vid ~= BADID) print("allocated: ", vid, 640, 480); show_image(vid); end MISUSE function alloc_surface0() fill_surface(-1, -1); end MISUSE function alloc_surface1() fill_surface(1000000, 100000000); end SEE ALSO: image August 2026 alloc_surface(3)
NAME | SYNOPSIS | DESCRIPTION | NOTES | EXAMPLE | MISUSE | MISUSE | SEE ALSO:
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=alloc_surface&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>