showcode "IMAGEDESTROY" - FreeBASIC Wiki Manual | FBWiki

{{fbdoc item="title" value="IMAGEDESTROY"}}----
Destroys and deallocates storage for an image

{{fbdoc item="syntax"}}##
[[KeyPgDeclare|declare]] [[KeyPgSub|sub]] **""ImageDestroy""** ( [[KeyPgByval|byval]] //image// [[KeyPgAs|as]] [[KeyPgAny|any]] [[KeyPgPtr|ptr]] )
##
{{fbdoc item="usage"}}##
**""ImageDestroy""**( //image// )
##
{{fbdoc item="param"}}
##//image//##
The address of the image to destroy.

{{fbdoc item="desc"}}
Destroys the image pointed to by ##//image//##, which must be an address returned from a call to ##[[KeyPgImagecreate|ImageCreate]]##.

Calling ##**""ImageDestroy""**## on a null pointer induces no action.

{{fbdoc item="ex"}}
See ##[[KeyPgImagecreate|ImageCreate]]## for an example on using ##**""ImageDestroy""**##.

{{fbdoc item="lang"}}
- Not available in the //[[CompilerOptlang|-lang qb]]// dialect unless referenced with the alias ##**""__Imagedestroy""**##.

{{fbdoc item="diff"}}
- New to ""FreeBASIC""

{{fbdoc item="see"}}
- ##[[KeyPgImagecreate|ImageCreate]]##

{{fbdoc item="back" value="CatPgGfx2D|2D Drawing Functions"}}