Landmarks in 3D space

Landmarks in 3D space — Landmark description for gray scale volume data

Synopsis

                    MiaLandmark;
MiaCamera *         mia_landmark_get_camera             (const MiaLandmark *self);
gfloat              mia_landmark_get_iso_value          (const MiaLandmark *self);
MiaVector3d *       mia_landmark_get_location           (const MiaLandmark *self);
const gchar *       mia_landmark_get_name               (const MiaLandmark *self);
const gchar *       mia_landmark_get_picfile            (const MiaLandmark *self);
MiaLandmark *       mia_landmark_new                    (const gchar *name,
                                                         MiaVector3d *location,
                                                         float iso,
                                                         MiaCamera *camera,
                                                         gchar *picfile);
void                mia_landmark_set_camera             (MiaLandmark *self,
                                                         MiaCamera *camera);
void                mia_landmark_set_iso_value          (MiaLandmark *self,
                                                         gfloat iso);
void                mia_landmark_set_location           (MiaLandmark *self,
                                                         MiaVector3d *location);
void                mia_landmark_set_name               (MiaLandmark *self,
                                                         const gchar *name);
void                mia_landmark_set_picfile            (MiaLandmark *self,
                                                         const gchar *picfile);
gboolean            mia_landmark_xmlio_write            (xmlNodePtr parent,
                                                         xmlNsPtr ns,
                                                         const MiaLandmark *lm);

Description

MiaLandmarks olds the location of a landmark in 3D space. In addition it comprises MiaCamera that describes the best view for visualizing this landmark, and the intensity value in the grayscale data that corresponds to the landmark location and can, hence, be used to properly visualize the iso-surface is landmark can be found on.

In addition, an image file name can be provided that shows the landmark in its anatomical context in an example data set.

Details

MiaLandmark

typedef struct _MiaLandmark MiaLandmark;

This class defines a landmark in 3D space with a camera, the corrosponding view definition, the intensity value corresponding to its location in a corresponding volume data, and a picture illustrating its location in the anatomical context.

mia_landmark_get_camera ()

MiaCamera *         mia_landmark_get_camera             (const MiaLandmark *self);

Get the camera defined for this landmark.

`self` :	a landmark
Returns :	The camera

mia_landmark_get_iso_value ()

gfloat              mia_landmark_get_iso_value          (const MiaLandmark *self);

The iso value corresponds to in the intensity value that can be found at the landmark location.

`self` :	a landmark
Returns :	a iso-surface intensity value

mia_landmark_get_location ()

MiaVector3d *       mia_landmark_get_location           (const MiaLandmark *self);

Get the location of the landmark.

`self` :	a landmark
Returns :	a pointer to the location of the landmark

mia_landmark_get_name ()

const gchar *       mia_landmark_get_name               (const MiaLandmark *self);

Get the name of the landmark.

`self` :	a landmark
Returns :	the name of the landmark as character string

mia_landmark_get_picfile ()

const gchar *       mia_landmark_get_picfile            (const MiaLandmark *self);

The picture is supposed to show the landmark in its anatomical context.

`self` :	a landmark
Returns :	the picture file name, or NULL if it is not set.

mia_landmark_new ()

MiaLandmark *       mia_landmark_new                    (const gchar *name,
                                                         MiaVector3d *location,
                                                         float iso,
                                                         MiaCamera *camera,
                                                         gchar *picfile);

Create a new landmark with the given characteristics.

`name` :	Name of the newly created landmark
`location` :	3D coordinates of the landmark
`iso` :	intensity value corresponding to the 3D coordinates in the visualized volume data set
`camera` :	viewing camera when marking the landmark
`picfile` :	image file to give an idea where to find the landmark
Returns :	The newly created landmark

mia_landmark_set_camera ()

void                mia_landmark_set_camera             (MiaLandmark *self,
                                                         MiaCamera *camera);

Sets the viewing camera for the landmark. The viewing camera defines a view that has the landmark in its viewing range.

`self` :	a landmark
`camera` :	a camera

mia_landmark_set_iso_value ()

void                mia_landmark_set_iso_value          (MiaLandmark *self,
                                                         gfloat iso);

The iso value corresponds to in the intensity value that can be found at the landmark location.

`self` :	a landmark
`iso` :	the iso-surface intensity value

mia_landmark_set_location ()

void                mia_landmark_set_location           (MiaLandmark *self,
                                                         MiaVector3d *location);

Set a new location to the landmark. The old one is unreferenced.

`self` :	a landmark
`location` :	the new location of the landmark
Returns :	a pointer to the location of the landmark

mia_landmark_set_name ()

void                mia_landmark_set_name               (MiaLandmark *self,
                                                         const gchar *name);

Rename the landmark.

`self` :	a landmark
`name` :	the new name of the landmark

mia_landmark_set_picfile ()

void                mia_landmark_set_picfile            (MiaLandmark *self,
                                                         const gchar *picfile);

The picture is supposed to show the landmark in its anatomical context. The old pictutre file name is replaces and if not then a copy of the string is stored.

`self` :	a landmark
`picfile` :	The file name of an image file

mia_landmark_xmlio_write ()

gboolean            mia_landmark_xmlio_write            (xmlNodePtr parent,
                                                         xmlNsPtr ns,
                                                         const MiaLandmark *lm);

Stores the landmark as subnode of the given XML parent node.

`parent` :	XML node the landmark description will be attached to
`ns` :	the XML namespace
`lm` :	the landmark to be stored
Returns :	TRUE if the XML subtree is sucessfully created and attached to the parent node, FALSE otherwise.

			mialm Reference Manual
Top \| Description