Skip to main content

MgraFree

BoardSupported
Host SystemYes
V4L2Yes
Clarity UHDYes
Concord PoENo
GenTLYes
GevIQYes
GigE VisionYes
IndioNo
Iris GTXYes
Radient eV-CLYes
Rapixo CLYes
Rapixo CoFYes
Rapixo CXPYes
USB3 VisionYes

Free a 2D graphics context or a 2D graphics list.

Syntax

void MgraFree(
AIL_ID ObjectId //in
)

Description

This function deallocates a 2D graphics context or a 2D graphics list previously allocated with MgraAlloc or MgraAllocList.

If you free a 2D graphics list that is annotating the display non-destructively (specified using MdispControl with M_ASSOCIATED_GRAPHIC_LIST_ID), the 2D graphics list is automatically disassociated from the display.

All 2D graphics contexts or 2D graphics lists allocated on a particular system must be freed before the system can be freed, unless M_UNIQUE_ID was specified during allocation.

Parameters

ObjectId (in, AIL_ID)

Specifies the identifier of the 2D graphics context or 2D graphics list to deallocate. If M_DEFAULT is specified, an error will occur.

Copyright © 2026 Zebra Technologies.