Code cleanup in pages.c. No functional change

git-svn-id: svn://pulkomandy.tk/GrafX2/trunk@948 416bcca6-2ee7-4201-b75f-2eb2f807beb1

pages.c

@@ -49,21 +49,6 @@ void Init_page(T_Page * page)
     page->File_directory[0]='\0';
     page->Filename[0]='\0';
     page->File_format=DEFAULT_FILEFORMAT;
-/*
-    page->X_offset=0;
-    page->Y_offset=0;
-    page->old_offset_x=0;
-    page->old_offset_y=0;
-    page->Split=0;
-    page->X_zoom=0;
-    page->Separator_proportion=INITIAL_SEPARATOR_PROPORTION;
-    page->Main_magnifier_mode=0;
-    page->Main_magnifier_factor=DEFAULT_ZOOM_FACTOR;
-    page->Main_magnifier_height=0;
-    page->Main_magnifier_width=0;
-    page->Main_magnifier_offset_X=0;
-    page->Main_magnifier_offset_Y=0;
-*/
   }
 }
 
@@ -86,35 +71,7 @@ void Download_infos_page_main(T_Page * page)
     strcpy(Main_file_directory,page->File_directory);
     strcpy(Main_filename,page->Filename);
     Main_fileformat=page->File_format;
-/*
-    Main_offset_X=page->X_offset;
-    Main_offset_Y=page->Y_offset;
 
-    // On corrige les décalages en fonction de la dimension de l'écran
-    if ( (Main_offset_X>0) &&
-         (Main_offset_X+Screen_width>Main_image_width) )
-      Main_offset_X=Max(0,Main_image_width-Screen_width);
-    if ( (Main_offset_Y>0) &&
-         (Main_offset_Y+Menu_Y>Main_image_height) )
-      Main_offset_Y=Max(0,Main_image_height-Menu_Y);
-
-    Old_main_offset_X=page->old_offset_x;
-    Old_main_offset_Y=page->old_offset_y;
-    Main_separator_position=page->Split;
-    Main_X_zoom=page->X_zoom;
-    Main_separator_proportion=page->Separator_proportion;
-    Main_magnifier_mode=page->Main_magnifier_mode;
-    Main_magnifier_factor=page->Main_magnifier_factor;
-    Main_magnifier_height=page->Main_magnifier_height;
-    Main_magnifier_width=page->Main_magnifier_width;
-    Main_magnifier_offset_X=page->Main_magnifier_offset_X;
-    Main_magnifier_offset_Y=page->Main_magnifier_offset_Y;
-
-    // Comme le facteur de zoom a des chances d'avoir changé, on appelle
-    // "Change_magnifier_factor".
-    for (factor_index=0; ZOOM_FACTOR[factor_index]!=Main_magnifier_factor; factor_index++);
-    Change_magnifier_factor(factor_index);
-*/
     if (size_is_modified)
     {
       Main_magnifier_mode=0;
@@ -140,21 +97,6 @@ void Upload_infos_page_main(T_Page * page)
     strcpy(page->File_directory,Main_file_directory);
     strcpy(page->Filename,Main_filename);
     page->File_format=Main_fileformat;
-/*
-    page->X_offset=Main_offset_X;
-    page->Y_offset=Main_offset_Y;
-    page->old_offset_x=Old_main_offset_X;
-    page->old_offset_x=Old_main_offset_Y;
-    page->Split=Main_separator_position;
-    page->X_zoom=Main_X_zoom;
-    page->Separator_proportion=Main_separator_proportion;
-    page->Main_magnifier_mode=Main_magnifier_mode;
-    page->Main_magnifier_factor=Main_magnifier_factor;
-    page->Main_magnifier_height=Main_magnifier_height;
-    page->Main_magnifier_width=Main_magnifier_width;
-    page->Main_magnifier_offset_X=Main_magnifier_offset_X;
-    page->Main_magnifier_offset_Y=Main_magnifier_offset_Y;
-*/
   }
 }
 
@@ -170,21 +112,6 @@ void Download_infos_page_spare(T_Page * page)
     strcpy(Spare_file_directory,page->File_directory);
     strcpy(Spare_filename,page->Filename);
     Spare_fileformat=page->File_format;
-/*
-    Spare_offset_X=page->X_offset;
-    Spare_offset_Y=page->Y_offset;
-    Old_spare_offset_X=page->old_offset_x;
-    Old_spare_offset_Y=page->old_offset_y;
-    Spare_separator_position=page->Split;
-    Spare_X_zoom=page->X_zoom;
-    Spare_separator_proportion=page->Separator_proportion;
-    Spare_magnifier_mode=page->Main_magnifier_mode;
-    Spare_magnifier_factor=page->Main_magnifier_factor;
-    Spare_magnifier_height=page->Main_magnifier_height;
-    Spare_magnifier_width=page->Main_magnifier_width;
-    Spare_magnifier_offset_X=page->Main_magnifier_offset_X;
-    Spare_magnifier_offset_Y=page->Main_magnifier_offset_Y;
-*/
   }
 }
 
@@ -200,21 +127,6 @@ void Upload_infos_page_spare(T_Page * page)
     strcpy(page->File_directory,Spare_file_directory);
     strcpy(page->Filename,Spare_filename);
     page->File_format=Spare_fileformat;
-/*
-    page->X_offset=Spare_offset_X;
-    page->Y_offset=Spare_offset_Y;
-    page->old_offset_x=Old_spare_offset_X;
-    page->old_offset_y=Old_spare_offset_Y;
-    page->Split=Spare_separator_position;
-    page->X_zoom=Spare_X_zoom;
-    page->Separator_proportion=Spare_separator_proportion;
-    page->Main_magnifier_mode=Spare_magnifier_mode;
-    page->Main_magnifier_factor=Spare_magnifier_factor;
-    page->Main_magnifier_height=Spare_magnifier_height;
-    page->Main_magnifier_width=Spare_magnifier_width;
-    page->Main_magnifier_offset_X=Spare_magnifier_offset_X;
-    page->Main_magnifier_offset_Y=Spare_magnifier_offset_Y;
-*/
   }
 }
 
@@ -326,14 +238,14 @@ void Backward_in_list_of_pages(T_List_of_pages * list)
 {
   // Cette fonction fait l'équivalent d'un "Undo" dans la liste de pages.
   // Elle effectue une sorte de ROL (Rotation Left) sur la liste:
-  // ÉÍËÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍ»  |
+  // +---+-+-+-+-+-+-+-+-+-+  |
-  // º0º1³2³3³4³5³6³7³8³9³Aº  |
+  // ¦0¦1¦2¦3¦4¦5¦6¦7¦8¦9¦A¦  |
-  // ÈÍÊÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏͼ  |  0=page courante
+  // +---+-+-+-+-+-+-+-+-+-+  |  0=page courante
-  //  ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³   |_ A=page la plus ancienne
+  //  ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦ ¦   |_ A=page la plus ancienne
-  //  v v v v v v v v v v v   |  1=Dernière page (1er backup)
+  //  v v v v v v v v v v v   |  1=DerniÞre page (1er backup)
-  // ÉÍËÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍ»  |
+  // +---+-+-+-+-+-+-+-+-+-+  |
-  // º1º2³3³4³5³6³7³8³9³A³0º  |
+  // ¦1¦2¦3¦4¦5¦6¦7¦8¦9¦A¦0¦  |
-  // ÈÍÊÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏͼ  |
+  // +---+-+-+-+-+-+-+-+-+-+  |
 
   // Pour simuler un véritable Undo, l'appelant doit mettre la structure
   // de page courante à jour avant l'appel, puis en réextraire les infos en
@@ -369,14 +281,14 @@ void Advance_in_list_of_pages(T_List_of_pages * list)
 {
   // Cette fonction fait l'équivalent d'un "Redo" dans la liste de pages.
   // Elle effectue une sorte de ROR (Rotation Right) sur la liste:
-  // ÉÍËÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍ»  |
+  // +-+-+-+-+-+-+-+-+-+-+-+  |
-  // º0º1³2³3³4³5³6³7³8³9³Aº  |
+  // |0|1|2|3|4|5|6|7|8|9|A|  |
-  // ÈÍÊÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏͼ  |  0=page courante
+  // +-+-+-+-+-+-+-+-+-+-+-+  |  0=page courante
-  //  ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³   |_ A=page la plus ancienne
+  //  | | | | | | | | | | |   |_ A=page la plus ancienne
   //  v v v v v v v v v v v   |  1=Dernière page (1er backup)
-  // ÉÍËÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍÑÍ»  |
+  // +-+-+-+-+-+-+-+-+-+-+-+  |
-  // ºAº0³1³2³3³4³5³6³7³8³9º  |
+  // |A|0|1|2|3|4|5|6|7|8|9|  |
-  // ÈÍÊÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏÍÏͼ  |
+  // +-+-+-+-+-+-+-+-+-+-+-+  |
 
   // Pour simuler un véritable Redo, l'appelant doit mettre la structure
   // de page courante à jour avant l'appel, puis en réextraire les infos en

pages.h

@@ -27,17 +27,19 @@
 
 
 //////////////////////////////////////////////////////////////////////////
-/////////////////////////// GESTION DU BACKUP ////////////////////////////
+/////////////////////////// BACKUP ///////////////////////////////////////
 //////////////////////////////////////////////////////////////////////////
 
 
 ///
-  /// GESTION DES PAGES
+/// INDIVIDUAL PAGES
 ///
 
-void Init_page(T_Page * page);
 void Download_infos_page_main(T_Page * page);
 void Upload_infos_page_main(T_Page * page);
+
+// private
+void Init_page(T_Page * page);
 void Download_infos_page_spare(T_Page * page);
 void Upload_infos_page_spare(T_Page * page);
 void Download_infos_backup(T_List_of_pages * list);
@@ -48,10 +50,11 @@ int Size_of_a_page(T_Page * page);
 
 
 ///
-  /// GESTION DES LISTES DE PAGES
+/// LISTS OF PAGES
 ///
 
 void Init_list_of_pages(T_List_of_pages * list);
+// private
 int Allocate_list_of_pages(T_List_of_pages * list,int size);
 void Free_a_list_of_pages(T_List_of_pages * list);
 int Size_of_a_list_of_pages(T_List_of_pages * list);
@@ -66,7 +69,7 @@ void Free_page_of_a_list(T_List_of_pages * list);
 
 
 ///
-  /// GESTION DES BACKUPS
+/// BACKUP HIGH-LEVEL FUNCTIONS
 ///
 
 int Init_all_backup_lists(int size,int width,int height);
@@ -76,18 +79,18 @@ int Backup_and_resize_the_spare(int width,int height);
 void Backup(void);
 void Undo(void);
 void Redo(void);
-void Free_current_page(void);
+void Free_current_page(void); // 'Kill' button
 void Exchange_main_and_spare(void);
 
 
 
 ///
-  /// GESTION DES EMPRUNTS DE MEMOIRE DE PAGE
+/// BORROWING MEMORY FROM PAGE
 ///
 
-int Can_borrow_memory_from_page(int size);
 void * Borrow_memory_from_page(int size);
-
+// private
+int Can_borrow_memory_from_page(int size);
 
 
 #endif