Public Member Functions | Protected Member Functions | Friends | Related Functions
vil3d_dicom_image Class Reference

A DICOM volume on disk. More...

#include <vil3d_dicom.h>

Inheritance diagram for vil3d_dicom_image:
Inheritance graph
[legend]

List of all members.

Public Member Functions

virtual const char * file_format () const
 default filename tag for this image.
virtual unsigned nplanes () const
 Dimensions: nplanes x ni x nj x nk.
virtual unsigned ni () const
 Dimensions: nplanes x ni x nj x nk.
virtual unsigned nj () const
 Dimensions: nplanes x ni x nj x nk.
virtual unsigned nk () const
 Dimensions: nplanes x ni x nj x nk.
virtual enum vil_pixel_format pixel_format () const
 Pixel Format.
virtual vil3d_image_view_base_sptr get_copy_view (unsigned i0, unsigned ni, unsigned j0, unsigned nj, unsigned k0, unsigned nk) const
 Create a read/write view of a copy of this data.
virtual bool put_view (const vil3d_image_view_base &im, unsigned i0, unsigned j0, unsigned k0)
 Put the data in this view back into the image source.
virtual bool get_property (char const *tag, void *property_value=0) const
 Extra property information.
virtual vil3d_image_view_base_sptr get_view (unsigned i0, unsigned ni, unsigned j0, unsigned nj, unsigned k0, unsigned nk) const
 Create a read/write view of the data.
vil3d_image_view_base_sptr get_view () const
 Create a read/write view of all the data.
virtual bool set_voxel_size (float, float, float)
 Set the size of the each voxel in the i,j,k directions.
virtual bool view_fits (const vil3d_image_view_base &im, unsigned i0, unsigned j0, unsigned k0)
 Check that a view will fit into the data at the given offset.

Protected Member Functions

 vil3d_dicom_image (const vcl_vector< vil_image_resource_sptr > &slices)

Friends

class vil3d_slice_list_format

Related Functions

(Note that these are not member functions.)

bool vil3d_copy_deep (const vil3d_image_resource_sptr &src, vil3d_image_resource_sptr &dest)
 Copy src to dest.
vil3d_image_resource_sptr vil3d_crop (const vil3d_image_resource_sptr &src, unsigned i0, unsigned ni, unsigned j0, unsigned nj, unsigned k0, unsigned nk)
 Crop to a region of src.
vil3d_image_resource_sptr vil3d_new_image_resource (unsigned ni, unsigned nj, unsigned nk, unsigned nplanes, vil_pixel_format format)
 Make a new image of given format.
vil3d_image_resource_sptr vil3d_new_image_resource (const char *filename, unsigned ni, unsigned nj, unsigned nk, unsigned nplanes, vil_pixel_format format, char const *file_format=0)
 Make a new image on disk.
bool vil3d_save_image_resource (const vil3d_image_resource_sptr &ir, char const *filename, char const *file_format)
 Send vil3d_image_resource to disk.
bool vil3d_save_image_resource (const vil3d_image_resource_sptr &ir, char const *filename)
 Save vil3d_image_resource to file, deducing format from filename.

Detailed Description

A DICOM volume on disk.

You can't create one of these yourself. Use vil3d_slice_list_format instead.

Definition at line 46 of file vil3d_dicom.h.


Constructor & Destructor Documentation

vil3d_dicom_image::vil3d_dicom_image ( const vcl_vector< vil_image_resource_sptr > &  slices) [inline, protected]

Definition at line 54 of file vil3d_dicom.h.


Member Function Documentation

virtual const char* vil3d_dicom_image::file_format ( ) const [inline, virtual]

default filename tag for this image.

Reimplemented from vil3d_slice_list_image.

Definition at line 50 of file vil3d_dicom.h.

vil3d_image_view_base_sptr vil3d_slice_list_image::get_copy_view ( unsigned  i0,
unsigned  ni,
unsigned  j0,
unsigned  nj,
unsigned  k0,
unsigned  nk 
) const [virtual, inherited]

Create a read/write view of a copy of this data.

Get some or all of the volume.

This function will always return a multi-plane scalar-pixel view of the data.

Returns:
0 if unable to get view of correct size, or if resource is write-only.

Implements vil3d_image_resource.

Definition at line 229 of file vil3d_slice_list.cxx.

bool vil3d_slice_list_image::get_property ( char const *  tag,
void *  property_value = 0 
) const [virtual, inherited]

Extra property information.

Get the properties (of the first slice).

This will just return the property of the first slice in the list.

Implements vil3d_image_resource.

Definition at line 222 of file vil3d_slice_list.cxx.

virtual vil3d_image_view_base_sptr vil3d_image_resource::get_view ( unsigned  i0,
unsigned  ni,
unsigned  j0,
unsigned  nj,
unsigned  k0,
unsigned  nk 
) const [inline, virtual, inherited]

Create a read/write view of the data.

Modifying this view might modify the actual data. If you want to modify this data in place, call put_view after you done, and it should work efficiently. This function will always return a multi-plane scalar-pixel view of the data.

Returns:
0 if unable to get view of correct size, or if resource is write-only.

If you want to fill an existing view (e.g. a window onto some other image), then use

 vil3d_reformat(data->get_view(..), window);
*

Reimplemented in vil3d_crop_image_resource, and vil3d_memory_image.

Definition at line 63 of file vil3d_image_resource.h.

vil3d_image_view_base_sptr vil3d_image_resource::get_view ( ) const [inline, inherited]

Create a read/write view of all the data.

Definition at line 69 of file vil3d_image_resource.h.

unsigned vil3d_slice_list_image::ni ( void  ) const [virtual, inherited]

Dimensions: nplanes x ni x nj x nk.

The number of pixels in each row.

Implements vil3d_image_resource.

Definition at line 197 of file vil3d_slice_list.cxx.

unsigned vil3d_slice_list_image::nj ( void  ) const [virtual, inherited]

Dimensions: nplanes x ni x nj x nk.

The number of pixels in each column.

Implements vil3d_image_resource.

Definition at line 203 of file vil3d_slice_list.cxx.

unsigned vil3d_slice_list_image::nk ( void  ) const [virtual, inherited]

Dimensions: nplanes x ni x nj x nk.

The number of slices per image.

Implements vil3d_image_resource.

Definition at line 209 of file vil3d_slice_list.cxx.

unsigned vil3d_slice_list_image::nplanes ( void  ) const [virtual, inherited]

Dimensions: nplanes x ni x nj x nk.

This concept is treated as a synonym to components.

Implements vil3d_image_resource.

Definition at line 191 of file vil3d_slice_list.cxx.

enum vil_pixel_format vil3d_slice_list_image::pixel_format ( void  ) const [virtual, inherited]

Pixel Format.

Implements vil3d_image_resource.

Definition at line 215 of file vil3d_slice_list.cxx.

bool vil3d_slice_list_image::put_view ( const vil3d_image_view_base im,
unsigned  i0,
unsigned  j0,
unsigned  k0 
) [virtual, inherited]

Put the data in this view back into the image source.

Set the contents of the volume.

The view must be of scalar components. Assign your view to a scalar-component view if this is not the case.

Returns:
false if failed, because e.g. resource is read-only, format of view is not correct (if it is a compound pixel type, try assigning it to a multi-plane scalar pixel view.)

Implements vil3d_image_resource.

Definition at line 276 of file vil3d_slice_list.cxx.

virtual bool vil3d_image_resource::set_voxel_size ( float  ,
float  ,
float   
) [inline, virtual, inherited]

Set the size of the each voxel in the i,j,k directions.

You can get the voxel sizes via get_properties().

Returns:
false if underlying image doesn't store pixel sizes.

Reimplemented in vil3d_analyze_image, vil3d_meta_image, and vil3d_gipl_image.

Definition at line 76 of file vil3d_image_resource.h.

virtual bool vil3d_image_resource::view_fits ( const vil3d_image_view_base im,
unsigned  i0,
unsigned  j0,
unsigned  k0 
) [inline, virtual, inherited]

Check that a view will fit into the data at the given offset.

This includes checking that the pixel type is scalar.

Definition at line 97 of file vil3d_image_resource.h.


Friends And Related Function Documentation

bool vil3d_copy_deep ( const vil3d_image_resource_sptr src,
vil3d_image_resource_sptr dest 
) [related]

Copy src to dest.

This is useful if you want to copy on image into a window on another image. src and dest must have identical sizes, and pixel-types. Returns false if the copy failed. O(size).

Definition at line 25 of file vil3d_copy.cxx.

vil3d_image_resource_sptr vil3d_crop ( const vil3d_image_resource_sptr src,
unsigned  i0,
unsigned  ni,
unsigned  j0,
unsigned  nj,
unsigned  k0,
unsigned  nk 
) [related]

Crop to a region of src.

Definition at line 13 of file vil3d_crop.cxx.

vil3d_image_resource_sptr vil3d_new_image_resource ( unsigned  ni,
unsigned  nj,
unsigned  nk,
unsigned  nplanes,
vil_pixel_format  format 
) [related]

Make a new image of given format.

Reimplemented in vil3d_memory_image.

Definition at line 23 of file vil3d_new.cxx.

vil3d_image_resource_sptr vil3d_new_image_resource ( const char *  filename,
unsigned  ni,
unsigned  nj,
unsigned  nk,
unsigned  nplanes,
vil_pixel_format  format,
char const *  file_format = 0 
) [related]

Make a new image on disk.

Definition at line 31 of file vil3d_new.cxx.

bool vil3d_save_image_resource ( const vil3d_image_resource_sptr ir,
char const *  filename,
char const *  file_format 
) [related]

Send vil3d_image_resource to disk.

Definition at line 97 of file vil3d_save.cxx.

bool vil3d_save_image_resource ( const vil3d_image_resource_sptr ir,
char const *  filename 
) [related]

Save vil3d_image_resource to file, deducing format from filename.

Definition at line 111 of file vil3d_save.cxx.

friend class vil3d_slice_list_format [friend]

Reimplemented from vil3d_slice_list_image.

Definition at line 51 of file vil3d_dicom.h.


The documentation for this class was generated from the following file: