Documentazione Imel

Davide F. Merico

<hds619@gmail.com>

Copyright © 2009, 2010 Davide F. Merico

      Permission is granted to copy, distribute and/or modify this document
      under the terms of the GNU Free Documentation License, Version 1.3
      or any later version published by the Free Software Foundation;
      with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
      A copy of the license is included in the section entitled "GNU
      Free Documentation License".

Sommario

1. Introduzione

1.1. Cos'è Imel
1.2. Installare Imel
1.3. Usare Imel
1.4. Logica di Imel

2. Variabili, Tipi, Macro, Define, Enumeratori e Strutture

2.1. Variabili Globali

2.1.1. Generatore di numeri pseudocasuali

2.2. Tipi

2.2.1. Valori booleani
2.2.2. Dimensione immagini
2.2.3. Valori dei colori
2.2.4. Identificazione Pseudo-Livelli

2.3. Macro

2.3.1. Conversione da Gradi a Radianti e da Radianti a Gradi
2.3.2. Recupero valori dei singoli canali da variabile RGBA
2.3.3. Ritorno da funzioni in caso di condizioni fallite

2.4. Define Generali

2.4.1. Versione di Imel

2.5. Define degli Errori

2.5.1. Errori di Caricamento
2.5.2. Errori di Salvataggio

2.6. Enumeratori

2.6.1. Enumeratori riguardo l'apertura delle immagini
2.6.2. Enumeratori riguardo il salvataggio delle immagini
2.6.3. Enumeratori Generici

2.7. Strutture

2.7.1. ImelPixel
2.7.2. ImelImage
2.7.3. ImelPoint
2.7.4. ImelError

3. Funzioni per aprire un'immagine

3.1. Struttura delle funzioni per aprire un'immagine

3.2. Formati supportati in lettura

3.3. Funzioni per aprire le immagini

3.3.1. imel_image_new_from_format ()
3.3.2. imel_image_new_from_format_handle ()
3.3.3. imel_image_new_from_format_memory ()
3.3.4. imel_image_new_from_imel ()
3.3.5. imel_image_new_from_imel_handle ()
3.3.6. imel_image_new_from_raw ()

4. Funzioni per la manipolazione delle immagini

4.1. imel_image_apply_color ()
4.2. imel_image_apply_color_from_string ()
4.3. imel_image_apply_convolution ()
4.4. imel_image_apply_effect ()
4.5. imel_image_apply_filter ()
4.6. imel_image_apply_logic_operation ()
4.7. imel_image_apply_noise ()
4.8. imel_image_apply_pattern ()
4.9. imel_image_auto_cut ()
4.10. imel_image_change_color_level ()
4.11. imel_image_change_level ()
4.12. imel_image_copy ()
4.13. imel_image_cut ()
4.14. imel_image_free ()
4.15. imel_image_get_height ()
4.16. imel_image_get_histogram ()
4.17. imel_image_get_histogram_image ()
4.18. imel_image_get_histograms_image ()
4.19. imel_image_get_width ()
4.20. imel_image_insert_image ()
4.21. imel_image_mirror_horizontal ()
4.22. imel_image_mirror_vertical ()
4.23. imel_image_new ()
4.24. imel_image_new_with_background_color ()
4.25. imel_image_perspective ()
4.26. imel_image_remove_base_color ()
4.27. imel_image_remove_noise ()
4.28. imel_image_replace_area_color ()
4.29. imel_image_replace_color ()
4.30. imel_image_resize ()
4.31. imel_image_rotate ()
4.32. imel_image_rotate_complete ()
4.33. imel_image_rotate_to_left ()
4.34. imel_image_rotate_to_right ()
4.35. imel_image_shear ()
4.36. imel_image_shift ()
4.37. imel_image_shift_bpc ()
4.38. imel_image_shift_lines ()
4.39. imel_image_union ()

5. Funzioni per riempire un'area delle immagini

5.1. imel_image_fill_color_with_color ()
5.2. imel_image_fill_color_with_level ()
5.3. imel_image_fill_level_with_color ()
5.4. imel_image_fill_level_with_level ()

6. Funzioni per salvare un'immagine

6.1. imel_image_save_bmp ()
6.2. imel_image_save_bmp_handle ()
6.3. imel_image_save_imel ()
6.4. imel_image_save_j2k ()
6.5. imel_image_save_j2k_handle ()
6.6. imel_image_save_jp2 ()
6.7. imel_image_save_jp2_handle ()
6.8. imel_image_save_jpeg ()
6.9. imel_image_save_jpeg_handle ()
6.10. imel_image_save_png ()
6.11. imel_image_save_png_handle ()
6.12. imel_image_save_ppm ()
6.13. imel_image_save_ppm_handle ()
6.14. imel_image_save_ppmraw ()
6.15. imel_image_save_ppmraw_handle ()
6.16. imel_image_save_tiff ()
6.17. imel_image_save_tiff_handle ()
6.18. imel_image_save_wbmp ()
6.19. imel_image_save_wbmp_handle ()
6.20. imel_image_save_xpm ()
6.21. imel_image_save_xpm_handle ()

7. Funzioni relative ai colori di un'immagine

7.1. imel_color_get_from_pixel ()
7.2. imel_color_get_number ()
7.3. imel_color_set_background ()
7.4. imel_color_subtract ()
7.5. imel_color_sum ()

8. Funzioni per gestire i pixel

8.1. imel_pixel_compare ()
8.2. imel_pixel_compare_level ()
8.3. imel_pixel_copy ()
8.4. imel_pixel_get_rgba ()
8.5. imel_pixel_new ()
8.6. imel_pixel_new_from_rgba ()
8.7. imel_pixel_new_from_string ()
8.8. imel_pixel_set ()
8.9. imel_pixel_set_from_pixel ()
8.10. imel_pixel_set_from_string ()
8.11. imel_pixel_union ()

9. Funzioni per disegnare

9.1. imel_draw_arch ()
9.2. imel_draw_circle ()
9.3. imel_draw_contiguous_figure ()
9.4. imel_draw_curve ()
9.5. imel_draw_dashed_grid ()
9.6. imel_draw_dashed_line ()
9.7. imel_draw_ellipse ()
9.8. imel_draw_figure ()
9.9. imel_draw_filled_arch ()
9.10. imel_draw_filled_ellipse ()
9.11. imel_draw_filled_circle ()
9.12. imel_draw_filled_line ()
9.13. imel_draw_gradient ()
9.14. imel_draw_gradient_curve ()
9.15. imel_draw_gradient_line ()
9.16. imel_draw_grid ()
9.17. imel_draw_line ()
9.18. imel_draw_line_connecting_al_points ()
9.19. imel_draw_partial_reg_shape ()
9.20. imel_draw_point ()
9.21. imel_draw_point_from_array ()
9.22. imel_draw_rect ()
9.23. imel_draw_rect_with_rounded_angles ()
9.24. imel_draw_reg_shape ()
9.25. imel_draw_spiral ()

10. Funzioni per la gestione di punti all'interno dell'immagine

10.1. imel_point_array_free ()
10.2. imel_point_free ()
10.3. imel_point_get_from_line ()
10.4. imel_point_get_from_reg_shape ()
10.5. imel_point_get_point_from_image ()
10.6. imel_point_new ()

11. Funzioni per la scrittura all'interno dell'immagine

11.1. imel_font_write_string ()
11.2. imel_font_write_string_with_truetype_font ()
11.3. imel_font_write_vstring ()
11.4. imel_font_write_vstring_with_truetype_font ()

12. Funzioni per la conversione tra valori differenti

12.1. imel_value_convert ()
12.2. imel_value_percentage_to_generic ()
12.3. imel_value_pixel_to_percentage ()

13. Funzioni generiche

13.1. imel_enable_brush ()
13.2. imel_disable_brush ()

14. GNU Free Documentation License

Lista delle Tabelle
2-1. Errori di Caricamento
2-2. Errori di Salvataggio
3-1. Formati supportati in lettura

Lista delle Figure
4-1. Immagini di esempio del funzionamento di imel_image_apply_color ()
4-2. Immagini di esempio del funzionamento di imel_image_apply_pattern ()
4-3. Immagini di esempio del funzionamento di imel_image_auto_cut ()
4-4. Immagini di esempio del funzionamento di imel_image_get_histogram_image ()
4-5. Immagini di esempio del funzionamento di imel_image_get_histograms_image ()
4-6. Immagini di esempio del funzionamento di imel_image_perspective ()
4-7. Immagini di esempio del funzionamento di imel_image_remove_noise ()
4-8. Immagini di esempio del funzionamento di imel_image_replace_area_color ()
4-9. Immagini di esempio del funzionamento di imel_image_shear ()
9-1. Risultato del programma precedente riguardo la funzione imel_draw_curve ()
9-2. Risultato del programma precedente riguardo la funzione imel_draw_figure ()

Lista degli Esempi
1-1. Esempio di compilazione su sistemi a 64 bit
4-1. Applicazione di un colore ad un'immagine
4-2. Applicazione di un pattern all'immagine
4-3. Autoritaglio immagine
4-4. Esempio di creazione dell'istogramma del colore rosso
4-5. Esempio di inclinazione di un'immagine
4-6. Esempio di rimozione del rumore
4-7. Esempio di sostituzione di un colore in una determinata area
9-1. Disegno di una quadrato tramite imel_draw_contiguous_figure ()
9-2. Esempio di disegno di una curva con i punti di riferimento
9-3. Esempio di funzionamento di imel_draw_figure ()
12-1. Esempio da percentuale a valore generico

		Avanti
		Introduzione