iuf3DTransducerElement.h File Reference

#include <iuf3DAngle.h>
#include <iuf3DSize.h>
#include <iufPosition.h>

Go to the source code of this file.

Macros
#define	IU3DTE_INVALID   (iu3dte_t) NULL

Typedefs
typedef Iuf3DTransducerElement *	iu3dte_t
	A 3D transducer element describes a physical ultrasound element. In 3D space such an element is described by a 3D size at a 3D position under 2 angles theta and phi. Typically, a transducer has a list of these elements. Elements are created first with iuf3DTransducerElementCreate(), and then added to a list using iuf3DTransducerSetElement() More...

Functions
iu3dte_t	iuf3DTransducerElementCreate (iu3dp_t pos, iu3da_t ang, iu3ds_t siz)
	Creates a 3D transducer element that is decribed by a 3D position, a 3D angle (theta and phi) and a 3D size. More...
int	iuf3DTransducerElementDeepDelete (iu3dte_t element)
	Removes the 3D element object and its sub-objects (position, angle and size) More...
int	iuf3DTransducerElementDelete (iu3dte_t element)
	Removes the 3D element object without deleting its sub-objects (position, angle and size) More...
int	iuf3DTransducerElementCompare (iu3dte_t reference, iu3dte_t actual)
	Compares the values of 2 transducer elements. the order of the arguments don't matter. More...
iu3dp_t	iuf3DTransducerElementGetPosition (iu3dte_t element)
	returns the 3D position of the iuf2DTransducerElement. More...
iu3da_t	iuf3DTransducerElementGetAngle (iu3dte_t element)
	returns the angles (theta,phi) of the iuf2DTransducerElement. More...
iu3ds_t	iuf3DTransducerElementGetSize (iu3dte_t element)
	returns the 3D size of the iuf2DTransducerElement. More...

Macro Definition Documentation

IU3DTE_INVALID

#define IU3DTE_INVALID   (iu3dte_t) NULL

Typedef Documentation

iu3dte_t

typedef Iuf3DTransducerElement* iu3dte_t

A 3D transducer element describes a physical ultrasound element. In 3D space such an element is described by a 3D size at a 3D position under 2 angles theta and phi. Typically, a transducer has a list of these elements. Elements are created first with iuf3DTransducerElementCreate(), and then added to a list using iuf3DTransducerSetElement()

Function Documentation

iuf3DTransducerElementCompare()

int iuf3DTransducerElementCompare	(	iu3dte_t	reference,
		iu3dte_t	actual
	)

Compares the values of 2 transducer elements. the order of the arguments don't matter.

Returns

IUF_FALSE in case the elements are different and IUF_TRUE when the element are identical.

Parameters

reference	The transducer to compare to
actual	The transducer to compare with

iuf3DTransducerElementCreate()

iu3dte_t iuf3DTransducerElementCreate	(	iu3dp_t	pos,
		iu3da_t	ang,
		iu3ds_t	siz
	)

Creates a 3D transducer element that is decribed by a 3D position, a 3D angle (theta and phi) and a 3D size.

Returns

returns the created element or IU2DTE_INVALID in case of invalid parameters.

Parameters

pos	the 3D position (x,y,z) in meters
ang	the angle over the y-axis and x ais in radians of the element
siz	the size (sx,sy, sz) in meters of the element

iuf3DTransducerElementDeepDelete()

int iuf3DTransducerElementDeepDelete

(

iu3dte_t

element

)

Removes the 3D element object and its sub-objects (position, angle and size)

Returns

IUF_ERR_VALUE in case something went wrong or IUF_TRUE when the element has been successfully deleted.

Parameters

element

the 3D transducer object to be deleted

iuf3DTransducerElementDelete()

int iuf3DTransducerElementDelete

(

iu3dte_t

element

)

Removes the 3D element object without deleting its sub-objects (position, angle and size)

Returns

IUF_ERR_VALUE in case something went wrong or IUF_TRUE when the element has been successfully deleted.

Parameters

element

the 3D transducer object to be deleted

iuf3DTransducerElementGetAngle()

iu3da_t iuf3DTransducerElementGetAngle

(

iu3dte_t

element

)

returns the angles (theta,phi) of the iuf2DTransducerElement.

Returns

the angles of the iuf3DTransducerElement (theta, phi) in radians.

Parameters

element

The transducer element that has the requested angles.

iuf3DTransducerElementGetPosition()

iu3dp_t iuf3DTransducerElementGetPosition

(

iu3dte_t

element

)

returns the 3D position of the iuf2DTransducerElement.

Returns

the 3D position of the iuf3DTransducerElement (x,y,z) in meters.

Parameters

element

The transducer element that has the requested position.

iuf3DTransducerElementGetSize()

iu3ds_t iuf3DTransducerElementGetSize

(

iu3dte_t

element

)

returns the 3D size of the iuf2DTransducerElement.

Returns

the 3D size of the iuf3DTransducerElement (sx,sy,sz) in meters.

Parameters

element

The transducer element that has the requested size.