MgraAllocList
- See also
Availability
Function map
- Examples
MgraAlloc
- MgraArc
in the MIL Reference for the minimum update required.
3dplanarity.cpp
3dprofilemetrology.cpp
alphablending.cpp
binarybasedcircledetection.cpp
blisterpackinspection.cpp
blobmerge.cpp
bottlecapinspection.cpp
calibratedruler.cpp
calibrationfromlist.cpp
cielabconversion.cpp
circleshapefinder.cpp
classtreeensembletrain.cpp
codedetect.cpp
colorrelativecalibration.cpp
cookiedetection.cpp
defectdetectionexample.cpp
dxfmodelfinding.cpp
ellipseshapefinder.cpp
examplemanager.cpp
examplemanagerfor3d.cpp
findimageorientation.cpp
fixturedcoderead.cpp
fixturingusingblob.cpp
flatfieldcorrection.cpp
foodinspectionmango.cpp
gearinspection.cpp
gumpackinspection.cpp
histogramdisplay.cpp
inspectiontask.cpp
laserprofilemetrologyanalysis.cpp
mbead.cpp
mbead.cs
mbead.vb
mblob.cpp
mblob.cs
mblob.vb
mbufcreate.cpp
mbufcreate.cs
mcal.cpp
mcal.cs
mcal.vb
mdispgtkview.cpp
mdispmfcview.cpp
mdispqtview.cpp
meas2stepoverview.cpp
measoverviewexample.cpp
measuredfeaturesoverview.cpp
medge.cpp
medge.cs
medge.vb
medgecustomderivatives.cpp
metrologyonblobs.cpp
mgrainteractive.cpp
mgrainteractive.cs
mgrainteractive.vb
mgravectors.cpp
mgraweb.cpp
mimboundingbox.cpp
mimlocatepeak1d.cpp
mimlocatepeak1d.cs
mimlocatepeak1d.vb
mmeas.cpp
mmeas.cs
mmeas.vb
mmet.cpp
mmet.cs
mmet.vb
mmod.cpp
mmod.cs
mmod.vb
mmoddefinemodelatangle.cpp
mpat.cpp
mpat.cs
mpat.vb
mpatdefinemodelatangle.cpp
mpatfindmultiplemodels.cpp
mreg.cpp
mreg.cs
mreg.vb
multipledatamatrixcoderead.cpp
multiviewannotations.cpp
pharmacodereader.cpp
photometricstereowithmotion.cpp
pointconstructions.cpp
polarizationimaging.cpp
profiledisplay.cpp
projection.cpp
rectangleshapefinder.cpp
registeredgoldentemplate.cpp
scriptpreprocessing.cpp
segmentationandanalysisofcells.cpp
semiocr.cpp
simple3dbinpicking.cpp
stereorectification.cpp
tirestringread.cpp
tolerancesoverview.cpp
unwarpmultiviewcylinder.cpp
usdotnumberstr.cpp
variousdotmatrixreadings.cpp
variousstatistics.cpp
| MIL_ID SysId, | //in |
| MIL_INT64 ListGraType, | //in |
| MIL_ID *ListGraIdPtr | //out |
DescriptionThis function allocates a 2D graphics list, which holds graphics in vector (mathematical) form. Different 2D graphics lists can coexist; use their identifier to specify which to use or change. When a 2D graphics list is no longer required, you should release its memory, using MgraFree().
The 2D graphics list can be used to annotate the display non-destructively, using MdispControl() with M_ASSOCIATED_GRAPHIC_LIST_ID. Since graphics in a 2D graphics list are vector-based, you can zoom the display without the pixelation (loss of clarity) of the graphics. Also, if you add, modify, or delete graphics, the display can be immediately updated to reflect the changes. To set whether the display is automatically updated, use MdispControl() with M_UPDATE_GRAPHIC_LIST.
The 2D graphics list can also be used to draw destructively in an image, using MgraDraw(). Once drawn, the graphics are raster-based and are part of the image buffer; they cannot be modified. Also, if this annotated image is displayed, zooming it will cause pixelation (loss of clarity) of the graphics and changes in line thickness. Using MgraDraw() is similar to using a graphics function (for example, MgraArc()) to draw destructively in an image.
Graphics can be added to the list using any of the Mgra...() graphics functions, such as MgraArc(). To remove all graphics from the list, use MgraClear(). You can also use MgraControlList() with M_DELETE to remove graphics (one or all) from the list.
When you add graphics to the list, they inherit the current settings of the specified 2D graphics context (as described in MgraAlloc()); however, there is no link between the 2D graphics list and the 2D graphics context. Graphics already in the list are not affected by changes made to the context. To modify or inquire 2D graphics list settings, use MgraControlList() and MgraInquireList().
ParametersSpecifies the system on which to allocate the 2D graphics list.
This parameter should be set to one of the following values:
|
For specifying the system |
|||||||||||||||||||||||||||||||||||||||
| Value |
Description | ||||||||||||||||||||||||||||||||||||||
| M_DEFAULT_HOST |
Specifies the default Host system of the current MIL application. |
||||||||||||||||||||||||||||||||||||||
|
MIL system identifier |
Specifies a valid system identifier, previously allocated using MsysAlloc(). |
||||||||||||||||||||||||||||||||||||||
| Header | Include mil.h. |
| Library | Use mil.lib. |
| DLL | Requires mil.dll. |