misc.h File Reference

Miscellanous unsorted functions. More...

#include <stdio.h>
#include "struct.h"
#include "global.h"

Include dependency graph for misc.h:

This graph shows which files directly or indirectly include this file:

Macros
#define	SWAP_BYTES(a, b)   { byte c=a; a=b; b=c;}
#define	SWAP_WORDS(a, b)   { word c=a; a=b; b=c;}
#define	SWAP_DWORDS(a, b)   { dword c=a; a=b; b=c;}
#define	SWAP_SHORTS(a, b)   { short c=a; a=b; b=c;}
#define	SWAP_FLOATS(a, b)   { float c=a; a=b; b=c;}
#define	SWAP_PBYTES(a, b)   { byte * c=a; a=b; b=c;}
#define	Num2str(a, b, c)   snprintf(b,sizeof(b),"%*lu",(int)c,(unsigned long)(a))
#define	Dec2str(a, b, c)   sprintf(b,"%.*f",c,(double)(a))

Functions
void	Copy_image_to_brush (short start_x, short start_y, short Brush_width, short Brush_height, word image_width)
void	Remap_general_lowlevel (byte *conversion_table, byte *in_buffer, byte *out_buffer, short width, short height, short buffer_width)
void	Scroll_picture (byte *main_src, byte *main_dest, short x_offset, short y_offset)
void	Wait_end_of_click (void)
void	Set_color (byte color, byte red, byte green, byte blue)
const T_Components *	Get_current_palette (void)
void	Set_palette (T_Palette palette)
void	Clear_current_image (byte color)
void	Clear_current_image_with_stencil (byte color, byte *stencil)
dword	Round_div (dword numerator, dword divisor)
word	Count_used_colors (dword *usage)
	Count used palette indexes in the whole picture Return the total number of different colors Fill in "usage" with the count for each color. More...
word	Count_used_colors_area (dword *usage, word start_x, word start_y, word width, word height)
	Same as Count_used_colors, but for a given rectangle in the picture only. More...
word	Count_used_colors_screen_area (dword *usage, word start_x, word start_y, word width, word height)
	Same as Count_used_colors, but use a block screen memory instead of picture data. More...
void	Pixel_in_brush (word x, word y, byte color)
byte	Read_pixel_from_spare_screen (word x, word y)
byte	Read_pixel_from_backup_screen (word x, word y)
byte	Read_pixel_from_feedback_screen (word x, word y)
byte	Read_pixel_from_brush (word x, word y)
void	Init_chrono (dword delay)
void	Check_timer (void)
void	Replace_colors_within_limits (byte *replace_table)
byte	Effect_interpolated_colorize (word x, word y, byte color)
byte	Effect_additive_colorize (word x, word y, byte color)
byte	Effect_substractive_colorize (word x, word y, byte color)
byte	Effect_alpha_colorize (word x, word y, byte color)
byte	Effect_sieve (word x, word y)
void	Flip_Y_lowlevel (byte *src, short width, short height)
	Inverts a pixel buffer, according to a horizontal axis. More...
void	Flip_X_lowlevel (byte *src, short width, short height)
	Inverts a pixel buffer, according to a vertical axis. More...
void	Rotate_90_deg_lowlevel (byte *source, byte *dest, short width, short height)
	Rotate a pixel buffer by 90 degrees, clockwise. More...
void	Rotate_270_deg_lowlevel (byte *source, byte *dest, short width, short height)
	Rotate a pixel buffer by 90 degrees, counter-clockwise. More...
void	Rotate_180_deg_lowlevel (byte *src, short width, short height)
	Rotate a pixel buffer by 180 degrees. More...
void	Rescale (byte *src_buffer, short src_width, short src_height, byte *dst_buffer, short dst_width, short dst_height, short x_flipped, short y_flipped)
	Copies an image to another, rescaling it and optionally flipping it. More...
void	Zoom_a_line (byte *original_line, byte *zoomed_line, word factor, word width)
void	Copy_part_of_image_to_another (byte *source, word source_x, word source_y, word width, word height, word source_width, byte *dest, word dest_x, word dest_y, word destination_width)
short	Round (float value)
short	Round_div_max (short numerator, short divisor)
double	Fround (double n, unsigned d)
int	Min (int a, int b)
int	Max (int a, int b)
const char *	Mode_label (int mode)
int	Convert_videomode_arg (const char *argument)

Variables
GFX2_GLOBAL byte	Timer_state
GFX2_GLOBAL dword	Timer_delay
GFX2_GLOBAL dword	Timer_start

Detailed Description

Miscellanous unsorted functions.

Macro Definition Documentation

SWAP_BYTES

#define SWAP_BYTES	(		a,
			b
	)		{ byte c=a; a=b; b=c;}

SWAP_WORDS

#define SWAP_WORDS	(		a,
			b
	)		{ word c=a; a=b; b=c;}

SWAP_DWORDS

#define SWAP_DWORDS	(		a,
			b
	)		{ dword c=a; a=b; b=c;}

SWAP_SHORTS

#define SWAP_SHORTS	(		a,
			b
	)		{ short c=a; a=b; b=c;}

SWAP_FLOATS

#define SWAP_FLOATS	(		a,
			b
	)		{ float c=a; a=b; b=c;}

SWAP_PBYTES

#define SWAP_PBYTES	(		a,
			b
	)		{ byte * c=a; a=b; b=c;}

Num2str

#define Num2str	(		a,
			b,
			c
	)		snprintf(b,sizeof(b),"%*lu",(int)c,(unsigned long)(a))

Dec2str

#define Dec2str	(		a,
			b,
			c
	)		sprintf(b,"%.*f",c,(double)(a))

Function Documentation

Copy_image_to_brush()

void Copy_image_to_brush	(	short	start_x,
		short	start_y,
		short	Brush_width,
		short	Brush_height,
		word	image_width
	)

References T_Document::backups, Brush_height, Brush_original_pixels, Brush_width, T_Document::current_layer, T_Page::Image, Main, T_List_of_pages::Pages, and T_Image::Pixels.

Referenced by Capture_brush().

Remap_general_lowlevel()

void Remap_general_lowlevel	(	byte *	conversion_table,
		byte *	in_buffer,
		byte *	out_buffer,
		short	width,
		short	height,
		short	buffer_width
	)

Referenced by Button_Brush_FX(), Button_Text(), Distort_brush(), Main_handler(), Remap_brush(), Remap_image_highlevel(), Remap_spare(), Render_text_SFont(), Render_text_TTF(), Restore_brush(), Rotate_90_deg(), Rotate_brush(), and Stretch_brush().

Scroll_picture()

void Scroll_picture	(	byte *	main_src,
		byte *	main_dest,
		short	x_offset,
		short	y_offset
	)

References T_Document::image_height, T_Document::image_width, Main, and Update_rect().

Referenced by Scroll_0_5(), and Scroll_12_5().

Wait_end_of_click()

void Wait_end_of_click

(

void

)

References Get_input(), and Mouse_K.

Referenced by Button_Airbrush_menu(), Button_Gradients(), Button_Layer_menu(), Button_Load_or_Save(), Button_Message_initial(), Button_Palette(), Button_Resolution(), Centered_lines_12_7(), Curve_4_points_2_9(), Curve_finalize(), Distort_brush_1_0(), Fill_1_0(), Fill_2_0(), Filled_polyform_12_8(), Grad_circle_12_8(), Grad_ellipse_12_8(), Grad_rectangle_0_9(), K_line_12_7(), Magnifier_12_0(), Menu_shade(), Menu_tag_colors(), Polyfill_12_9(), Polyform_12_8(), Polygon_12_9(), Readline_ex_unicode(), Replace_1_0(), Replace_2_0(), Return_to_draw_mode(), Rotate_brush_12_0(), Select_button(), Stretch_brush_12_0(), and Window_help().

Set_color()

void Set_color	(	byte	color,
		byte	red,
		byte	green,
		byte	blue
	)

References Current_palette, and GFX2_SetPalette().

Referenced by Button_Skins().

Get_current_palette()

const T_Components * Get_current_palette

(

void

)

References Current_palette.

Referenced by Error_function().

Set_palette()

void Set_palette

(

T_Palette

palette

)

References Current_palette, GFX2_SetPalette(), and Round_palette_component().

Referenced by Button_Constraint_menu(), Button_Gradients(), Button_Kill(), Button_Load_or_Save(), Button_Page(), Button_Palette(), Button_Redo(), Button_Secondary_palette(), Button_Skins(), Button_Undo(), Error_function(), Get_colors_from_brush(), Init_mode_video(), Load_image(), Load_picture(), Main_handler(), Open_window(), Save_picture(), and Spread_colors().

Clear_current_image()

void Clear_current_image

(

byte

color

)

References T_Document::backups, T_Document::current_layer, T_Page::Image, T_Document::image_height, T_Document::image_width, Main, T_List_of_pages::Pages, and T_Image::Pixels.

Referenced by Button_Clear(), and Button_Clear_with_backcolor().

Clear_current_image_with_stencil()

void Clear_current_image_with_stencil	(	byte	color,
		byte *	stencil
	)

References T_Document::backups, T_Document::current_layer, T_Page::Image, T_Document::image_height, T_Document::image_width, Main, T_List_of_pages::Pages, and T_Image::Pixels.

Referenced by Button_Clear(), and Button_Clear_with_backcolor().

Round_div()

dword Round_div	(	dword	numerator,
		dword	divisor
	)

Referenced by Curve_4_points_0_5(), Effect_smooth(), and Reduce_palette().

Count_used_colors()

word Count_used_colors

(

dword *

usage

)

Count used palette indexes in the whole picture Return the total number of different colors Fill in "usage" with the count for each color.

References T_Document::backups, T_Page::Image, T_Document::image_height, T_Document::image_width, Main, T_Page::Nb_layers, T_List_of_pages::Pages, and T_Image::Pixels.

Referenced by Button_Stats(), Convert_to_dhgr(), Convert_to_hgr(), Find_recog(), Get_colors_from_brush(), Load_image(), Save_CEL(), Save_KCF(), and Update_color_count().

Count_used_colors_area()

word Count_used_colors_area	(	dword *	usage,
		word	start_x,
		word	start_y,
		word	width,
		word	height
	)

Same as Count_used_colors, but for a given rectangle in the picture only.

Used bu the C64 block constraint checker.

References T_Document::image_width, Main, and Main_screen.

Count_used_colors_screen_area()

word Count_used_colors_screen_area	(	dword *	usage,
		word	start_x,
		word	start_y,
		word	width,
		word	height
	)

Same as Count_used_colors, but use a block screen memory instead of picture data.

Used to count colors in the loading screen.

References Get_Screen_pixel().

Pixel_in_brush()

void Pixel_in_brush	(	word	x,
		word	y,
		byte	color
	)

References Brush, and Brush_width.

Referenced by Capture_brush_with_lasso(), Nibble_brush(), Outline_brush(), and Pixel_figure_in_brush().

Read_pixel_from_spare_screen()

byte Read_pixel_from_spare_screen	(	word	x,
		word	y
	)

References T_Document::backups, T_Document::current_layer, T_Page::Image, T_Bitmap::Image, T_Document::image_height, T_Page::Image_mode, IMAGE_MODE_ANIMATION, T_Document::image_width, T_List_of_pages::Pages, T_Image::Pixels, Spare, T_Page::Transparent_color, and T_Document::visible_image.

Referenced by Display_pixel(), and Draw_paintbrush().

Read_pixel_from_backup_screen()

byte Read_pixel_from_backup_screen	(	word	x,
		word	y
	)

References T_Document::image_width, Main, and Screen_backup.

Read_pixel_from_feedback_screen()

byte Read_pixel_from_feedback_screen	(	word	x,
		word	y
	)

References FX_feedback_screen, T_Document::image_width, and Main.

Referenced by Effect_additive_colorize(), Effect_alpha_colorize(), Effect_interpolated_colorize(), Effect_layer_copy(), Effect_quick_shade(), Effect_shade(), Effect_smooth(), and Effect_substractive_colorize().

Read_pixel_from_brush()

byte Read_pixel_from_brush	(	word	x,
		word	y
	)

References Brush, and Brush_width.

Referenced by Button_Sieve_menu(), Capture_brush_with_lasso(), Draw_paintbrush(), Effect_tiling(), and Stretch_brush_preview().

Init_chrono()

void Init_chrono

(

dword

delay

)

References GFX2_GetTicks(), Timer_delay, and Timer_start.

Referenced by Button_Load_or_Save().

Check_timer()

void Check_timer

(

void

)

References GFX2_GetTicks(), Timer_delay, Timer_start, and Timer_state.

Referenced by Button_Load_or_Save().

Replace_colors_within_limits()

void Replace_colors_within_limits

(

byte *

replace_table

)

References T_Document::backups, T_Document::current_layer, T_Page::Image, T_Document::image_width, Limit_bottom, Limit_left, Limit_right, Limit_top, Main, T_List_of_pages::Pages, and T_Image::Pixels.

Referenced by Fill_general().

Effect_interpolated_colorize()

byte Effect_interpolated_colorize	(	word	x,
		word	y,
		byte	color
	)

References Best_color(), Factors_inv_table, Factors_table, Main, T_Document::palette, and Read_pixel_from_feedback_screen().

Referenced by Button_Colorize_mode(), and Transparency_set().

Effect_additive_colorize()

byte Effect_additive_colorize	(	word	x,
		word	y,
		byte	color
	)

References Best_color(), Main, T_Document::palette, and Read_pixel_from_feedback_screen().

Referenced by Button_Colorize_mode(), and Transparency_set().

Effect_substractive_colorize()

byte Effect_substractive_colorize	(	word	x,
		word	y,
		byte	color
	)

References Best_color(), Main, T_Document::palette, and Read_pixel_from_feedback_screen().

Referenced by Button_Colorize_mode(), and Transparency_set().

Effect_alpha_colorize()

byte Effect_alpha_colorize	(	word	x,
		word	y,
		byte	color
	)

References Best_color(), Fore_color, Main, T_Document::palette, and Read_pixel_from_feedback_screen().

Referenced by Button_Colorize_mode(), Button_Text(), and Transparency_set().

Effect_sieve()

byte Effect_sieve	(	word	x,
		word	y
	)

References Sieve, Sieve_height, and Sieve_width.

Referenced by Display_pixel().

Flip_Y_lowlevel()

void Flip_Y_lowlevel	(	byte *	src,
		short	width,
		short	height
	)

Inverts a pixel buffer, according to a horizontal axis.

Parameters

src	Pointer to the pixel buffer to process.
width	Width of the buffer.
height	Height of the buffer.

Referenced by Button_Brush_FX(), Button_Transform_menu(), Main_handler(), and Rotate_180_deg_lowlevel().

Flip_X_lowlevel()

void Flip_X_lowlevel	(	byte *	src,
		short	width,
		short	height
	)

Inverts a pixel buffer, according to a vertical axis.

Parameters

src	Pointer to the pixel buffer to process.
width	Width of the buffer.
height	Height of the buffer.

Referenced by Button_Brush_FX(), Button_Transform_menu(), Main_handler(), and Rotate_180_deg_lowlevel().

Rotate_90_deg_lowlevel()

void Rotate_90_deg_lowlevel	(	byte *	source,
		byte *	dest,
		short	width,
		short	height
	)

Rotate a pixel buffer by 90 degrees, clockwise.

Parameters

source	Source pixel buffer.
dest	Destination pixel buffer.
width	Width of the original buffer (height of the destination one).
height	Height of the original buffer (width of the destination one).

Referenced by Button_Transform_menu(), and Rotate_90_deg().

Rotate_270_deg_lowlevel()

void Rotate_270_deg_lowlevel	(	byte *	source,
		byte *	dest,
		short	width,
		short	height
	)

Rotate a pixel buffer by 90 degrees, counter-clockwise.

Parameters

source	Source pixel buffer.
dest	Destination pixel buffer.
width	Width of the original buffer (height of the destination one).
height	Height of the original buffer (width of the destination one).

Referenced by Button_Transform_menu().

Rotate_180_deg_lowlevel()

void Rotate_180_deg_lowlevel	(	byte *	src,
		short	width,
		short	height
	)

Rotate a pixel buffer by 180 degrees.

Parameters

src	The pixel buffer (source and destination).
width	Width of the buffer.
height	Height of the buffer.

References Flip_X_lowlevel(), and Flip_Y_lowlevel().

Referenced by Button_Brush_FX(), Button_Transform_menu(), and Main_handler().

Rescale()

void Rescale	(	byte *	src_buffer,
		short	src_width,
		short	src_height,
		byte *	dst_buffer,
		short	dst_width,
		short	dst_height,
		short	x_flipped,
		short	y_flipped
	)

Copies an image to another, rescaling it and optionally flipping it.

Parameters

src_buffer	Original image (address of first byte)
src_width	Original image's width in pixels
src_height	Original image's height in pixels
dst_buffer	Destination image (address of first byte)
dst_width	Destination image's width in pixels
dst_height	Destination image's height in pixels
x_flipped	Boolean, true to flip the image horizontally
y_flipped	Boolean, true to flip the image vertically

Referenced by Button_Transform_menu(), Store_brush(), and Stretch_brush().

Zoom_a_line()

void Zoom_a_line	(	byte *	original_line,
		byte *	zoomed_line,
		word	factor,
		word	width
	)

Referenced by Clear_brush_scaled_double(), Clear_brush_scaled_quad(), Clear_brush_scaled_simple(), Clear_brush_scaled_tall(), Clear_brush_scaled_tall2(), Clear_brush_scaled_tall3(), Clear_brush_scaled_triple(), Clear_brush_scaled_wide(), Clear_brush_scaled_wide2(), Display_brush_color_zoom_double(), Display_brush_color_zoom_quad(), Display_brush_color_zoom_simple(), Display_brush_color_zoom_tall(), Display_brush_color_zoom_tall2(), Display_brush_color_zoom_tall3(), Display_brush_color_zoom_triple(), Display_brush_color_zoom_wide(), Display_brush_color_zoom_wide2(), Display_brush_mono_zoom_double(), Display_brush_mono_zoom_quad(), Display_brush_mono_zoom_simple(), Display_brush_mono_zoom_tall(), Display_brush_mono_zoom_tall2(), Display_brush_mono_zoom_tall3(), Display_brush_mono_zoom_triple(), Display_brush_mono_zoom_wide(), Display_brush_mono_zoom_wide2(), Display_part_of_screen_scaled_double(), Display_part_of_screen_scaled_quad(), Display_part_of_screen_scaled_simple(), Display_part_of_screen_scaled_tall(), Display_part_of_screen_scaled_tall2(), Display_part_of_screen_scaled_tall3(), Display_part_of_screen_scaled_triple(), Display_part_of_screen_scaled_wide(), and Display_part_of_screen_scaled_wide2().

Copy_part_of_image_to_another()

void Copy_part_of_image_to_another	(	byte *	source,
		word	source_x,
		word	source_y,
		word	width,
		word	height,
		word	source_width,
		byte *	dest,
		word	dest_x,
		word	dest_y,
		word	destination_width
	)

Referenced by Copy_image_only(), Draw_paintbrush(), Fill_general(), Nibble_brush(), Outline_brush(), Resize_image(), and Store_brush().

Round()

short Round

(

float

value

)

Referenced by Compute_3_point_curve(), Compute_quad_texture(), Compute_separator_data(), Distance(), Draw_curve_general(), Draw_quad_texture_preview(), and Transform_point().

Round_div_max()

short Round_div_max	(	short	numerator,
		short	divisor
	)

Referenced by Pre_load().

Fround()

double Fround	(	double	n,
		unsigned	d
	)

Referenced by Readline_ex_unicode().

Min()

int Min	(	int	a,
		int	b
	)

Referenced by Button_Text(), Compute_quad_texture(), Copy_image_only(), Display_paintbrush_in_window(), Draw_curve_general(), Draw_preset_sieve_patterns(), Draw_quad_texture_preview(), Draw_xor_rect(), Fill(), Fill_general(), Flush_update(), Init_mode_video(), Layer_preview_on(), Resize_image(), Rotate_brush(), Rotate_brush_preview(), Store_paintbrush(), Stretch_brush_preview(), Update_part_of_screen(), and Window_redraw_list().

Max()

int Max	(	int	a,
		int	b
	)

Referenced by Button_Paintbrush_menu(), Confirmation_box(), Display_cursor(), Distort_brush(), Draw_curve_general(), Draw_quad_texture_preview(), Fill_general(), Hide_cursor(), Init_mode_video(), Rotate_brush(), Rotate_brush_preview(), and Stretch_brush_preview().

Mode_label()

const char * Mode_label

(

int

mode

)

References mode, and Video_mode.

Referenced by Convert_videomode_arg(), Display_syntax(), and Save_INI().

Convert_videomode_arg()

int Convert_videomode_arg

(

const char *

argument

)

References Mode_label(), Nb_video_modes, and Video_mode.

Referenced by Init_program(), and Load_INI().

Variable Documentation

Timer_state

GFX2_GLOBAL byte Timer_state

Referenced by Button_Load_or_Save(), and Check_timer().

Timer_delay

GFX2_GLOBAL dword Timer_delay

Referenced by Check_timer(), and Init_chrono().

Timer_start

GFX2_GLOBAL dword Timer_start

Referenced by Check_timer(), and Init_chrono().