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.
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,.
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,.
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.
DLL_EXPORT void	dsp_file_write_jpeg (const char *filename, int quality, dsp_stream_p stream)
	Write the stream into a JPEG file,.
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,.
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.
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,.
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.
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.
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.
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.
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.
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.
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.
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 contiguous component array.
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.
DLL_EXPORT dsp_triangle *	dsp_align_calc_triangle (dsp_star *stars, int num_stars)
	Create a dsp_triangle struct.
DLL_EXPORT void	dsp_align_free_triangle (dsp_triangle *triangle)
	Free a dsp_triangle struct pointer.
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.

Detailed Description

Function Documentation

dsp_align_calc_triangle()

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

Create a dsp_triangle struct.

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

Definition at line 197 of file align.c.

dsp_align_fill_info()

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.

Parameters

t1	the reference triangle
t2	the triangle taken for comparison

Returns

The dsp_align_info struct pointer filled with the offsets

Definition at line 147 of file align.c.

dsp_align_free_triangle()

DLL_EXPORT void dsp_align_free_triangle

(

dsp_triangle *

triangle

)

Free a dsp_triangle struct pointer.

Parameters

triangle

pointer to an allocated dsp_triangle struct

Definition at line 184 of file align.c.

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
	)

Calculate offsets, rotation and scaling of two streams giving reference alignment point.

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)

Definition at line 259 of file align.c.

dsp_buffer_components_to_rgb()

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.

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

Definition at line 1139 of file file.c.

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
	)

Convert an RGB color dsp_t array into a dsp_stream_p array each element containing the single components.

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

Definition at line 1064 of file file.c.

dsp_file_bayer_2_composite()

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 contiguous component array.

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

Definition at line 850 of file file.c.

dsp_file_bayer_2_gray()

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.

Parameters

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

Returns

The new dsp_t array

Definition at line 648 of file file.c.

dsp_file_bayer_2_rgb()

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.

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

Definition at line 946 of file file.c.

dsp_file_composite_2_bayer()

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.

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

Definition at line 744 of file file.c.

dsp_file_read_fits()

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.

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

Definition at line 27 of file file.c.

dsp_file_read_jpeg()

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.

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

Definition at line 514 of file file.c.

dsp_file_read_png()

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.

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
	)

Write the dsp_stream_p into a FITS file,.

Parameters

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

Definition at line 164 of file file.c.

dsp_file_write_fits_bayer()

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.

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

Definition at line 374 of file file.c.

dsp_file_write_fits_composite()

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,.

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

Definition at line 266 of file file.c.

dsp_file_write_jpeg()

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

Write the stream into a JPEG file,.

Parameters

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

Definition at line 552 of file file.c.

dsp_file_write_jpeg_composite()

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,.

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

Definition at line 603 of file file.c.

dsp_file_write_png_composite()

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,.

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
	)

Convert a color component dsp_t array into a dsp_stream_p array each element containing the single 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

Definition at line 1040 of file file.c.