QPix Command Reference Graphics Importers |

### QPx_FreeImporter

QPx_FreeImporter(importerRef):error
| importerRef | Longint | Reference to the importer instance to be destroyed
| error | Longint | Error result

Destroys an existing importer instance and releases all memory allocated to it.

The importer instance to be destroyed is passed in importerRef.

As a rule, you should use this command after you have finished working with a graphics importer instance that was created with one of the importer creation commands (QPx_NewImporterForFile, QPx_NewImporterForData, QPx_NewImporter).

Attention: The only exception is when the importer instance was assigned to a QPix plug-in area with the QPx_SetAreaImporter command. In this case the importer instance is "owned" by the plug-in area and it will be freed when the area is destroyed by 4D or when another command changes the area content.

Example

``Free the importer` `` `C_LONGINT($error)` `` `C_LONGINT(gQPixImporter)` `` `$error:=QPx_FreeImporter (gQPixImporter)` `` `If ($error#qpx_noErr)` ``Handle the error` `End if`

Related commands

QPx_NewImporter | Creates a graphics importer instance
QPx_NewImporterForFile | Creates a graphics importer instance for the image stored in a file
QPx_NewImporterForData | Creates a graphics importer instance for the image data stored in a BLOB
QPx_SetAreaImporter | Assigns a graphics importer instance to a QPix plug-in area

QPix © Escape Information Services
Generated by QDoc 2.6 on Thu, 2 May 2002 00:50:02 +0300