DSP API File read/write functions

Functions
DLL_EXPORT dsp_stream_p *	dsp_file_read_fits (const char *filename, int *channels, int stretch)
	Read a FITS file and fill a dsp_stream_p with its content. More...
DLL_EXPORT void	dsp_file_write_fits (const char *filename, int bpp, dsp_stream_p stream)
	Write the dsp_stream_p into a FITS file,. More...
DLL_EXPORT void	dsp_file_write_fits_composite (const char *filename, int components, int bpp, dsp_stream_p *stream)
	Write the components dsp_stream_p array into a JPEG file,. More...
DLL_EXPORT dsp_stream_p *	dsp_file_read_jpeg (const char *filename, int *channels, int stretch)
	Read a JPEG file and fill a array of dsp_stream_p with its content, each color channel has its own stream in this array and an additional grayscale at end will be added. More...
DLL_EXPORT void	dsp_file_write_jpeg (const char *filename, int quality, dsp_stream_p stream)
	Write the stream into a JPEG file,. More...
DLL_EXPORT void	dsp_file_write_jpeg_composite (const char *filename, int components, int quality, dsp_stream_p *stream)
	Write the components dsp_stream_p array into a JPEG file,. More...
DLL_EXPORT dsp_stream_p *	dsp_file_read_png (const char *filename, int *channels, int stretch)
	Read a PNG file and fill a array of dsp_stream_p with its content, each color channel has its own stream in this array and an additional grayscale at end will be added. More...
DLL_EXPORT void	dsp_file_write_png_composite (const char *filename, int components, int compression, dsp_stream_p *stream)
	Write the components dsp_stream_p array into a PNG file,. More...
DLL_EXPORT dsp_t *	dsp_file_bayer_2_gray (dsp_t *src, int width, int height)
	Convert a bayer pattern dsp_t array into a grayscale array. More...
DLL_EXPORT dsp_t *	dsp_file_bayer_2_rgb (dsp_t *src, int red, int width, int height)
	Convert a bayer pattern dsp_t array into a ordered 3 RGB array. More...
DLL_EXPORT dsp_stream_p *	dsp_stream_from_components (dsp_t *buf, int dims, int *sizes, int components)
	Convert a color component dsp_t array into a dsp_stream_p array each element containing the single components. More...
DLL_EXPORT dsp_stream_p *	dsp_buffer_rgb_to_components (void *buf, int dims, int *sizes, int components, int bpp, int stretch)
	Convert an RGB color dsp_t array into a dsp_stream_p array each element containing the single components. More...
DLL_EXPORT void	dsp_buffer_components_to_rgb (dsp_stream_p *stream, void *rgb, int components, int bpp)
	Convert a component dsp_stream_p array into an RGB dsp_t array. More...
DLL_EXPORT dsp_t *	dsp_file_composite_2_bayer (dsp_stream_p *src, int red, int width, int height)
	Convert a component dsp_stream_p array into a bayer dsp_t array. More...
DLL_EXPORT void	dsp_file_write_fits_bayer (const char *filename, int components, int bpp, dsp_stream_p *stream)
	Write a FITS file from a dsp_stream_p array. More...
DLL_EXPORT dsp_t *	dsp_file_bayer_2_composite (dsp_t *src, int red, int width, int height)
	Convert a bayer pattern dsp_t array into a contiguos component array. More...
DLL_EXPORT dsp_align_info *	dsp_align_fill_info (dsp_triangle t1, dsp_triangle t2)
	Fill a dsp_align_info struct by comparing two triangles. More...
DLL_EXPORT dsp_triangle *	dsp_align_calc_triangle (dsp_star *stars, int num_stars)
	Create a dsp_triangle struct. More...
DLL_EXPORT void	dsp_align_free_triangle (dsp_triangle *triangle)
	Free a dsp_triangle struct pointer. More...
DLL_EXPORT int	dsp_align_get_offset (dsp_stream_p ref, dsp_stream_p to_align, double tolerance, double target_score, int num_stars)
	Calculate offsets, rotation and scaling of two streams giving reference alignment point. More...

Detailed Description

Function Documentation

dsp_align_calc_triangle()

DLL_EXPORT dsp_triangle* dsp_align_calc_triangle	(	dsp_star *	stars,
		int	num_stars
	)

Parameters

stars	the stars array needed to build the triangle struct
num_stars	the count of the stars

Returns

A new dsp_triangle struct pointer

dsp_align_fill_info()

DLL_EXPORT dsp_align_info* dsp_align_fill_info	(	dsp_triangle	t1,
		dsp_triangle	t2
	)

Parameters

t1	the reference triangle
t2	the triangle taken for comparison

Returns

The dsp_align_info struct pointer filled with the offsets

dsp_align_free_triangle()

DLL_EXPORT void dsp_align_free_triangle

(

dsp_triangle *

triangle

)

Parameters

triangle

pointer to an allocated dsp_triangle struct

dsp_align_get_offset()

DLL_EXPORT int dsp_align_get_offset	(	dsp_stream_p	ref,
		dsp_stream_p	to_align,
		double	tolerance,
		double	target_score,
		int	num_stars
	)

Parameters

ref	the reference stream
to_align	the stream to be aligned
tolerance	number of decimals allowed
target_score	the minimum matching score to reach
num_stars	number of stars for each triangle

Returns

The alignment mask (bit1: translated, bit2: scaled, bit3: rotated)

dsp_buffer_components_to_rgb()

DLL_EXPORT void dsp_buffer_components_to_rgb	(	dsp_stream_p *	stream,
		void *	rgb,
		int	components,
		int	bpp
	)

Parameters

stream	the component dsp_stream_p array
rgb	the output buffer
components	the number of the color components
bpp	the color depth of the color components

dsp_buffer_rgb_to_components()

DLL_EXPORT dsp_stream_p* dsp_buffer_rgb_to_components	(	void *	buf,
		int	dims,
		int *	sizes,
		int	components,
		int	bpp,
		int	stretch
	)

Parameters

buf	the input buffer
dims	the number of dimension
sizes	the sizes of each dimension
components	the number of the color components
bpp	the color depth of the color components
stretch	whether to stretch within 0 and dsp_t_max

Returns

The new dsp_stream_p array

dsp_file_bayer_2_composite()

DLL_EXPORT dsp_t* dsp_file_bayer_2_composite	(	dsp_t *	src,
		int	red,
		int	width,
		int	height
	)

Parameters

src	the input buffer
red	the location of the red pixel within the bayer pattern
width	the picture width
height	the picture height

Returns

The new dsp_t array

dsp_file_bayer_2_gray()

DLL_EXPORT dsp_t* dsp_file_bayer_2_gray	(	dsp_t *	src,
		int	width,
		int	height
	)

Parameters

src	the input buffer
width	the picture width
height	the picture height

Returns

The new dsp_t array

dsp_file_bayer_2_rgb()

DLL_EXPORT dsp_t* dsp_file_bayer_2_rgb	(	dsp_t *	src,
		int	red,
		int	width,
		int	height
	)

Parameters

src	the input buffer
red	the location of the red pixel within the bayer pattern
width	the picture width
height	the picture height

Returns

The new dsp_t array

dsp_file_composite_2_bayer()

DLL_EXPORT dsp_t* dsp_file_composite_2_bayer	(	dsp_stream_p *	src,
		int	red,
		int	width,
		int	height
	)

Parameters

src	the component dsp_stream_p array
red	the red offset within the bayer quad
width	the width of the output array
height	the height of the output array

Returns

The new dsp_stream_p array

dsp_file_read_fits()

DLL_EXPORT dsp_stream_p* dsp_file_read_fits	(	const char *	filename,
		int *	channels,
		int	stretch
	)

Parameters

filename	the file name.
channels	will be filled with the number of components
stretch	1 if the buffer intensities have to be stretched

Returns

The new dsp_stream_p structure pointer

dsp_file_read_jpeg()

DLL_EXPORT dsp_stream_p* dsp_file_read_jpeg	(	const char *	filename,
		int *	channels,
		int	stretch
	)

Parameters

filename	the file name.
channels	this value will be updated with the channel quantity into the picture.
stretch	1 if the buffer intensities have to be stretched

Returns

The new dsp_stream_p structure pointers array

dsp_file_read_png()

DLL_EXPORT dsp_stream_p* dsp_file_read_png	(	const char *	filename,
		int *	channels,
		int	stretch
	)

Parameters

filename	the file name.
channels	this value will be updated with the channel quantity into the picture.
stretch	1 if the buffer intensities have to be stretched

Returns

The new dsp_stream_p structure pointers array

dsp_file_write_fits()

DLL_EXPORT void dsp_file_write_fits	(	const char *	filename,
		int	bpp,
		dsp_stream_p	stream
	)

Parameters

filename	the file name.
bpp	the bit depth of the output FITS file.
stream	the input stream to be saved

dsp_file_write_fits_bayer()

DLL_EXPORT void dsp_file_write_fits_bayer	(	const char *	filename,
		int	components,
		int	bpp,
		dsp_stream_p *	stream
	)

Parameters

filename	the output file name
components	the number of the color components
bpp	the color depth of the color components
stream	the component dsp_stream_p array

dsp_file_write_fits_composite()

DLL_EXPORT void dsp_file_write_fits_composite	(	const char *	filename,
		int	components,
		int	bpp,
		dsp_stream_p *	stream
	)

Parameters

filename	the file name.
components	the number of streams in the array to be used as components 1 or 3.
bpp	the bit depth of the output JPEG file [8,16,32,64,-32,-64].
stream	the input stream to be saved

dsp_file_write_jpeg()

DLL_EXPORT void dsp_file_write_jpeg	(	const char *	filename,
		int	quality,
		dsp_stream_p	stream
	)

Parameters

filename	the file name.
quality	the quality of the output JPEG file 0-100.
stream	the input stream to be saved

dsp_file_write_jpeg_composite()

DLL_EXPORT void dsp_file_write_jpeg_composite	(	const char *	filename,
		int	components,
		int	quality,
		dsp_stream_p *	stream
	)

Parameters

filename	the file name.
components	the number of streams in the array to be used as components 1 or 3.
quality	the quality of the output JPEG file 0-100.
stream	the input stream to be saved

dsp_file_write_png_composite()

DLL_EXPORT void dsp_file_write_png_composite	(	const char *	filename,
		int	components,
		int	compression,
		dsp_stream_p *	stream
	)

Parameters

filename	the file name.
components	the number of streams in the array to be used as components 1 or 3.
compression	the compression of the output PNG 0-9.
stream	the input stream array to be saved

dsp_stream_from_components()

DLL_EXPORT dsp_stream_p* dsp_stream_from_components	(	dsp_t *	buf,
		int	dims,
		int *	sizes,
		int	components
	)

Parameters

buf	the input buffer
dims	the number of dimension
sizes	the sizes of each dimension
components	the number of the color components

Returns

The new dsp_stream_p array