Landmarks in 3D space

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

Functions

Description

MiaLandmark holds 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.

Functions

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.

Parameters

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_name ()

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

Rename the landmark.

Parameters

self

a landmark

 

name

the new name of the landmark

 

mia_landmark_get_name ()

const gchar *
mia_landmark_get_name (const MiaLandmark *self);

Get the name of the landmark.

Parameters

self

a landmark

 

Returns

the name of the landmark as character string


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.

Parameters

self

a landmark

 

location

the new location of the landmark

 

Returns

a pointer to the location of the landmark


mia_landmark_get_location ()

MiaVector3d *
mia_landmark_get_location (const MiaLandmark *self);

Get the location of the landmark.

Parameters

self

a landmark

 

Returns

a pointer to the location of the landmark


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.

Parameters

self

a landmark

 

Returns

a iso-surface intensity value


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.

Parameters

self

a landmark

 

iso

the iso-surface intensity value

 

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.

Parameters

self

a landmark

 

camera

a camera

 

mia_landmark_get_camera ()

MiaCamera *
mia_landmark_get_camera (const MiaLandmark *self);

Get the camera defined for this landmark.

Parameters

self

a landmark

 

Returns

The camera


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.

Parameters

self

a landmark

 

picfile

The file name of an image file

 

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.

Parameters

self

a landmark

 

Returns

the picture file name, or NULL if it is not set.


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.

Parameters

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.