MgraText
- See also
Availability
Function map
- Examples
MgraRectFill
- MgraVectors
in the MIL Reference for the minimum update required.
advancedmeasurement.cpp
alphablending.cpp
binarybasedcircledetection.cpp
blobtransform.cpp
bottlecapinspection.cpp
calgenchessgrid.cpp
calibratedruler.cpp
calibrationfromlist.cpp
cameraevents.cpp
caninspection.cpp
caporientation.cpp
capscrewinspection_capandcontent.cpp
capscrewinspection_capandlabel.cpp
charactercreator.cpp
chunkmode.cpp
cielabconversion.cpp
classcnncompletetrain.cpp
classprintedchar.cpp
classseafoodinspect.cpp
classsurfacesteel.cpp
classtreeensembletrain.cpp
codedetect.cpp
codetrain.cpp
colormatchtask.cpp
colorrelativecalibration.cpp
cookiedetection.cpp
defectdetectionexample.cpp
defectdetectiontask.cpp
depthmapgoldentemplate.cpp
dmilmdigprocesssharedmemory.cpp
dmilmultisystem.cpp
dmilobjecttrackingslave.cpp
dotspacing.cpp
examplemanager.cpp
examplemanagerfor3d.cpp
findimageorientation.cpp
fixturedcoderead.cpp
fixturingusingblob.cpp
flatfieldcorrection.cpp
foodinspectioncereal.cpp
foodinspectionmango.cpp
histogramdisplay.cpp
histogramequalizeadaptive.cpp
horizontalalignment.cpp
horizontalandanglealignment.cpp
imagedownscalingmodes.cpp
imageflattening.cpp
imageupscalingmodes.cpp
labelalignmentinspection.cpp
laserprofilemetrologyanalysis.cpp
lididentification.cpp
m3dmap.cpp
m3dmap.cs
m3dmap.vb
mappstart.cpp
mappstart.cs
mappstart.vb
mbufcolor.cpp
mbufcolor.cs
mbufcolor.vb
mcal.cpp
mcal.cs
mcal.vb
mclass.cpp
mclass.cs
mclass.vb
mcode.cpp
mcode.cs
mcode.vb
mcol.cpp
mcol.cs
mcol.vb
mdigdoublebuffering.cpp
mdigdoublebuffering.cs
mdigdoublebuffering.vb
mdiggrabsequence.cpp
mdiggrabsequence.cs
mdiggrabsequence.vb
mdigprocess.cpp
mdigprocess.cs
mdigprocess.vb
mdigprocess16vd.cpp
mdigprocessmultiple.cpp
mdispgtkview.cpp
mdispmfcview.cpp
mdispoverlay.cpp
mdispoverlay.cs
mdispoverlay.vb
mdispqtview.cpp
mdispweb.cpp
mdispwindowgtk.cpp
mdispwindowleveling.cpp
mdispwindowleveling.cs
mdispwindowleveling.vb
mdispwindowqt.cpp
mdmr.cpp
mdmr.cs
mdmr.vb
measurementalignment.cpp
mechanicalpartscan.cpp
medgecustomderivatives.cpp
metrologyalignment.cpp
mgrainteractive.cpp
mgrainteractive.cs
mgrainteractive.vb
mgratext.cpp
mgratext.cs
mgratext.vb
milapplication.cs
milapplication.vb
milgige.cpp
mimaugment.cpp
mimbinarizeadaptive.cpp
mimiirfilter.cpp
mmeas.cpp
mmeas.cs
mmeas.vb
mmoddefinemodelatangle.cpp
mocr.cpp
mocr.cs
mocr.vb
morphischannelswitchingdlg.cpp
mpatdefinemodelatangle.cpp
mpatfindmultiplemodels.cpp
mpmenu.cpp
mpmenubutton.cpp
mseqprocess.cpp
mseqprocess.cs
mseqprocess.vb
mthread.cpp
mthread.cs
mthread.vb
multicastmaster.cpp
multicastmonitor.cpp
multicastslave.cpp
multipledatamatrixcoderead.cpp
multiviewannotations.cpp
pcbmodelmatching.cpp
pharmacodereader.cpp
polarizationimaging.cpp
positioninspection.cpp
productcountinspection.cpp
productidentificationoasis.cpp
projection.cpp
publishingapplication.cpp
publishingapplication.cs
readdatamatrixtask.cpp
readstringtask.cpp
regionmanager.cpp
registeredgoldentemplate.cpp
segmentationandanalysisofcells.cpp
semiocr.cpp
specularreflectionreduction.cpp
stereocalibration.cpp
stereorectification.cpp
superresolution.cpp
superresolutioncode.cpp
systemdetection.cpp
systemdetection.cs
systemdetection.vb
texturestatistics.cpp
threadinspection.cpp
tirestringread.cpp
triggeroverethernet.cpp
utilmatchcolormap.cpp
variouscodereadings.cpp
variousdenoising.cpp
verticalalignment.cpp
visualizefont.cpp
| MIL_ID ContextGraId, | //in |
| MIL_ID DstImageBufOrListGraId, | //in |
| MIL_DOUBLE XStart, | //in |
| MIL_DOUBLE YStart, | //in |
| MIL_CONST_TEXT_PTR StringPtr | //in |
DescriptionThis function draws text destructively (raster-based) in the specified image. Alternatively, this function can add a vector-based version of the text to the specified 2D graphics list.
Note that while the location of text can sometimes change (for example, by applying a camera calibration or zooming the display), the text's font will always remain the same, and the text itself will never be magnified or distorted.
Text is defined by a string (StringPtr) and a starting position (XStart, YStart). Text inherits all the relevant settings of the specified 2D graphics context, such as the foreground color (see MgraAlloc() for default context settings). If part of the text falls outside of the specified area (image or display), that part is clipped off. By default, a text's background is filled; to make it transparent, use MgraControl() with M_BACKGROUND_MODE.
To modify or inquire graphic context settings, use MgraControl() or MgraInquire(). To modify or inquire 2D graphics list settings, use MgraControlList() or MgraInquireList().
A text's coordinates are interpreted with respect to the input coordinate system, specified using MgraControl() or MgraControlList() with M_INPUT_UNITS. Note that if you set your input coordinate system to M_WORLD and you pass MgraText() an uncalibrated image, the function will generate an error.
Unlike most other functions that modify a MIL object, you can call this function concurrently from multiple threads on the same MIL 2D graphics list (DstImageBufOrListGraId) without using an M_MUTEX object, as long as all the other parameters of the concurrent calls do not also share data.
ParametersSpecifies the identifier of the 2D graphics context. This parameter must be set to one of the following values:
|
For specifying the 2D graphics context |
|||||||||||||||||||||||||||||||||||||||
| Value |
Description | ||||||||||||||||||||||||||||||||||||||
| M_DEFAULT |
Specifies that the default 2D graphics context of the current MIL application is used. Note that there is a different default 2D graphics context for each thread. (summarize)Specifies that the default 2D graphics context of the current MIL application is used. (more details...) |
||||||||||||||||||||||||||||||||||||||
|
MIL 2D graphics context
identifier |
Specifies a valid 2D graphics context identifier, which you have allocated using MgraAlloc(). |
||||||||||||||||||||||||||||||||||||||
Specifies the identifier of a valid image buffer in which to draw the graphic or the identifier of a valid 2D graphics list in which to add the graphic. You must have allocated the image buffer or the 2D graphics list using MbufAlloc...() or MgraAllocList(), respectively.
This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.
Specifies the X-coordinate at which to start drawing the top-left corner of the first character in the input coordinate system.
Specifies the Y-coordinate at which to start drawing the top-left corner of the first character in the input coordinate system.
Specifies the address of the string containing the text to draw in the destination buffer.
|
For specifying the string |
|||||||||||||||||||||||||||||||||||||||
| Value |
Description | ||||||||||||||||||||||||||||||||||||||
|
MIL_TEXT("String") 1 |
Specifies the address of the null-terminated (\0) ASCII string that must be drawn in the destination buffer (DstImageBufOrListGraId). There is no restriction on the length of the string. (summarize)Specifies the address of the null-terminated (\0) ASCII string that must be drawn in the destination buffer (DstImageBufOrListGraId). (more details...) |
||||||||||||||||||||||||||||||||||||||
1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().
| Header | Include mil.h. |
| Library | Use mil.lib. |
| DLL | Requires mil.dll. |