plm_image_header.h

Go to the documentation of this file.

/* -----------------------------------------------------------------------
   See COPYRIGHT.TXT and LICENSE.TXT for copyright and license information
   ----------------------------------------------------------------------- */
#ifndef _plm_image_header_h_
#define _plm_image_header_h_
 
#include "plmbase_config.h"
#include "direction_cosines.h"
#include "itk_image.h"
#include "itk_image_region.h"
#include "itk_image_origin.h"
#include "plm_image.h"
 
class Bspline_xform;
class Plm_image_header_private;
class Volume;
class Volume_header;
 
class PLMBASE_API Plm_image_header {
public:
    Plm_image_header_private *d_ptr;
 
private:
    OriginType m_origin;
    SpacingType m_spacing;
    RegionType m_region;
    DirectionType m_direction;
 
public:
    Plm_image_header ();
    Plm_image_header (plm_long dim[3], float origin[3], float spacing[3]);
    Plm_image_header (plm_long dim[3], float origin[3], float spacing[3],
        float direction_cosines[9]);
    Plm_image_header (const RegionType& region, const OriginType& origin,
        const SpacingType& spacing, const DirectionType& direction);
    Plm_image_header (Plm_image *pli);
    Plm_image_header (const Plm_image& pli);
    Plm_image_header (const Plm_image::Pointer& pli);
    Plm_image_header (const Volume_header& vh);
    Plm_image_header (const Volume::Pointer& vol);
    Plm_image_header (const Volume& vol);
    Plm_image_header (const Volume* vol);
    Plm_image_header (Volume* vol);
    template<class T> Plm_image_header (T image);
    Plm_image_header (const Plm_image_header&);
    ~Plm_image_header ();
 
public:
    const Plm_image_header& operator= (const Plm_image_header&);
 
public:
    /* Getters and Setters */
    int dim (int d) const;
    float origin (int d) const;
    float spacing (int d) const;
    void set_dim (const plm_long dim[3]);
    void set_origin (const float origin[3]);
    void set_origin (const OriginType& origin) {
        m_origin = origin;
    }
    void set_spacing (const float spacing[3]);
    void set_direction_cosines (
        const float direction_cosines[9]);
    void set_direction_cosines (
        const Direction_cosines& dc);
    void set (const Plm_image_header& src);
    void set (
        const plm_long dim[3],
        const float origin[3],
        const float spacing[3],
        const Direction_cosines& dc);
    void set (
        const plm_long dim[3],
        const float origin[3],
        const float spacing[3],
        const float direction_cosines[9]);
    void set_from_gpuit (
        const plm_long dim[3],
        const float origin[3],
        const float spacing[3],
        const float direction_cosines[9]);
    void set_from_gpuit_bspline (Bspline_xform *bxf);
    void set_from_plm_image (const Plm_image *pli);
    void set_from_plm_image (const Plm_image& pli);
    void set_from_plm_image (const Plm_image::Pointer& pli);
    void set_from_volume_header (const Volume_header& vh);
    void set (const Volume_header& vh);
    void set (const Volume::Pointer& vol);
    void set (const Volume& vol);
    void set (const Volume* vol);
    void set (const RegionType& region, const OriginType& origin,
        const SpacingType& spacing, const DirectionType& direction);
    template<class T> void set_from_itk_image (const T& image);
    template<class T> void set_from_itk_image (const T* image);
    const OriginType& GetOrigin () const;
    const SpacingType& GetSpacing () const;
    const RegionType& GetRegion () const;
    const DirectionType& GetDirection () const;
    const SizeType& GetSize (void) const;
    void get_volume_header (Volume_header *vh) const;
    void get_origin (float origin[3]) const;
    void get_spacing (float spacing[3]) const;
    void get_dim (plm_long dim[3]) const;
    void get_direction_cosines (float direction_cosines[9]) const;
 
    /* Algorithms */
    static void clone (Plm_image_header *dest, const Plm_image_header *src);
 
    void expand_to_contain (const FloatPoint3DType& position);
 
    void set_geometry_to_contain (
        const Plm_image_header& reference_pih,
        const Plm_image_header& compare_pih);
 
    void print (void) const;
 
    static bool compare (const Plm_image_header *pli1, const Plm_image_header *pli2, 
        float threshold = 1e-5);
    static bool compare (const Plm_image_header& pli1, const Plm_image_header& pli2, 
        float threshold = 1e-5);
 
    FloatPoint3DType get_index (const FloatPoint3DType& pos) const;
    FloatPoint3DType get_position (const float index[3]) const;
    void get_image_center (float center[3]) const;
 
    plm_long get_num_voxels () const;
    void get_image_extent (float extent[3]) const;
};
 
/* -----------------------------------------------------------------------
   Global functions
   ----------------------------------------------------------------------- */
void
direction_cosines_from_itk (
    float direction_cosines[9],
    DirectionType* itk_direction
);
 
#endif