MbufDiskInquire

Reference:

MbufAlloc1d MbufAlloc2d MbufAllocColor MbufControlNeighborhood MbufCreate2d MbufExport MbufExportSequence

Available in MIL-Lite with restrictions (see remarks)

Available in MIL

Available on Windows

Available on Linux

Partially supported on:

Matrox Iris GT

Fully supported on:

Host system

Matrox CronosPlus

Matrox GPU processing driver

Matrox GigE Vision driver

Matrox IEEE 1394 IIDC driver

Matrox Morphis

Matrox Morphis QxT

Matrox Orion HD

Matrox Radient eCL

Matrox Radient eV-CXP

Matrox Solios eA/XA

Matrox Solios ecl/xcl/ev-cl

Matrox USB3 Vision driver (requires Update 19)

Matrox Vio

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP

Available on Matrox Supersight

Function Map

Syntax

Description

Parameters

- FileName

Table:

For specifying the file name or memory stream

- InquireType

- UserVarPtr

Parameter Associations

Table:	For inquiring about general types of file settings
+ combination:	For obtaining information about the LUT associated with the image
Table:	For M_IMAGE
Table:	For M_KERNEL and M_STRUCT_ELEMENT
Table:	For M_KERNEL

Return value

Remarks

Compilation information

addconstant.cpp
cameraonrobotarmcalibration.cpp
colorbasedproductidentification.cpp
colorrelativecalibration.cpp
exampleinterface.cpp
examplemanager.cpp
examplemanagerfor3d.cpp
fdkaddconstantmain.cpp
fdkhistogrammain.cpp
fdkminmaxmain.cpp
findimageorientation.cpp
foodinspection_cereal.cpp
foodinspection_mango.cpp
foodinspectioncereal.cpp
foodinspectionmango.cpp
imagedownscalingmodes.cpp
imageupscalingmodes.cpp
kinectcamerastandalone.cpp
m3dmap.cpp
m3dmap.cs
m3dmap.vb
mappbenchmark.cpp
mappbenchmark.cs
mappbenchmark.vb
mbufcolor.cpp
mbufcolor.cs
mbufcolor.vb
mcol.cpp
mcol.cs
mcol.vb
mdiggrabsequence.cpp
mdiggrabsequence.cs
mdiggrabsequence.vb
mechanicalpartscan.cpp
mfunc.cpp
mfunc.cs
mfunc.vb
mimbinarizeadaptive.cpp
mimlocatepeak1d.cpp
mimlocatepeak1d.cs
mimlocatepeak1d.vb
mocr.cpp
mocr.cs
mocr.vb
mpmenubutton.cpp
mprotateprocessing.cpp
mpwarpprocessing.cpp
objectlocalization3d.cpp
pcbmodelmatching.cpp
productidentificationoasis.cpp
semiocr.cpp
standaloneexample.cpp
stereocalibration.cpp
superresolution.cpp
variousdenoising.cpp
viofeaturesdemo.cpp
vioplayback.cpp

MbufCreateColor

MbufExport

Synopsis

Inquire about the data in a file.

Syntax

MIL_INT MbufDiskInquire(

MIL_CONST_TEXT_PTR FileName,	//in
MIL_INT64 InquireType,	//in
void *UserVarPtr	//out

)

Description

This function inquires about the data in the specified file on disk.

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

FileName

Specifies the file that contains the data.

For specifying the file name or memory stream
Value	Description
MIL_TEXT("FileName") ¹	Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"). Note, an error occurs if the file does not have a known file format or the file format is not supported. The supported file types include all the formats supported by the MbufExport() and MbufExportSequence() functions. Since a raw data file does not have any information regarding size or type, you can only use MbufDiskInquire() to determine the file format of this type of file. This function cannot access a file on the remote computer; the file must be located on the master computer. (summarize) Specifies the drive, directory, and name of the file (for example, "C:\mydirectory\myfile"). (more details...)

¹ If you are passing the value in a variable, don't enclose it in MIL_TEXT().

InquireType

Specifies the type of file setting about which to inquire.

See the Parameter associations section for possible values that can be specified.

UserVarPtr

Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):

MIL_DOUBLE
MIL_INT

Specifies the address in which to write the requested information.

Since the MbufDiskInquire() function also returns the requested information, you can set this parameter to M_NULL.

See the Parameter associations section for possible values that can be returned.

Parameter associations

The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For inquiring about general types of file settings
For M_IMAGE
For M_KERNEL and M_STRUCT_ELEMENT
For M_KERNEL

The following inquire types allow you to inquire about general types of file settings.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

For inquiring about general types of file settings
InquireType		Description	MIL system-specific tooltip (†)
	UserVarPtr - Possible values returned	Description
M_ATTRIBUTE		Inquires the file attribute. Note that AVI files return M_IMAGE as a file attribute. (summarize) Inquires the file attribute. (more details...)																					†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_ARRAY	Specifies array type data. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_IMAGE	Specifies image data. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_KERNEL	//For 1D or 2D data Specifies a custom filter for convolution functions. INFO //For 1D or 2D data Specifies a custom filter for convolution functions. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_LUT	Specifies lookup table data. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_STRUCT_ELEMENT	//For 1D or 2D data Specifies structuring element data for morphology functions. INFO //For 1D or 2D data Specifies structuring element data for morphology functions. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_BYTE_ORDER		Inquires the file's byte order. (summarize) Inquires the file's byte order. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_BIG_ENDIAN	Specifies that the file is in big endian format.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_LITTLE_ENDIAN	Specifies that the file is in little endian format.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_FILE_FORMAT		Inquires the file format. SET SET (summarize) Inquires the file format. SET SET (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_AVI_CODEC	Specifies an AVI format used with a codec found on your computer.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_AVI_DIB	Specifies an AVI format used to hold non-compressed DIB images . INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_AVI_MIL	Specifies an AVI format used to hold images in their MIL format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_AVI_MJPG	Specifies an AVI format used to hold JPEG compressed sequences. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_BMP	Specifies that the data is saved in a BMP file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG2000_LOSSLESS	Specifies that the data is saved in a JPEG2000 lossless file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG2000_LOSSLESS_JP2	Specifies that the data is saved in a JPEG2000 lossless file format using the standard JP2 format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG2000_LOSSY	Specifies that the data is saved in a JPEG2000 lossy file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG2000_LOSSY_JP2	Specifies that the data is saved in a JP2000 lossy file format using the standard JP2 file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG_LOSSLESS	Specifies that the data is saved in a JPEG lossless file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG_LOSSLESS_INTERLACED	Specifies that the data is saved in an interlaced JPEG lossless file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG_LOSSY	Specifies that the data is saved in a JPEG lossy file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG_LOSSY_INTERLACED	Specifies that the data is saved in an interlaced JPEG lossy file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_JPEG_LOSSY_RGB	Specifies that the data is saved in a JPEG lossy file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_MIL	Specifies that the data is saved in a MIL file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_PNG	Specifies that the data is saved in a PNG file format.	†	a	b	c	d	e		g	h	i	j	k	l	m	n	o	p	q	r	s
	M_RAW	Specifies that the data is saved as raw data. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_TIFF	Specifies that the data is saved in a TIFF file format. INFO	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_RESOLUTION_X		Inquires the X resolution of the file in pixels per inch (PPI). If the file has no resolution information, 0 is returned. (summarize) Inquires the X resolution of the file in pixels per inch (PPI). (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	Value	Specifies the X resolution in PPI.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_RESOLUTION_Y		Inquires the Y resolution of the file in pixels per inch (PPI). If the file has no resolution information, 0 is returned. (summarize) Inquires the Y resolution of the file in pixels per inch (PPI). (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	Value	Specifies the Y resolution in PPI.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_SIGN		Inquires whether the file's data is signed or unsigned. (summarize) Inquires whether the file's data is signed or unsigned. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_SIGNED	Specifies that the data is signed.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	M_UNSIGNED	Specifies that the data is unsigned.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_SIZE_BAND +		Inquires the number of color bands in the file. (summarize) Inquires the number of color bands in the file. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	Value	Specifies the number of color bands.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_SIZE_BIT		Inquires the file data depth. (summarize) Inquires the file data depth. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	Value	Specifies the data depth, in bits.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_SIZE_X +		Inquires the width of the data in the file. (summarize) Inquires the width of the data in the file. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	Value	Specifies the width of the data, in pixels.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_SIZE_Y		Inquires the height of the data in the file. (summarize) Inquires the height of the data in the file. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	Value	Specifies the height of the data, in pixels.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
M_TYPE		Inquires the file data type and depth. The depth is returned in bits. (summarize) Inquires the file data type and depth. (more details...)	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	depth value + M_FLOAT	Specifies the data depth and that the data type is floating-point.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	depth value + M_SIGNED	Specifies the data depth and that the data type is signed.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s
	depth value + M_UNSIGNED	Specifies the data depth and that the data type is unsigned.	†	a	b	c	d	e	f	g	h	i	j	k	l	m	n	o	p	q	r	s

Combination constant for M_SIZE_BAND; M_SIZE_X.

You can add the following value to the above-mentioned values to get the width or the number of bands of the LUT associated with the image.

This option is available only if image data was saved to the file. This option is not available for AVI files.

For obtaining information about the LUT associated with the image
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_LUT		Inquires either the width or the number of bands of the LUT associated with the image in the file. (summarize) Inquires either the width or the number of bands of the LUT associated with the image in the file. (more details...)
	M_INVALID	Specifies that there is no LUT associated with the image.
	Value	Specifies either the width of the LUT associated with the image in the file (for M_SIZE_X) or the number of bands of the LUT associated with the image in the file (for M_SIZE_BAND).

You can inquire the following values for M_IMAGE files (images or AVI sequences).

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

For M_IMAGE
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_ASPECT_RATIO		Inquires the aspect ratio of the images in the file. (summarize) Inquires the aspect ratio of the images in the file. (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	Value	Specifies the aspect ratio.
M_CALIBRATION_PRESENT		Inquires whether the calibration information associated with the buffer was saved, using MbufExport() with M_WITH_CALIBRATION. (summarize) Inquires whether the calibration information associated with the buffer was saved, using MbufExport() with M_WITH_CALIBRATION. (more details...)
	M_FALSE	Specifies that the calibration was not saved.
	M_TRUE	Specifies that the calibration was saved.
M_COMPRESSION_TYPE		[For essential MIL-Lite information, see remarks ] Inquires the compression type of the images in the file. (summarize) [For essential MIL-Lite information, see remarks ] Inquires the compression type of the images in the file. (more details...)
	M_NULL	Specifies that the images are not compressed.
	M_JPEG2000_LOSSLESS	Specifies that the file holds JPEG2000 lossless data. INFO
	M_JPEG2000_LOSSY	Specifies that the file holds JPEG2000 lossy data. INFO
	M_JPEG_LOSSLESS	Specifies that the file holds JPEG lossless data. INFO
	M_JPEG_LOSSLESS_INTERLACED	Specifies that the file holds JPEG lossless data in separate fields. INFO
	M_JPEG_LOSSY	Specifies that the file holds JPEG lossy data. INFO
	M_JPEG_LOSSY_INTERLACED	Specifies that the file holds JPEG lossy data in separate fields. INFO
M_FRAME_RATE		Inquires the frame rate of an AVI file. This value is only valid for sequences. (summarize) Inquires the frame rate of an AVI file. (more details...)
	UserVarPtr data type info	Data type: MIL_DOUBLE
	Value	Specifies the frame rate, in number of images/second.
M_LUT_PRESENT		Inquires the presence of LUT data in the file. (summarize) Inquires the presence of LUT data in the file. (more details...)
	M_NO	Specifies that LUT data is not available.
	M_YES	Specifies that LUT data is available.
M_NUMBER_OF_IMAGES		Inquires the number of images in an AVI file. This value is only valid for sequences. SET (summarize) Inquires the number of images in an AVI file. SET (more details...)
	Value	Specifies the number of images.

You can inquire the following values for M_KERNEL and M_STRUCT_ELEMENT files.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

For M_KERNEL and M_STRUCT_ELEMENT
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_OFFSET_CENTER_X		Inquires the X-coordinate of the center of the kernel or structuring element. (summarize) Inquires the X-coordinate of the center of the kernel or structuring element. (more details...)
	Value	Specifies the X-coordinate.
M_OFFSET_CENTER_Y		Inquires the Y-coordinate of the center of the kernel or structuring element. (summarize) Inquires the Y-coordinate of the center of the kernel or structuring element. (more details...)
	Value	Specifies the Y-coordinate.
M_OVERSCAN		Inquires the overscan type. (summarize) Inquires the overscan type. (more details...)
	M_DEFAULT	Specifies that MIL automatically selects the type of overscan to optimize speed and logic according to the specified operation and the target system.
	M_DISABLE	Specifies that no overscan is used, unless processing the border pixels is faster than ignoring them; in the latter case, MIL automatically selects the overscan to optimize speed according to the specified operation and the target system.
	M_FAST	Specifies that MIL automatically selects the overscan to optimize speed according to the specified operation and the target system. INFO
	M_MIRROR	Specifies a type of overscan that processes the border pixels of a source image using overscan pixel values that mirror the source buffer pixel values. INFO
	M_REPLACE	Specifies a type of overscan that processes the border pixels of a source image using overscan pixel values set to the overscan replacement value (M_OVERSCAN_REPLACE_VALUE).
	M_TRANSPARENT	Specifies a type of overscan that processes the border pixels of a source image using transparent overscan pixel values. INFO
M_OVERSCAN_REPLACE_VALUE		Inquires the replacement value for the overscan pixel values. (summarize) Inquires the replacement value for the overscan pixel values. (more details...)
	M_REPLACE_MAX	Specifies that the overscan neighborhood pixel values will be set to the maximum value of the source buffer.
	M_REPLACE_MIN	Specifies that the overscan neighborhood pixel values will be set to the minimum value of the source buffer.
	Value	Specifies the value of the overscan neighborhood pixels.

You can inquire the following values for M_KERNEL files.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

For M_KERNEL
InquireType		Description
	UserVarPtr - Possible values returned	Description
M_ABSOLUTE_VALUE		Inquires the absolute value setting. (summarize) Inquires the absolute value setting. (more details...)
	M_DISABLE	Specifies not to take the absolute value of the result.
	M_ENABLE	Specifies to take the absolute value of the result. INFO
M_FILTER_MODE		Inquires the mode in which the neighborhood operations are performed. (summarize) Inquires the mode in which the neighborhood operations are performed. (more details...)
	M_KERNEL	Specifies the use of a non-recursive implementation of the filter. INFO
	M_RECURSIVE	Specifies the use of a recursive implementation of an Infinite Impulse Response (IIR) filter, when applicable. INFO
M_FILTER_OPERATION		Inquires the type of neighborhood operation performed using the selected filter. If M_FILTER_TYPE is set to M_USER_DEFINED, then M_FILTER_OPERATION is not supported. (summarize) Inquires the type of neighborhood operation performed using the selected filter. (more details...)
	M_EDGE_DETECT	Specifies to compute the gradient of the image using the Shen-Castan or Canny-Deriche filter.
	M_EDGE_DETECT_SQR	Specifies to compute the square of the gradient of the image using the Shen-Castan or Canny-Deriche filter.
	M_FIRST_DERIVATIVE_X	Specifies to compute the first derivative of the image with respect to X using the Shen-Castan or Canny-Deriche filter.
	M_FIRST_DERIVATIVE_Y	Specifies to compute the first derivative of the image with respect to Y using the Shen-Castan or Canny-Deriche filter.
	M_HORIZ_EDGE	Specifies to compute the absolute value of the horizontal derivative of the image using the Shen-Castan or Canny-Deriche filter.
	M_LAPLACIAN_EDGE	Specifies to compute the Laplacian values of the image using the Shen-Castan or Canny-Deriche filter.
	M_SECOND_DERIVATIVE_X	Specifies to compute the second derivative of the image with respect to X using the Shen-Castan or Canny-Deriche filter.
	M_SECOND_DERIVATIVE_XY	Specifies to compute the second derivative of the image with respect to X and Y using the Shen-Castan or Canny-Deriche filter.
	M_SECOND_DERIVATIVE_Y	Specifies to compute the second derivative of the image with respect to Y using the Shen-Castan or Canny-Deriche filter.
	M_SHARPEN	Specifies to compute a sharpening operation on the image using the Shen-Castan or Canny-Deriche filter.
	M_SMOOTH	Specifies to compute a smoothing operation on the image using the Shen-Castan or Canny-Deriche filter.
	M_VERT_EDGE	Specifies to compute the absolute value of the vertical derivative of the image using the Shen-Castan or Canny-Deriche filter.
M_FILTER_SMOOTHNESS		Inquires the degree of smoothness (strength of the denoising) applied by the filter during the neighborhood operation. If M_FILTER_TYPE is M_USER_DEFINED, then M_FILTER_SMOOTHNESS is not supported. (summarize) Inquires the degree of smoothness (strength of the denoising) applied by the filter during the neighborhood operation. (more details...)
	0 <= Value <= 100	Specifies the smoothness value. INFO
M_FILTER_TYPE		Inquires the type of filter used to perform the neighborhood operation. (summarize) Inquires the type of filter used to perform the neighborhood operation. (more details...)
	M_DERICHE	Specifies a Canny-Deriche Infinite Support filter. INFO
	M_SHEN	Specifies a Shen-Castan Infinite Support Exponential filter. INFO
	M_USER_DEFINED	Specifies a user-defined filter.
M_NORMALIZATION_FACTOR		Inquires the normalization factor. (summarize) Inquires the normalization factor. (more details...)
	Value > 0	Specifies the normalization factor. INFO
M_SATURATION		Inquires the saturation flag. (summarize) Inquires the saturation flag. (more details...)
	M_DISABLE	Specifies not to saturate results, except when MIL can take advantage of optimization routines to accelerate the processing. INFO
	M_ENABLE	Specifies to saturate results. INFO

Return value

The returned value is the requested information about the buffer data in the specified file, cast to a MIL_INT. If the requested information is not available, M_INVALID is returned. If an AVI file is specified but its codec is not known, M_AVI_CODEC_UNSUPPORTED is returned.

Remarks

[MIL-Lite]

Note that MIL-Lite does not support the inquiries available for M_KERNEL and M_STRUCT_ELEMENT data buffers.
[MIL-Lite]

Note that during development and at runtime, compression support requires the presence of a MIL license that grants access to the compression/decompression package. This access is only granted by default with the development license dongle for the full version of MIL. In other cases, you must purchase access to this package separately.

Compilation information

Header	Include mil.h.
Library	Use mil.lib.
DLL	Requires mil.dll.