Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | Private Attributes | Friends | Related Functions
vil_mit_image Class Reference

Generic image implementation for MIT files. More...

#include <vil_mit.h>

Inheritance diagram for vil_mit_image:
Inheritance graph
[legend]

List of all members.

Public Member Functions

 vil_mit_image (vil_stream *is)
 vil_mit_image (vil_stream *is, unsigned int ni, unsigned int nj, unsigned int nplanes, vil_pixel_format format)
 ~vil_mit_image ()
virtual unsigned int ni () const
 Dimensions. W x H x Components.
virtual unsigned int nj () const
 Dimensions: Planes x ni x nj.
virtual unsigned int nplanes () const
 Dimensions: Planes x ni x nj.
unsigned int bytes_per_pixel () const
virtual enum vil_pixel_format pixel_format () const
 Pixel Format.
virtual vil_image_view_base_sptr get_copy_view (unsigned int x0, unsigned int ni, unsigned int y0, unsigned int nj) const
 Return part of this as buffer.
virtual bool put_view (vil_image_view_base const &buf, unsigned int x0, unsigned int y0)
 Write buf into this at position (x0,y0).
char const * file_format () const
 Return a string describing the file format.
bool get_property (char const *tag, void *prop=0) const
 Extra property information.
virtual vil_image_view_base_sptr get_view (unsigned i0, unsigned n_i, unsigned j0, unsigned n_j) const
 Create a read/write view of the data.
vil_image_view_base_sptr get_view () const
 Create a read/write view of all the data.
virtual vil_image_view_base_sptr get_copy_view (unsigned i0, unsigned n_i, unsigned j0, unsigned n_j) const =0
 Create a read/write view of a copy of this data.
vil_image_view_base_sptr get_copy_view () const
 Create a read/write view of a copy of all the data.
virtual bool put_view (const vil_image_view_base &im, unsigned i0, unsigned j0)=0
 Put the data in this view back into the image source.
virtual bool put_view (const vil_image_view_base &im)
 Put the data in this view back into the image source at the origin.
virtual bool view_fits (const vil_image_view_base &im, unsigned i0, unsigned j0)
 Check that a view will fit into the data at the given offset.

Protected Member Functions

void ref ()
void unref ()

Protected Attributes

vcl_atomic_count reference_count_

Private Member Functions

bool read_header ()
bool write_header ()

Private Attributes

vil_streamis_
unsigned int ni_
unsigned int nj_
unsigned int components_
unsigned int type_
enum vil_pixel_format format_

Friends

class vil_mit_file_format
class vil_smart_ptr< vil_image_resource >

Related Functions

(Note that these are not member functions.)

template<class destT , class kernelT , class accumT >
vil_image_resource_sptr vil_convolve_1d (const vil_image_resource_sptr &src_im, const destT, const kernelT *kernel, int k_lo, int k_hi, const accumT, vil_convolve_boundary_option start_option, vil_convolve_boundary_option end_option)
 Create an image_resource object which convolve kernel[x] x in [k_lo,k_hi] with srcT.
template<class destT , class kernelT , class accumT >
vil_image_resource_sptr vil_correlate_1d (const vil_image_resource_sptr &src_im, const destT, const kernelT *kernel, vcl_ptrdiff_t k_lo, vcl_ptrdiff_t k_hi, const accumT, vil_convolve_boundary_option start_option, vil_convolve_boundary_option end_option)
 Create an image_resource object which correlate kernel[x] x in [k_lo,k_hi] with srcT.
vil_image_resource_sptr vil_clamp (const vil_image_resource_sptr &src, double low, double hi)
 Clamp an image resource between two values.
bool vil_copy_deep (const vil_image_resource_sptr &src, vil_image_resource_sptr &dest)
 Copy src to dest.
vil_image_resource_sptr vil_crop (const vil_image_resource_sptr &src, unsigned i0, unsigned n_i, unsigned j0, unsigned n_j)
 Crop to a region of src.
vil_image_resource_sptr vil_decimate (const vil_image_resource_sptr &src, unsigned i_factor, unsigned j_factor=0)
 decimate to a region of src.
vil_image_resource_sptr vil_flip_lr (const vil_image_resource_sptr &src)
 Flip an image resource left to right.
vil_image_resource_sptr vil_flip_ud (const vil_image_resource_sptr &src)
 Flip an image resource left to right.
vil_image_resource_sptr vil_load_image_resource (char const *filename, bool verbose=true)
 Load an image resource object from a file.
vil_image_resource_sptr vil_load_image_resource_raw (vil_stream *, bool verbose=true)
 Load from a stream.
vil_image_resource_sptr vil_load_image_resource_raw (char const *, bool verbose=true)
 Load an image resource object from a file.
vil_image_resource_sptr vil_load_image_resource_plugin (char const *)
 Load from a filename with a plugin.
vil_image_resource_sptr vil_new_image_resource (unsigned ni, unsigned nj, unsigned nplanes, vil_pixel_format format)
 Make a new image of given format.
vil_image_resource_sptr vil_new_image_resource (unsigned ni, unsigned nj, vil_image_resource_sptr const &prototype)
 Make a new image, similar format to the prototype.
vil_image_resource_sptr vil_new_image_resource (vil_stream *os, unsigned ni, unsigned nj, unsigned nplanes, vil_pixel_format format, char const *file_format)
 Make a new image.
vil_image_resource_sptr vil_new_image_resource (char const *filename, unsigned ni, unsigned nj, vil_image_resource_sptr const &prototype, char const *file_format)
 Make a new vil_image_resource, writing to file "filename", size ni x nj, copying pixel format etc from "prototype".
vil_image_resource_sptr vil_new_image_resource (char const *filename, unsigned ni, unsigned nj, unsigned nplanes, vil_pixel_format format, char const *file_format)
 Make a new image.
vil_image_resource_sptr vil_new_image_resource (vil_stream *os, unsigned ni, unsigned nj, vil_image_resource_sptr const &prototype, char const *file_format)
 Make a new vil_image_resource, writing to stream "os", size ni x nj, copying pixel format etc from "prototype".
vil_image_resource_sptr vil_new_image_resource (char const *filename, unsigned ni, unsigned nj, unsigned nplanes, vil_image_resource_sptr const &prototype, char const *format=0)
 Make a new vil_image_resource, writing to file "filename", size ni x nj, copying pixel format etc from "prototype".
vil_image_resource_sptr vil_new_image_resource (vil_stream *os, unsigned ni, unsigned nj, unsigned nplanes, vil_image_resource_sptr const &prototype, char const *file_format=0)
 Make a new vil_image_resource, writing to stream "os", size ni x nj, copying pixel format etc from "prototype".
vil_image_resource_sptr vil_new_image_resource_interleaved (unsigned ni, unsigned nj, unsigned nplanes, vil_pixel_format format)
 Make a new image of given format with interleaved planes.
vil_image_resource_sptr vil_new_image_resource_of_view (vil_image_view_base const &view)
 Make a new image resource that is a wrapper on an existing view's data.
vil_image_resource_sptr vil_plane (const vil_image_resource_sptr &src, unsigned p)
 Return a specific plane of an image.
bool vil_save_image_resource (const vil_image_resource_sptr &ir, char const *filename, char const *file_format)
 Send vil_image_resource to disk.
bool vil_save_image_resource (const vil_image_resource_sptr &ir, char const *filename)
 Save vil_image_resource to file, deducing format from filename.
vil_image_resource_sptr vil_transpose (const vil_image_resource_sptr &src)
 Transpose an image.

Detailed Description

Generic image implementation for MIT files.

Definition at line 48 of file vil_mit.h.


Constructor & Destructor Documentation

vil_mit_image::vil_mit_image ( vil_stream is)

Definition at line 102 of file vil_mit.cxx.

vil_mit_image::vil_mit_image ( vil_stream is,
unsigned int  ni,
unsigned int  nj,
unsigned int  nplanes,
vil_pixel_format  format 
)

Definition at line 119 of file vil_mit.cxx.

vil_mit_image::~vil_mit_image ( )

Definition at line 128 of file vil_mit.cxx.


Member Function Documentation

unsigned int vil_mit_image::bytes_per_pixel ( ) const [inline]

Definition at line 74 of file vil_mit.h.

char const * vil_mit_image::file_format ( ) const [virtual]

Return a string describing the file format.

Only file images have a format, others return 0

Reimplemented from vil_image_resource.

Definition at line 114 of file vil_mit.cxx.

virtual vil_image_view_base_sptr vil_image_resource::get_copy_view ( unsigned  i0,
unsigned  n_i,
unsigned  j0,
unsigned  n_j 
) const [pure virtual, inherited]
vil_image_view_base_sptr vil_mit_image::get_copy_view ( unsigned int  x0,
unsigned int  ni,
unsigned int  y0,
unsigned int  nj 
) const [virtual]

Return part of this as buffer.

Definition at line 254 of file vil_mit.cxx.

vil_image_view_base_sptr vil_image_resource::get_copy_view ( ) const [inline, inherited]

Create a read/write view of a copy of all the data.

Reimplemented in vil_nitf2_image, and vil_j2k_image.

Definition at line 80 of file vil_image_resource.h.

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

Extra property information.

Implements vil_image_resource.

Definition at line 133 of file vil_mit.cxx.

virtual vil_image_view_base_sptr vil_image_resource::get_view ( unsigned  i0,
unsigned  n_i,
unsigned  j0,
unsigned  n_j 
) 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

   vil_reformat(data->get_view(..), window);
  

Reimplemented in vil_flip_ud_image_resource, vil_memory_image, vil_plane_image_resource, vil_flip_lr_image_resource, vil_clamp_image_resource, vil_dicom_image, vil_decimate_image_resource, vil_crop_image_resource, and vil_transpose_image_resource.

Definition at line 64 of file vil_image_resource.h.

vil_image_view_base_sptr vil_image_resource::get_view ( ) const [inline, inherited]

Create a read/write view of all the data.

Definition at line 69 of file vil_image_resource.h.

virtual unsigned int vil_mit_image::ni ( ) const [inline, virtual]

Dimensions. W x H x Components.

Implements vil_image_resource.

Definition at line 70 of file vil_mit.h.

virtual unsigned int vil_mit_image::nj ( ) const [inline, virtual]

Dimensions: Planes x ni x nj.

The number of pixels in each column.

Implements vil_image_resource.

Definition at line 71 of file vil_mit.h.

virtual unsigned int vil_mit_image::nplanes ( ) const [inline, virtual]

Dimensions: Planes x ni x nj.

This concept is treated as a synonym to components.

Implements vil_image_resource.

Definition at line 72 of file vil_mit.h.

virtual enum vil_pixel_format vil_mit_image::pixel_format ( ) const [inline, virtual]

Pixel Format.

A standard RGB RGB RGB of chars image has pixel_format() == VIL_PIXEL_FORMAT_BYTE

Implements vil_image_resource.

Definition at line 76 of file vil_mit.h.

bool vil_mit_image::put_view ( vil_image_view_base const &  buf,
unsigned int  x0,
unsigned int  y0 
) [virtual]

Write buf into this at position (x0,y0).

Definition at line 294 of file vil_mit.cxx.

virtual bool vil_image_resource::put_view ( const vil_image_view_base im,
unsigned  i0,
unsigned  j0 
) [pure virtual, inherited]
virtual bool vil_image_resource::put_view ( const vil_image_view_base im) [inline, virtual, inherited]

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

Reimplemented in vil_j2k_image.

Definition at line 92 of file vil_image_resource.h.

bool vil_mit_image::read_header ( ) [private]

Definition at line 139 of file vil_mit.cxx.

void vil_image_resource::ref ( ) [inline, protected, inherited]

Definition at line 110 of file vil_image_resource.h.

void vil_image_resource::unref ( ) [inline, protected, inherited]

Definition at line 111 of file vil_image_resource.h.

bool vil_image_resource::view_fits ( const vil_image_view_base im,
unsigned  i0,
unsigned  j0 
) [virtual, inherited]

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

This includes checking that the pixel type is scalar.

Reimplemented in vil_j2k_image.

Definition at line 30 of file vil_image_resource.cxx.

bool vil_mit_image::write_header ( ) [private]

Definition at line 182 of file vil_mit.cxx.


Friends And Related Function Documentation

vil_image_resource_sptr vil_clamp ( const vil_image_resource_sptr src,
double  low,
double  hi 
) [related]

Clamp an image resource between two values.

Reimplemented in vil_clamp_image_resource.

Definition at line 22 of file vil_clamp.cxx.

template<class destT , class kernelT , class accumT >
vil_image_resource_sptr vil_convolve_1d ( const vil_image_resource_sptr src_im,
const destT  ,
const kernelT *  kernel,
int  k_lo,
int  k_hi,
const accumT  ,
vil_convolve_boundary_option  start_option,
vil_convolve_boundary_option  end_option 
) [related]

Create an image_resource object which convolve kernel[x] x in [k_lo,k_hi] with srcT.

Note:
This function reverses the kernel. If you don't want the kernel reversed, use vil_correlate_1d instead.
Parameters:
kernelshould point to tap 0.

Definition at line 403 of file vil_convolve_1d.h.

bool vil_copy_deep ( const vil_image_resource_sptr src,
vil_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 41 of file vil_copy.cxx.

template<class destT , class kernelT , class accumT >
vil_image_resource_sptr vil_correlate_1d ( const vil_image_resource_sptr src_im,
const destT  ,
const kernelT *  kernel,
vcl_ptrdiff_t  k_lo,
vcl_ptrdiff_t  k_hi,
const accumT  ,
vil_convolve_boundary_option  start_option,
vil_convolve_boundary_option  end_option 
) [related]

Create an image_resource object which correlate kernel[x] x in [k_lo,k_hi] with srcT.

Note:
This function does not reverse the kernel. If you want the kernel reversed, use vil_convolve_1d instead.
Parameters:
kernelshould point to tap 0.

Definition at line 214 of file vil_correlate_1d.h.

vil_image_resource_sptr vil_crop ( const vil_image_resource_sptr src,
unsigned  i0,
unsigned  n_i,
unsigned  j0,
unsigned  n_j 
) [related]

Crop to a region of src.

Definition at line 15 of file vil_crop.cxx.

vil_image_resource_sptr vil_decimate ( const vil_image_resource_sptr src,
unsigned  i_factor,
unsigned  j_factor = 0 
) [related]

decimate to a region of src.

Definition at line 23 of file vil_decimate.cxx.

vil_image_resource_sptr vil_flip_lr ( const vil_image_resource_sptr src) [related]

Flip an image resource left to right.

Definition at line 17 of file vil_flip.cxx.

vil_image_resource_sptr vil_flip_ud ( const vil_image_resource_sptr src) [related]

Flip an image resource left to right.

Reimplemented in vil_flip_ud_image_resource.

Definition at line 124 of file vil_flip.cxx.

vil_image_resource_sptr vil_load_image_resource ( char const *  filename,
bool  verbose = true 
) [related]

Load an image resource object from a file.

Definition at line 71 of file vil_load.cxx.

vil_image_resource_sptr vil_load_image_resource_plugin ( char const *  ) [related]

Load from a filename with a plugin.

Definition at line 83 of file vil_load.cxx.

vil_image_resource_sptr vil_load_image_resource_raw ( vil_stream ,
bool  verbose = true 
) [related]

Load from a stream.

Won't use plugins.

Definition at line 19 of file vil_load.cxx.

vil_image_resource_sptr vil_load_image_resource_raw ( char const *  ,
bool  verbose = true 
) [related]

Load an image resource object from a file.

Won't use plugins.

Definition at line 45 of file vil_load.cxx.

friend class vil_mit_file_format [friend]

Definition at line 60 of file vil_mit.h.

vil_image_resource_sptr vil_new_image_resource ( unsigned  ni,
unsigned  nj,
unsigned  nplanes,
vil_pixel_format  format 
) [related]

Make a new image of given format.

If the format is not scalar, the number of planes must be 1. When you create a multi-component image in this way, the vil_image_resource API will treat it as a scalar pixel image with multiple planes. (This doesn't affect the underlying data storage.)

Reimplemented in vil_memory_image.

Definition at line 32 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource ( unsigned  ni,
unsigned  nj,
vil_image_resource_sptr const &  prototype 
) [related]

Make a new image, similar format to the prototype.

Definition at line 69 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource ( vil_stream os,
unsigned  ni,
unsigned  nj,
unsigned  nplanes,
vil_pixel_format  format,
char const *  file_format 
) [related]

Make a new image.

Definition at line 77 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource ( char const *  filename,
unsigned  ni,
unsigned  nj,
unsigned  nplanes,
vil_image_resource_sptr const &  prototype,
char const *  format = 0 
) [related]

Make a new vil_image_resource, writing to file "filename", size ni x nj, copying pixel format etc from "prototype".

vil_image_resource_sptr vil_new_image_resource ( vil_stream os,
unsigned  ni,
unsigned  nj,
unsigned  nplanes,
vil_image_resource_sptr const &  prototype,
char const *  file_format = 0 
) [related]

Make a new vil_image_resource, writing to stream "os", size ni x nj, copying pixel format etc from "prototype".

vil_image_resource_sptr vil_new_image_resource ( char const *  filename,
unsigned  ni,
unsigned  nj,
vil_image_resource_sptr const &  prototype,
char const *  file_format 
) [related]

Make a new vil_image_resource, writing to file "filename", size ni x nj, copying pixel format etc from "prototype".

Definition at line 104 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource ( char const *  filename,
unsigned  ni,
unsigned  nj,
unsigned  nplanes,
vil_pixel_format  format,
char const *  file_format 
) [related]

Make a new image.

Definition at line 123 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource ( vil_stream os,
unsigned  ni,
unsigned  nj,
vil_image_resource_sptr const &  prototype,
char const *  file_format 
) [related]

Make a new vil_image_resource, writing to stream "os", size ni x nj, copying pixel format etc from "prototype".

Definition at line 143 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource_interleaved ( unsigned  ni,
unsigned  nj,
unsigned  nplanes,
vil_pixel_format  format 
) [related]

Make a new image of given format with interleaved planes.

The format must be scalar.

Reimplemented in vil_memory_image.

Definition at line 44 of file vil_new.cxx.

vil_image_resource_sptr vil_new_image_resource_of_view ( vil_image_view_base const &  view) [related]

Make a new image resource that is a wrapper on an existing view's data.

Note:
The output will be a shallow copy of the input, so changing the pixel values of one may change the pixel value of the other. Thanks to the magic of smart pointers, the output will remain valid even if you destroy the input. When you wrap a multi-component image in this way, the vil_image_resource API will treat it as a scalar pixel image with multiple planes. (This doesn't affect the underlying data storage.)

Reimplemented in vil_memory_image.

Definition at line 62 of file vil_new.cxx.

vil_image_resource_sptr vil_plane ( const vil_image_resource_sptr src,
unsigned  p 
) [related]

Return a specific plane of an image.

Reimplemented in vil_plane_image_resource.

Definition at line 19 of file vil_plane.cxx.

bool vil_save_image_resource ( const vil_image_resource_sptr ir,
char const *  filename,
char const *  file_format 
) [related]

Send vil_image_resource to disk.

Definition at line 128 of file vil_save.cxx.

bool vil_save_image_resource ( const vil_image_resource_sptr ir,
char const *  filename 
) [related]

Save vil_image_resource to file, deducing format from filename.

Definition at line 147 of file vil_save.cxx.

friend class vil_smart_ptr< vil_image_resource > [friend, inherited]

Definition at line 109 of file vil_image_resource.h.

vil_image_resource_sptr vil_transpose ( const vil_image_resource_sptr src) [related]

Transpose an image.

Definition at line 17 of file vil_transpose.cxx.


Member Data Documentation

unsigned int vil_mit_image::components_ [private]

Definition at line 53 of file vil_mit.h.

Definition at line 55 of file vil_mit.h.

Definition at line 50 of file vil_mit.h.

unsigned int vil_mit_image::ni_ [private]

Definition at line 51 of file vil_mit.h.

unsigned int vil_mit_image::nj_ [private]

Definition at line 52 of file vil_mit.h.

vcl_atomic_count vil_image_resource::reference_count_ [protected, inherited]

Definition at line 114 of file vil_image_resource.h.

unsigned int vil_mit_image::type_ [private]

Definition at line 54 of file vil_mit.h.


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