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.