Representation of a pyramid resolution hierarchy; mostly pure virtual methods. More...

#include <vil_j2k_nitf2_pyramid_image_resource.h>

Inheritance diagram for vil_j2k_nitf2_pyramid_image_resource:

Public Member Functions
	vil_j2k_nitf2_pyramid_image_resource (vil_image_resource_sptr const &nitf2)
virtual	~vil_j2k_nitf2_pyramid_image_resource ()
virtual unsigned	nplanes () const
	The number of planes (or components) in the image.
virtual unsigned	ni () const
	The number of pixels in each row.
virtual unsigned	nj () const
	The number of pixels in each column.
virtual enum vil_pixel_format	pixel_format () const
	Pixel Format.
virtual bool	put_view (vil_image_view_base const &, unsigned, unsigned)
	Put the data in this view back into the base image.
virtual char const *	file_format () const
	Return a string describing the file format.
virtual unsigned	nlevels () const
	Number of pyramid levels.
virtual vil_image_view_base_sptr	get_copy_view (unsigned i0, unsigned n_i, unsigned j0, unsigned n_j, unsigned level) const
	Get a partial view from the image from a specified pyramid level.
virtual vil_image_view_base_sptr	get_copy_view (unsigned level) const
	Get a complete view from a specified pyramid level.
virtual vil_image_view_base_sptr	get_copy_view (unsigned i0, unsigned n_i, unsigned j0, unsigned n_j, const float scale, float &actual_scale) const
	Get a partial view from the image in the pyramid closest to scale.
virtual vil_image_view_base_sptr	get_copy_view (const float scale, float &actual_scale) const
	Get a complete view from the image in the pyramid closest to the specified scale.
virtual bool	put_resource (vil_image_resource_sptr const &resc)
	Copy a resource into the pyramid, level is determined by resource scale.
virtual vil_image_resource_sptr	get_resource (const unsigned level) const
	Get an image resource from the pyramid at the specified level.
virtual void	print (const unsigned level)
	for debug purposes.
virtual vil_image_view_base_sptr	get_copy_view (unsigned i0, unsigned n_i, unsigned j0, unsigned n_j) const
	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)
	Put the data in this view back into the image source at the origin.
virtual bool	get_property (char const tag, void property_value=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 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.
Static Public Member Functions
static bool	blocked_decimate (vil_blocked_image_resource_sptr const &brsc, vil_blocked_image_resource_sptr &dec_resc)
	A utility function to decimate a resource using blocks.
static vil_image_resource_sptr	decimate (vil_image_resource_sptr const &resc, char const filename, char const format="tiff")
	Utility for decimating a resource to create a new pyramid level.
Protected Member Functions
	vil_j2k_nitf2_pyramid_image_resource ()
void	ref ()
void	unref ()
Protected Attributes
vil_image_resource_sptr	nitf2_sptr_
vil_nitf2_image *	ptr_
vcl_atomic_count	reference_count_
Friends
class	vil_smart_ptr< vil_pyramid_image_resource >
class	vil_smart_ptr< vil_image_resource >
Related Functions
(Note that these are not member functions.)
vil_pyramid_image_resource_sptr	vil_load_pyramid_resource (char const *directory_or_file, bool verbose=true)
	Load a pyramid image resource object from a file or directory.
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

Representation of a pyramid resolution hierarchy; mostly pure virtual methods.

The pyramid consists of a set of scaled (lower resolution) copies of the base image. A typical case is where the copies are each a factor of two smaller than the next lower image in the pyramid. However, there is no intrinsic assumption about the scale difference between copies at different levels.

All image positions and sizes are expressed in the coordinate system of the base image. The transformation from base image coordinates to one of the copy images is given by: ic = ib*scale, jc = jb*scale. Thus the base image is considered to have scale = 1.0. The copies all have scale<1.0.

Definition at line 34 of file vil_j2k_nitf2_pyramid_image_resource.h.

Constructor & Destructor Documentation

vil_j2k_nitf2_pyramid_image_resource::vil_j2k_nitf2_pyramid_image_resource ( vil_image_resource_sptr const & nitf2 )

Definition at line 20 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

virtual vil_j2k_nitf2_pyramid_image_resource::~vil_j2k_nitf2_pyramid_image_resource ( ) [inline, virtual]

Definition at line 38 of file vil_j2k_nitf2_pyramid_image_resource.h.

vil_j2k_nitf2_pyramid_image_resource::vil_j2k_nitf2_pyramid_image_resource ( ) [protected]

Member Function Documentation

bool vil_pyramid_image_resource::blocked_decimate	(	vil_blocked_image_resource_sptr const &	brsc,
		vil_blocked_image_resource_sptr &	dec_resc
	)		`[static, inherited]`

A utility function to decimate a resource using blocks.

The new scale is one half the input resource scale

Definition at line 127 of file vil_pyramid_image_resource.cxx.

vil_image_resource_sptr vil_pyramid_image_resource::decimate	(	vil_image_resource_sptr const &	resc,
		char const *	filename,
		char const *	format = `"tiff"`
	)		`[static, inherited]`

Utility for decimating a resource to create a new pyramid level.

The new scale is one half the input resource scale. Creates a new resource from filename according to file format

Definition at line 300 of file vil_pyramid_image_resource.cxx.

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

Return a string describing the file format.

Only file images have a format, others return 0

Implements vil_pyramid_image_resource.

Definition at line 70 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

virtual vil_image_view_base_sptr vil_pyramid_image_resource::get_copy_view	(	unsigned	i0,
		unsigned	n_i,
		unsigned	j0,
		unsigned	n_j
	)		const `[inline, virtual, inherited]`

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

Applies only to the base image

Implements vil_image_resource.

Definition at line 61 of file vil_pyramid_image_resource.h.

vil_image_view_base_sptr vil_j2k_nitf2_pyramid_image_resource::get_copy_view	(	unsigned	i0,
		unsigned	n_i,
		unsigned	j0,
		unsigned	n_j,
		unsigned	level
	)		const `[virtual]`

Get a partial view from the image from a specified pyramid level.

Implements vil_pyramid_image_resource.

Definition at line 101 of file vil_j2k_nitf2_pyramid_image_resource.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.

virtual vil_image_view_base_sptr vil_j2k_nitf2_pyramid_image_resource::get_copy_view ( unsigned level ) const [inline, virtual]

Get a complete view from a specified pyramid level.

This method needs no specialisation.

Reimplemented from vil_pyramid_image_resource.

Definition at line 85 of file vil_j2k_nitf2_pyramid_image_resource.h.

vil_image_view_base_sptr vil_j2k_nitf2_pyramid_image_resource::get_copy_view	(	unsigned	i0,
		unsigned	n_i,
		unsigned	j0,
		unsigned	n_j,
		const float	scale,
		float &	actual_scale
	)		const `[virtual]`

Get a partial view from the image in the pyramid closest to scale.

The origin and size parameters are in the coordinate system of the base image. The scale factor is with respect to the base image (base scale = 1.0).

Implements vil_pyramid_image_resource.

Definition at line 118 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

virtual vil_image_view_base_sptr vil_j2k_nitf2_pyramid_image_resource::get_copy_view	(	const float	scale,
		float &	actual_scale
	)		const `[inline, virtual]`

Get a complete view from the image in the pyramid closest to the specified scale.

The scale factor is with respect to the base image (base scale = 1.0). This method needs no specialisation.

Reimplemented from vil_pyramid_image_resource.

Definition at line 99 of file vil_j2k_nitf2_pyramid_image_resource.h.

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

Extra property information.

Implements vil_image_resource.

Definition at line 26 of file vil_pyramid_image_resource.cxx.

vil_image_resource_sptr vil_j2k_nitf2_pyramid_image_resource::get_resource ( const unsigned level ) const [virtual]

Get an image resource from the pyramid at the specified level.

Implements vil_pyramid_image_resource.

Definition at line 138 of file vil_j2k_nitf2_pyramid_image_resource.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.

unsigned vil_j2k_nitf2_pyramid_image_resource::ni ( ) const [virtual]

The number of pixels in each row.

Dimensions: Planes x ni x nj. This method refers to the base (max resolution) image

Implements vil_pyramid_image_resource.

Definition at line 41 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

unsigned vil_j2k_nitf2_pyramid_image_resource::nj ( ) const [virtual]

The number of pixels in each column.

Dimensions: Planes x ni x nj. This method refers to the base (max resolution) image

Implements vil_pyramid_image_resource.

Definition at line 52 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

unsigned vil_j2k_nitf2_pyramid_image_resource::nlevels ( ) const [virtual]

Number of pyramid levels.

In principle, the number of levels is undefined since the j2k decoder can decompress to any window size. A reasonable strategy is to define the number of levels so that the lowest scale produces a smallest image dimension of 1K pixels

Defined to assign 1000 pixels to the largest dimension of the least resolution level

Implements vil_pyramid_image_resource.

Definition at line 81 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

unsigned vil_j2k_nitf2_pyramid_image_resource::nplanes ( ) const [virtual]

The number of planes (or components) in the image.

Dimensions: Planes x ni x nj. This method refers to the base (max resolution) image This concept is treated as a synonym to components.

Implements vil_pyramid_image_resource.

Definition at line 30 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

vil_pixel_format vil_j2k_nitf2_pyramid_image_resource::pixel_format ( ) const [virtual]

Pixel Format.

Implements vil_pyramid_image_resource.

Definition at line 61 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

void vil_j2k_nitf2_pyramid_image_resource::print ( const unsigned level ) [virtual]

for debug purposes.

Implements vil_pyramid_image_resource.

Definition at line 146 of file vil_j2k_nitf2_pyramid_image_resource.cxx.

virtual bool vil_j2k_nitf2_pyramid_image_resource::put_resource ( vil_image_resource_sptr const & resc ) [inline, virtual]

Copy a resource into the pyramid, level is determined by resource scale.

Implements vil_pyramid_image_resource.

Definition at line 103 of file vil_j2k_nitf2_pyramid_image_resource.h.

virtual bool vil_j2k_nitf2_pyramid_image_resource::put_view	(	vil_image_view_base const &	,
		unsigned	,
		unsigned
	)		`[inline, virtual]`

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

Pyramid is readonly. This is essentially (although not formally) a pure virtual function.

Reimplemented from vil_pyramid_image_resource.

Definition at line 62 of file vil_j2k_nitf2_pyramid_image_resource.h.

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.

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.

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:

kernel should 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:

kernel should 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.

vil_pyramid_image_resource_sptr vil_load_pyramid_resource	(	char const *	directory_or_file,
		bool	verbose = `true`
	)		`[related]`

Load a pyramid image resource object from a file or directory.

Definition at line 103 of file vil_load.cxx.

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.