model.tex 45 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149
  1. \documentclass[a4paper,12pt]{article}
  2. \usepackage[french]{babel}
  3. \usepackage[T1]{fontenc}
  4. \usepackage[latin1]{inputenc}
  5. %\usepackage{amsmath}
  6. \author{Rémi Synave, Stefka Gueorguieva, Pascal Desbarats}
  7. \title{Manuel de la bibliothèque MODEL}
  8. \date{}
  9. \begin{document}
  10. \maketitle
  11. \section{Utilisation}
  12. Cette bibliothèque permet de gérer, ouvrir et sauver des maillages représentés par un nuage de points et un ensemble de faces. Elle contient les structures de données \texttt{vf\_model} et \texttt{vef\_model} dans lesquelles sont stockées les maillages.\\
  13. Des fonctions permettant d'initialiser un nouveau maillage, d'ouvrir un modèle et d'enregistrer dans un fichier sont accessibles à partir de cette bibliothèque. Il est également possible d'ajouter des sommets, des arêtes et des faces en fonction du type de structures de données utilisé.\\
  14. Toutes les fonctions implémentées pour une structure de données l'est pour toutes les structures de données.\\
  15. \\
  16. Pour avoir accès à ces structures de données il faut inclure le fichier d'en-tete ``model.h'' :\\
  17. \begin{verbatim}
  18. #include ``model.h''
  19. \end{verbatim}
  20. \section{Structures de données}
  21. La première structure de données est \texttt{vf\_model}. Le maillage stocké contient une liste de sommets \texttt{ve} de \texttt{vf\_vertex} et une liste de faces \texttt{fa} de (\texttt{vf\_face}. Les arêtes ne sont donc pas explicitement stockées mais peuvent être retrouvées au moyen d'une table de hachage.\\
  22. Les variables \texttt{xmin,ymin,zmin} et \texttt{xmax,ymax,zmax} permettent de stocker la bounding box générale du maillage.\\
  23. \begin{verbatim}
  24. typedef struct
  25. {
  26. vf_vertex *ve; //liste des sommets
  27. vf_face *fa; //lsite des faces
  28. int nbvertex; //nombre de sommets
  29. int nbface; //nombre de faces
  30. double xmin,ymin,zmin,xmax,ymax,zmax; //bounding box du maillage
  31. }vf_model;
  32. \end{verbatim}
  33. La structure de données \texttt{vef\_model} permet les mêmes opérations que \texttt{vf\_model}. Elle contient une liste de sommets \texttt{ve} de \texttt{vef\_vertex}, une liste d'arêtes \texttt{ed} de \texttt{vef\_edge} et une liste de faces \texttt{fa} de \texttt{vef\_face}.\\
  34. Les variables \texttt{xmin,ymin,zmin} et \texttt{xmax,ymax,zmax} permettent de stocker la bounding box générale du maillage.\\
  35. \begin{verbatim}
  36. typedef struct
  37. {
  38. vef_vertex *ve; //liste de sommets
  39. vef_edge *ed; //liste d'arêtes
  40. vef_face *fa; //liste de faces
  41. int nbvertex; //nombre de sommets
  42. int nbedge; //nombre d'arêtes
  43. int nbface; //nombre de faces
  44. double xmin,ymin,zmin,xmax,ymax,zmax; //bounding box du maillage
  45. }vef_model;
  46. \end{verbatim}
  47. \section{Fonctions}
  48. \subsection{fonctions utilisant \texttt{vf\_model}}
  49. \textbullet \texttt{void vf\_model\_init(vf\_model *m)}\\
  50. Initialisation d'un modèle avec un maillage vide.\\
  51. ~\\
  52. \underline{Paramètres et type de retour :}\\
  53. \texttt{m} : le modèle.\\
  54. \texttt{retour} : aucun.\\
  55. \textbullet \texttt{void vf\_model\_free(vf\_model *m)}\\
  56. Libération de l'espace mémoire utilisé.\\
  57. ~\\
  58. \underline{Paramètres et type de retour :}\\
  59. \texttt{m} : le modèle.\\
  60. \texttt{retour} : aucun.\\
  61. \textbullet \texttt{void vf\_model\_display(vf\_model m)}\\
  62. Affichage du nombre de sommets et du nombre de faces du modèle ainsi que la bounding box.\\
  63. ~\\
  64. \underline{Paramètres et type de retour :}\\
  65. \texttt{m} : le modèle.\\
  66. \texttt{retour} : aucun.\\
  67. \textbullet \texttt{void vf\_model\_display\_detail(vf\_model m)}\\
  68. Affichage du nombre de sommets, leurs coordonnées et leur valence et la liste des sommets adjacents.\\
  69. Affichage du nombre de faces ainsi que les trois points les définissant et leur type.\\
  70. ~\\
  71. \underline{Paramètres et type de retour :}\\
  72. \texttt{m} : le modèle.\\
  73. \texttt{retour} : aucun.\\
  74. \textbullet \texttt{void vf\_model\_update\_num\_edge(vf\_edge *e, vf\_model *m, hashtable *table)}\\
  75. Fonction pouvant etre passé en paramètre lors de la contruction de la table de hachage contenant les aretes du modèle.\\
  76. Cette fonction mettra à jour les aretes en leur attribuant un numéro unique.\\
  77. \textbf{Utilisation : }\\
  78. \begin{verbatim}
  79. ptf_func_hashtable func[1];
  80. func[0]=vf_model_update_num_edge;
  81. hashtable *table=vf_model_construction_edge_table(m,func,1);
  82. \end{verbatim}
  83. ~\\
  84. \underline{Paramètres et type de retour :}\\
  85. \texttt{e} : la \texttt{vf\_edge} qui sera mis à jour.\\
  86. \texttt{m} : le modèle.\\
  87. \texttt{table} : la table de hachage.\\
  88. \texttt{retour} : aucun.\\
  89. \textbullet \texttt{void vf\_model\_update\_length\_edge(vf\_edge *e, vf\_model *m, hashtable *table)}\\
  90. Fonction pouvant etre passé en paramètre lors de la contruction de la table de hachage contenant les aretes du modèle.\\
  91. Cette fonction mettra à jour les longueurs des aretes.\\
  92. \textbf{Utilisation : }\\
  93. \begin{verbatim}
  94. ptf_func_hashtable func[1];
  95. func[0]=vf_model_update_length_edge;
  96. hashtable *table=vf_model_construction_edge_table(m,func,1);
  97. \end{verbatim}
  98. ~\\
  99. \underline{Paramètres et type de retour :}\\
  100. \texttt{e} : la \texttt{vf\_edge} qui sera mis à jour.\\
  101. \texttt{m} : le modèle.\\
  102. \texttt{table} : la table de hachage.\\
  103. \texttt{retour} : aucun.\\
  104. \textbullet \texttt{hashtable* vf\_model\_construction\_edge\_table(vf\_model *m, ptf\_func\_hashtable *func, int nbfunc)}\\
  105. Construction de la table de hachage stockant les arete du modèle.\\
  106. ~\\
  107. \underline{Paramètres et type de retour :}\\
  108. \texttt{m} : le modèle.\\
  109. \texttt{func} : tableau de pointeur de fonction qui seront appliquées aux aretes.\\
  110. \texttt{nbfunc} : taille du tableau.\\
  111. \texttt{retour} : la table de hachage.\\
  112. \textbullet \texttt{void vf\_model\_destroy\_edge\_table(hashtable *table)}\\
  113. Destruction de la table de hachage stockant les arete du modèle.\\
  114. ~\\
  115. \underline{Paramètres et type de retour :}\\
  116. \texttt{table} : la table de hachage.\\
  117. \texttt{retour} : aucun.\\
  118. \textbullet \texttt{int vf\_model\_open\_file(char* file, vf\_model *m)}\\
  119. Ouverture d'un fichier contenant un modèle.\\
  120. Les types de fichiers reconnus sont :pgn, wrl, off, ply, vef, obj.\\
  121. ~\\
  122. \underline{Paramètres et type de retour :}\\
  123. \texttt{file} : chemin du fichier contenant le modèle.\\
  124. \texttt{m} : le modèle.\\
  125. \texttt{retour} : aucun.\\
  126. \textbullet \texttt{int vf\_model\_load\_vef(char *file, vf\_model *m)}\\
  127. Ouverture d'un fichier vef.\\
  128. ~\\
  129. \underline{Paramètres et type de retour :}\\
  130. \texttt{file} : chemin du fichier contenant le modèle.\\
  131. \texttt{m} : le modèle.\\
  132. \texttt{retour} : aucun.\\
  133. \textbullet \texttt{int vf\_model\_load\_gts(char *file, vf\_model *m)}\\
  134. Ouverture d'un fichier gts.\\
  135. ~\\
  136. \underline{Paramètres et type de retour :}\\
  137. \texttt{file} : chemin du fichier contenant le modèle.\\
  138. \texttt{m} : le modèle.\\
  139. \texttt{retour} : aucun.\\
  140. \textbullet \texttt{int vf\_model\_load\_pgn(char *file, vf\_model *m)}\\
  141. Ouverture d'un fichier pgn.\\
  142. ~\\
  143. \underline{Paramètres et type de retour :}\\
  144. \texttt{file} : chemin du fichier contenant le modèle.\\
  145. \texttt{m} : le modèle.\\
  146. \texttt{retour} : aucun.\\
  147. \textbullet \texttt{int vf\_model\_load\_off(char *file, vf\_model *m)}\\
  148. Ouverture d'un fichier off.\\
  149. ~\\
  150. \underline{Paramètres et type de retour :}\\
  151. \texttt{file} : chemin du fichier contenant le modèle.\\
  152. \texttt{m} : le modèle.\\
  153. \texttt{retour} : aucun.\\
  154. \textbullet \texttt{int vf\_model\_load\_ply(char *file, vf\_model *m)}\\
  155. Ouverture d'un fichier ply.\\
  156. ~\\
  157. \underline{Paramètres et type de retour :}\\
  158. \texttt{file} : chemin du fichier contenant le modèle.\\
  159. \texttt{m} : le modèle.\\
  160. \texttt{retour} : aucun.\\
  161. \textbullet \texttt{int vf\_model\_load\_wrl(char *file, vf\_model *m)}\\
  162. Ouverture d'un fichier wrl.\\
  163. ~\\
  164. \underline{Paramètres et type de retour :}\\
  165. \texttt{file} : chemin du fichier contenant le modèle.\\
  166. \texttt{m} : le modèle.\\
  167. \texttt{retour} : aucun.\\
  168. \textbullet \texttt{int vf\_model\_load\_obj(char *file, vf\_model *m)}\\
  169. Ouverture d'un fichier obj.\\
  170. ~\\
  171. \underline{Paramètres et type de retour :}\\
  172. \texttt{file} : chemin du fichier contenant le modèle.\\
  173. \texttt{m} : le modèle.\\
  174. \texttt{retour} : aucun.\\
  175. \textbullet \texttt{int vf\_model\_load\_tet(char *file, vf\_model *m)}\\
  176. Ouverture d'un fichier tet.\\
  177. ~\\
  178. \underline{Paramètres et type de retour :}\\
  179. \texttt{file} : chemin du fichier contenant le modèle.\\
  180. \texttt{m} : le modèle.\\
  181. \texttt{retour} : aucun.\\
  182. \textbullet \texttt{void vf\_model\_save\_file(char* file, vf\_model m)}\\
  183. Sauvegarde d'un maillage dans un fichier.\\
  184. Les types de fichiers supportés pour la sauvegarde sont : pgn, wrl, off, ply, vef, obj.\\
  185. ~\\
  186. \underline{Paramètres et type de retour :}\\
  187. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  188. \texttt{m} : le modèle.\\
  189. \texttt{retour} : aucun.\\
  190. \textbullet \texttt{int vf\_model\_save\_vef(char *file, vf\_model m)}\\
  191. Sauvegarde d'un maillage dans un fichier vef.\\
  192. ~\\
  193. \underline{Paramètres et type de retour :}\\
  194. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  195. \texttt{m} : le modèle.\\
  196. \texttt{retour} : aucun.\\
  197. \textbullet \texttt{int vf\_model\_save\_gts(char *file, vf\_model m)}\\
  198. Sauvegarde d'un maillage dans un fichier gts.\\
  199. ~\\
  200. \underline{Paramètres et type de retour :}\\
  201. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  202. \texttt{m} : le modèle.\\
  203. \texttt{retour} : aucun.\\
  204. \textbullet \texttt{int vf\_model\_save\_pgn(char *file, vf\_model m)}\\
  205. Sauvegarde d'un maillage dans un fichier pgn.\\
  206. ~\\
  207. \underline{Paramètres et type de retour :}\\
  208. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  209. \texttt{m} : le modèle.\\
  210. \texttt{retour} : aucun.\\
  211. \textbullet \texttt{int vf\_model\_save\_off(char *file, vf\_model m)}\\
  212. Sauvegarde d'un lmaillage dans un fichier off.\\
  213. ~\\
  214. \underline{Paramètres et type de retour :}\\
  215. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  216. \texttt{m} : le modèle.\\
  217. \texttt{retour} : aucun.\\
  218. \textbullet \texttt{int vf\_model\_save\_ply(char *file, vf\_model m)}\\
  219. Sauvegarde d'un maillage dans un fichier ply.\\
  220. ~\\
  221. \underline{Paramètres et type de retour :}\\
  222. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  223. \texttt{m} : le modèle.\\
  224. \texttt{retour} : aucun.\\
  225. \textbullet \texttt{int vf\_model\_save\_wrl(char *file, vf\_model m)}\\
  226. Sauvegarde d'un maillage dans un fichier wrl.\\
  227. ~\\
  228. \underline{Paramètres et type de retour :}\\
  229. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  230. \texttt{m} : le modèle.\\
  231. \texttt{retour} : aucun.\\
  232. \textbullet \texttt{int vf\_model\_save\_obj(char *file, vf\_model m)}\\
  233. Sauvegarde d'un maillage dans un fichier obj.\\
  234. ~\\
  235. \underline{Paramètres et type de retour :}\\
  236. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  237. \texttt{m} : le modèle.\\
  238. \texttt{retour} : aucun.\\
  239. \textbullet \texttt{int vf\_model\_add\_vertex(vf\_model *m, double x, double y, double z)}\\
  240. Ajout d'un sommet au maillage.\\
  241. Le tableau de \texttt{vf\_vertex} contenant les coordonnées sera agrandi, le compteur de sommet \texttt{m->nbvertex} est incrémenté automatiquement.\\
  242. Le sommet est initialisé avec les paramètres et la liste des adjacences du sommet est initialisée à NULL.\\
  243. ~\\
  244. \underline{Paramètres et type de retour :}\\
  245. \texttt{m} : le modèle.\\
  246. \texttt{x} : coordonnées en X du nouveau sommet.\\
  247. \texttt{y} : coordonnées en Y du nouveau sommet.\\
  248. \texttt{z} : coordonnées en Z du nouveau sommet.\\
  249. \texttt{retour} : aucun.\\
  250. \textbullet \texttt{int vf\_model\_search\_vertex(vf\_model m, double x, double y, double z)}\\
  251. Recherche d'un sommet dans le modèle. L'index dans le tableau des sommets est retourné. Si le sommet n'est pas trouvé, on retourne -1.\\
  252. ~\\
  253. \underline{Paramètres et type de retour :}\\
  254. \texttt{m} : le modèle.\\
  255. \texttt{x} : coordonnées en X du nouveau sommet.\\
  256. \texttt{y} : coordonnées en Y du nouveau sommet.\\
  257. \texttt{z} : coordonnées en Z du nouveau sommet.\\
  258. \texttt{retour} : aucun.\\
  259. \textbullet \texttt{int vf\_model\_remove\_vertex(vf\_model *m, int numvertex)}\\
  260. Suppression d'un sommet du modèle.\\
  261. Si le sommet est utilisé dans des faces ou polyhèdres, ces faces et polyhèdres sont d'abord supprimés.
  262. Le tableau des sommets est ensuite mis à jour en décalant tous les sommets dont l'index est supérieurs à celui supprimé et l'espace est réalloué. Toutes les faces et polyhèdres sont ensuites mises à jour pour prendre en compte le décalage d'index.\\
  263. ~\\
  264. \underline{Paramètres et type de retour :}\\
  265. \texttt{m} : le modèle.\\
  266. \texttt{numvertex} : numéro du sommet à supprimer.\\
  267. \texttt{retour} : aucun.\\
  268. \textbullet \texttt{int vf\_model\_remove\_list\_of\_vertex(vf\_model *m, int *listvertex, int sizelist)}\\
  269. Suppression d'une liste de sommet du modèle.\\
  270. Si les sommets sont utilisés dans des faces ou polyhèdres, ces faces et polyhèdres sont d'abord supprimés.
  271. Le tableau des sommets est ensuite mis à jour en décalant tous les sommets dont l'index est supérieurs à celui supprimé et l'espace est réalloué. Toutes les faces et polyhèdres sont ensuites mises à jour pour prendre en compte le décalage d'index.\\
  272. ~\\
  273. \underline{Paramètres et type de retour :}\\
  274. \texttt{m} : le modèle.\\
  275. \texttt{listvertex} : liste des numéros de sommets à supprimer.\\
  276. \texttt{sizelist} : taille de la liste.\\
  277. \texttt{retour} : aucun.\\
  278. \textbullet \texttt{int vf\_model\_add\_face(vf\_model *m, int ve1, int ve2, int ve3)}\\
  279. Ajout d'une face au maillage.\\
  280. Le tableau des faces sera agrandi automatiquement et le compteur de faces \texttt{m->nbface} sera incrémenté automatiquement. La liste des adjacences des trois sommets sera mis à jour automatiquement.\\
  281. ~\\
  282. \underline{Paramètres et type de retour :}\\
  283. \texttt{m} : le modèle.\\
  284. \texttt{ve1} : numéro du premier sommet.\\
  285. \texttt{ve2} : numéro du second sommet.\\
  286. \texttt{ve3} : numéro du troisième sommet.\\
  287. \texttt{retour} : aucun.\\
  288. \textbullet \texttt{int vf\_model\_search\_face(vf\_model m, int ve1, int ve2, int ve3)}\\
  289. Recherche d'une face dans un maillage. L'index de la face dans le tableau des faces sera renvoyé si la face est trouvée. on retournera -1 si la face n'existe pas.\\
  290. Les faces sont orientés donc la face (0,5,9) et (0,9,5) sont différentes. Si la première est trouvée, la seconde ne le sera pas. \textbf{L'ordre des sommets est donc important !}\\
  291. \textbf{Exemple : }\\
  292. liste de faces (index -> ve1 ve2 ve3):
  293. \begin{verbatim}
  294. 0 -> 0 1 2
  295. 1 -> 0 2 3
  296. 2 -> 0 3 1
  297. 3 -> 1 3 2
  298. \end{verbatim}
  299. le code
  300. \begin{verbatim}
  301. vf_model_search_face(m,0,3,1);
  302. ou
  303. vf_model_search_face(m,3,1,0);
  304. ou
  305. vf_model_search_face(m,1,0,3);
  306. \end{verbatim}
  307. retournera 2 alors que
  308. \begin{verbatim}
  309. vef_model_search_face(m,3,0,1);
  310. \end{verbatim}
  311. retournera -1\\
  312. ~\\
  313. \underline{Paramètres et type de retour :}\\
  314. \texttt{m} : le modèle.\\
  315. \texttt{ve1} : numéro du premier sommet.\\
  316. \texttt{ve2} : numéro du second sommet.\\
  317. \texttt{ve3} : numéro du troisième sommet.\\
  318. \texttt{retour} : aucun.\\
  319. \textbullet \texttt{int vf\_model\_remove\_face(vf\_model *m, int numface)}\\
  320. Suppression d'une face dans le maillage.\\
  321. Si la face est utilisée dans des polyhèdres, les polyhèdres sont d'abrod supprimés.\\
  322. Le tableau des faces sera automatiquement mis à jour en décalant les faces dont l'index est supérieur à la face à supprimer. De plus, les sommets inutilisés après la suppression de la face seront supprimés eux aussi.\\
  323. ~\\
  324. \underline{Paramètres et type de retour :}\\
  325. \texttt{m} : le modèle.\\
  326. \texttt{numface} : numéro de la face à supprimer.\\
  327. \texttt{retour} : aucun.\\
  328. \textbullet \texttt{int vf\_model\_remove\_list\_of\_face(vf\_model *m, int *listface, int sizelist)}\\
  329. Suppression d'une liste de faces dans le maillage.\\
  330. Si les faces sont utilisées dans des polyhèdres, les polyhèdres sont d'abrod supprimés.\\
  331. Le tableau des faces sera automatiquement mis à jour en décalant les faces dont l'index est supérieur à la face à supprimer. De plus, les sommets inutilisés après la suppression de la face seront supprimés eux aussi.\\
  332. ~\\
  333. \underline{Paramètres et type de retour :}\\
  334. \texttt{m} : le modèle.\\
  335. \texttt{listface} : liste de numéro de face à supprimer.\\
  336. \texttt{sizelist} : taille de la liste.\\
  337. \texttt{retour} : aucun.\\
  338. \textbullet \texttt{int vf\_model\_add\_polyhedron(vf\_model *m, int fa1, int fa2, int fa3, int fa4)}\\
  339. Ajout d'un polyhèdre au maillage.\\
  340. Le tableau des polyhèdres sera agrandi automatiquement et le compteur de polyhèdres \texttt{m->nbpolyhedron} sera incrémenté automatiquement. La liste des adjacences des quatres faces sera mis à jour automatiquement.\\
  341. ~\\
  342. \underline{Paramètres et type de retour :}\\
  343. \texttt{m} : le modèle.\\
  344. \texttt{fa1} : numéro de la première face.\\
  345. \texttt{fa2} : numéro de la seconde sommet face.\\
  346. \texttt{fa3} : numéro de la troisième sommet face.\\
  347. \texttt{fa4} : numéro de la quatrième face.\\
  348. \texttt{retour} : aucun.\\
  349. \textbullet \texttt{int vf\_model\_search\_polyhedron(vf\_model m, int fa1, int fa2, int fa3, int fa4)}\\
  350. Recherche d'un polyhèdre dans un modèle. L'index du polyhèdre dans le tableau des polyhèdres sera renvoyé si le polyhèdre est trouvé. On retournera -1 si le polyhèdre n'existe pas.\\
  351. ~\\
  352. \underline{Paramètres et type de retour :}\\
  353. \texttt{m} : le modèle.\\
  354. \texttt{fa1} : numéro de la première face.\\
  355. \texttt{fa2} : numéro de la seconde sommet face.\\
  356. \texttt{fa3} : numéro de la troisième sommet face.\\
  357. \texttt{fa4} : numéro de la quatrième face.\\
  358. \texttt{retour} : aucun.\\
  359. \textbullet \texttt{int vf\_model\_remove\_polyhedron(vf\_model *m, int numpolyhedron)}\\
  360. Suppression d'un polyhèdre dans un modèle.\\
  361. Le tableau des polyhèdres sera automatiquement mis à jour en décalant les polyhèdres dont l'index est supérieur à la face à supprimer. De plus, les sommets et faces inutilisés après la suppression du polyhèdre seront supprimés eux aussi.\\
  362. ~\\
  363. \underline{Paramètres et type de retour :}\\
  364. \texttt{m} : le modèle.\\
  365. \texttt{numpolyhedron} : numéro du polyhèdre à supprimer.\\
  366. \texttt{retour} : aucun.\\
  367. \textbullet \texttt{int vf\_model\_remove\_list\_of\_polyhedron(vf\_model *m, int *listpolyhedron, int sizelist)}\\
  368. Suppression d'une liste de polyhèdres dans le modèle.\\
  369. Le tableau des polyhdères sera automatiquement mis à jour en décalant les polyhèdres dont l'index est supérieur au polyhèdre à supprimer. De plus, les sommets et faces inutilisés après la suppression de la face seront supprimés eux aussi.\\
  370. ~\\
  371. \underline{Paramètres et type de retour :}\\
  372. \texttt{m} : le modèle.\\
  373. \texttt{listpolyhedron} : liste de numéro de polyhèdres à supprimer.\\
  374. \texttt{sizelist} : taille de la liste.\\
  375. \texttt{retour} : aucun.\\
  376. \textbullet \texttt{void vf\_model\_translate(vf\_model *m, vector3d delta)}\\
  377. Translation du maillage. La translation est défini par le vecteur3d passé en paramètre.\\
  378. La translation de tout le maillage se fait en faisant la translation du même vecteur de tous les sommets.\\
  379. ~\\
  380. \underline{Paramètres et type de retour :}\\
  381. \texttt{m} : le modèle.\\
  382. \texttt{delta} : vecteur de translation.\\
  383. \texttt{retour} : aucun.\\
  384. \textbullet \texttt{void vf\_model\_rotateX\_radian(vf\_model *m, double angle)}\\
  385. Rotation du maillage suivant l'axe X d'un angle en radian.\\
  386. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  387. ~\\
  388. \underline{Paramètres et type de retour :}\\
  389. \texttt{m} : le modèle.\\
  390. \texttt{angle} : angle de rotation en radian.\\
  391. \texttt{retour} : aucun.\\
  392. \textbullet \texttt{void vf\_model\_rotateX\_degre(vf\_model *m, double angle)}\\
  393. Rotation du maillage suivant l'axe X d'un angle en degre.\\
  394. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  395. ~\\
  396. \underline{Paramètres et type de retour :}\\
  397. \texttt{m} : le modèle.\\
  398. \texttt{angle} : angle de rotation en degré.\\
  399. \texttt{retour} : aucun.\\
  400. \textbullet \texttt{void vf\_model\_rotateX\_radian\_center(vf\_model *m, double angle, point3d centre)}\\
  401. Rotation du maillage suivant l'axe X autour du point passé en paramètre d'un angle en radian.\\
  402. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  403. ~\\
  404. \underline{Paramètres et type de retour :}\\
  405. \texttt{m} : le modèle.\\
  406. \texttt{angle} : angle de rotation en radian.\\
  407. \texttt{centre} : centre de la rotation.\\
  408. \texttt{retour} : aucun.\\
  409. \textbullet \texttt{void vf\_model\_rotateX\_degre\_center(vf\_model *m, double angle, point3d centre)}\\
  410. Rotation du maillage suivant l'axe X d'un angle en radian d'un angle en degre.\\
  411. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  412. ~\\
  413. \underline{Paramètres et type de retour :}\\
  414. \texttt{m} : le modèle.\\
  415. \texttt{angle} : angle de rotation en degré.\\
  416. \texttt{centre} : centre de la rotation.\\
  417. \texttt{retour} : aucun.\\
  418. \textbullet \texttt{void vf\_model\_rotateY\_radian(vf\_model *m, double angle)}\\
  419. Rotation du maillage suivant l'axe Y d'un angle en radian.\\
  420. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  421. ~\\
  422. \underline{Paramètres et type de retour :}\\
  423. \texttt{m} : le modèle.\\
  424. \texttt{angle} : angle de rotation en radian.\\
  425. \texttt{retour} : aucun.\\
  426. \textbullet \texttt{void vf\_model\_rotateY\_degre(vf\_model *m, double angle)}\\
  427. Rotation du maillage suivant l'axe Y d'un angle en degre.\\
  428. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  429. ~\\
  430. \underline{Paramètres et type de retour :}\\
  431. \texttt{m} : le modèle.\\
  432. \texttt{angle} : angle de rotation en degré.\\
  433. \texttt{retour} : aucun.\\
  434. \textbullet \texttt{void vf\_model\_rotateY\_radian\_center(vf\_model *m, double angle, point3d centre)}\\
  435. Rotation du maillage suivant l'axe Y autour du point passé en paramètre d'un angle en radian.\\
  436. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  437. ~\\
  438. \underline{Paramètres et type de retour :}\\
  439. \texttt{m} : le modèle.\\
  440. \texttt{angle} : angle de rotation en radian.\\
  441. \texttt{centre} : centre de la rotation.\\
  442. \texttt{retour} : aucun.\\
  443. \textbullet \texttt{void vf\_model\_rotateY\_degre\_center(vf\_model *m, double angle, point3d centre)}\\
  444. Rotation du maillage suivant l'axe Y d'un angle en radian d'un angle en degre.\\
  445. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  446. ~\\
  447. \underline{Paramètres et type de retour :}\\
  448. \texttt{m} : le modèle.\\
  449. \texttt{angle} : angle de rotation en degré.\\
  450. \texttt{centre} : centre de la rotation.\\
  451. \texttt{retour} : aucun.\\
  452. \textbullet \texttt{void vf\_model\_rotateZ\_radian(vf\_model *m, double angle)}\\
  453. Rotation du maillage suivant l'axe Z d'un angle en radian.\\
  454. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  455. ~\\
  456. \underline{Paramètres et type de retour :}\\
  457. \texttt{m} : le modèle.\\
  458. \texttt{angle} : angle de rotation en radian.\\
  459. \texttt{retour} : aucun.\\
  460. \textbullet \texttt{void vf\_model\_rotateZ\_degre(vf\_model *m, double angle)}\\
  461. Rotation du maillage suivant l'axe Z d'un angle en degre.\\
  462. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  463. ~\\
  464. \underline{Paramètres et type de retour :}\\
  465. \texttt{m} : le modèle.\\
  466. \texttt{angle} : angle de rotation en degré.\\
  467. \texttt{retour} : aucun.\\
  468. \textbullet \texttt{void vf\_model\_rotateZ\_radian\_center(vf\_model *m, double angle, point3d centre)}\\
  469. Rotation du maillage suivant l'axe Z autour du point passé en paramètre d'un angle en radian.\\
  470. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  471. ~\\
  472. \underline{Paramètres et type de retour :}\\
  473. \texttt{m} : le modèle.\\
  474. \texttt{angle} : angle de rotation en radian.\\
  475. \texttt{centre} : centre de la rotation.\\
  476. \texttt{retour} : aucun.\\
  477. \textbullet \texttt{void vf\_model\_rotateZ\_degre\_center(vf\_model *m, double angle, point3d centre)}\\
  478. Rotation du maillage suivant l'axe Z d'un angle en radian d'un angle en degre.\\
  479. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  480. ~\\
  481. \underline{Paramètres et type de retour :}\\
  482. \texttt{m} : le modèle.\\
  483. \texttt{angle} : angle de rotation en degré.\\
  484. \texttt{centre} : centre de la rotation.\\
  485. \texttt{retour} : aucun.\\
  486. \textbullet \texttt{double vf\_model\_area\_model(vf\_model *m)}\\
  487. Calcule l'aire du modèle en faisant la somme des aires des faces.\\
  488. ~\\
  489. \underline{Paramètres et type de retour :}\\
  490. \texttt{m} : le modèle.\\
  491. \texttt{retour} : surface totale du modèle.\\
  492. \subsection{fonctions utilisant \texttt{vef\_model}}
  493. \textbullet \texttt{void vef\_model\_init(vef\_model *m)}\\
  494. Initialisation d'un modèle avec un maillage vide.\\
  495. ~\\
  496. \underline{Paramètres et type de retour :}\\
  497. \texttt{m} : le modèle.\\
  498. \texttt{retour} : aucun.\\
  499. \textbullet \texttt{void vef\_model\_free(vef\_model *m)}\\
  500. Libération de l'espace mémoire utilisé.\\
  501. ~\\
  502. \underline{Paramètres et type de retour :}\\
  503. \texttt{m} : le modèle.\\
  504. \texttt{retour} : aucun.\\
  505. \textbullet \texttt{void vef\_model\_display(vef\_model m)}\\
  506. Affichage du nombre de sommets, du nombre d'arêtes et du nombre de faces du modèle ainsi que la bounding box.\\
  507. ~\\
  508. \underline{Paramètres et type de retour :}\\
  509. \texttt{m} : le modèle.\\
  510. \texttt{retour} : aucun.\\
  511. \textbullet \texttt{void vef\_model\_display\_detail(vef\_model m)}\\
  512. Affichage du nombre de sommets, leurs coordonnées et leur valence et la liste des arêtes partant de ce sommet.\\
  513. Affichage du nombre d'arêtes, des deux sommets les définissant et du nombre de faces partagées par cette arête. La lsite de ces faces est ensuite affichée.\\
  514. Affichage du nombre de faces ainsi que les trois arêtes les définissant et leur type.\\
  515. ~\\
  516. \underline{Paramètres et type de retour :}\\
  517. \texttt{m} : le modèle.\\
  518. \texttt{retour} : aucun.\\
  519. \textbullet \texttt{int vef\_model\_open\_file(char* file, vef\_model *m)}\\
  520. Ouverture d'un fichier contenant un modèle.\\
  521. Les types de fichiers reconnus sont :pgn, wrl, off, ply, vef, obj.\\
  522. ~\\
  523. \underline{Paramètres et type de retour :}\\
  524. \texttt{file} : chemin du fichier contenant le modèle.\\
  525. \texttt{m} : le modèle.\\
  526. \texttt{retour} : aucun.\\
  527. \textbullet \texttt{int vef\_model\_load\_vef(char *file, vef\_model *m)}\\
  528. Ouverture d'un fichier vef.\\
  529. ~\\
  530. \underline{Paramètres et type de retour :}\\
  531. \texttt{file} : chemin du fichier contenant le modèle.\\
  532. \texttt{m} : le modèle.\\
  533. \texttt{retour} : aucun.\\
  534. \textbullet \texttt{int vef\_model\_load\_gts(char *file, vef\_model *m)}\\
  535. Ouverture d'un fichier gts.\\
  536. ~\\
  537. \underline{Paramètres et type de retour :}\\
  538. \texttt{file} : chemin du fichier contenant le modèle.\\
  539. \texttt{m} : le modèle.\\
  540. \texttt{retour} : aucun.\\
  541. \textbullet \texttt{int vef\_model\_load\_pgn(char *file, vef\_model *m)}\\
  542. Ouverture d'un fichier pgn.\\
  543. ~\\
  544. \underline{Paramètres et type de retour :}\\
  545. \texttt{file} : chemin du fichier contenant le modèle.\\
  546. \texttt{m} : le modèle.\\
  547. \texttt{retour} : aucun.\\
  548. \textbullet \texttt{int vef\_model\_load\_off(char *file, vef\_model *m)}\\
  549. Ouverture d'un fichier off.\\
  550. ~\\
  551. \underline{Paramètres et type de retour :}\\
  552. \texttt{file} : chemin du fichier contenant le modèle.\\
  553. \texttt{m} : le modèle.\\
  554. \texttt{retour} : aucun.\\
  555. \textbullet \texttt{int vef\_model\_load\_ply(char *file, vef\_model *m)}\\
  556. Ouverture d'un fichier ply.\\
  557. ~\\
  558. \underline{Paramètres et type de retour :}\\
  559. \texttt{file} : chemin du fichier contenant le modèle.\\
  560. \texttt{m} : le modèle.\\
  561. \texttt{retour} : aucun.\\
  562. \textbullet \texttt{int vef\_model\_load\_wrl(char *file, vef\_model *m)}\\
  563. Ouverture d'un fichier wrl.\\
  564. ~\\
  565. \underline{Paramètres et type de retour :}\\
  566. \texttt{file} : chemin du fichier contenant le modèle.\\
  567. \texttt{m} : le modèle.\\
  568. \texttt{retour} : aucun.\\
  569. \textbullet \texttt{int vef\_model\_load\_obj(char *file, vef\_model *m)}\\
  570. Ouverture d'un fichier obj.\\
  571. ~\\
  572. \underline{Paramètres et type de retour :}\\
  573. \texttt{file} : chemin du fichier contenant le modèle.\\
  574. \texttt{m} : le modèle.\\
  575. \texttt{retour} : aucun.\\
  576. \textbullet \texttt{int vef\_model\_load\_tet(char *file, vef\_model *m)}\\
  577. Ouverture d'un fichier tet.\\
  578. ~\\
  579. \underline{Paramètres et type de retour :}\\
  580. \texttt{file} : chemin du fichier contenant le modèle.\\
  581. \texttt{m} : le modèle.\\
  582. \texttt{retour} : aucun.\\
  583. \textbullet \texttt{void vef\_model\_save\_file(char* file, vef\_model m)}\\
  584. Sauvegarde d'un maillage dans un fichier.\\
  585. Les types de fichiers supportés pour la sauvegarde sont : pgn, wrl, off, ply, vef, obj.\\
  586. ~\\
  587. \underline{Paramètres et type de retour :}\\
  588. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  589. \texttt{m} : le modèle.\\
  590. \texttt{retour} : aucun.\\
  591. \textbullet \texttt{int vef\_model\_save\_vef(char *file, vef\_model m)}\\
  592. Sauvegarde d'un maillage dans un fichier vef.\\
  593. ~\\
  594. \underline{Paramètres et type de retour :}\\
  595. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  596. \texttt{m} : le modèle.\\
  597. \texttt{retour} : aucun.\\
  598. \textbullet \texttt{int vef\_model\_save\_gts(char *file, vef\_model m)}\\
  599. Sauvegarde d'un maillage dans un fichier gts.\\
  600. ~\\
  601. \underline{Paramètres et type de retour :}\\
  602. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  603. \texttt{m} : le modèle.\\
  604. \texttt{retour} : aucun.\\
  605. \textbullet \texttt{int vef\_model\_save\_pgn(char *file, vef\_model m)}\\
  606. Sauvegarde d'un maillage dans un fichier pgn.\\
  607. ~\\
  608. \underline{Paramètres et type de retour :}\\
  609. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  610. \texttt{m} : le modèle.\\
  611. \texttt{retour} : aucun.\\
  612. \textbullet \texttt{int vef\_model\_save\_off(char *file, vef\_model m)}\\
  613. Sauvegarde d'un lmaillage dans un fichier off.\\
  614. ~\\
  615. \underline{Paramètres et type de retour :}\\
  616. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  617. \texttt{m} : le modèle.\\
  618. \texttt{retour} : aucun.\\
  619. \textbullet \texttt{int vef\_model\_save\_ply(char *file, vef\_model m)}\\
  620. Sauvegarde d'un maillage dans un fichier ply.\\
  621. ~\\
  622. \underline{Paramètres et type de retour :}\\
  623. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  624. \texttt{m} : le modèle.\\
  625. \texttt{retour} : aucun.\\
  626. \textbullet \texttt{int vef\_model\_save\_wrl(char *file, vef\_model m)}\\
  627. Sauvegarde d'un maillage dans un fichier wrl.\\
  628. ~\\
  629. \underline{Paramètres et type de retour :}\\
  630. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  631. \texttt{m} : le modèle.\\
  632. \texttt{retour} : aucun.\\
  633. \textbullet \texttt{int vef\_model\_save\_obj(char *file, vef\_model m)}\\
  634. Sauvegarde d'un maillage dans un fichier obj.\\
  635. ~\\
  636. \underline{Paramètres et type de retour :}\\
  637. \texttt{file} : chemin du fichier où il faut sauvegarder le modèle.\\
  638. \texttt{m} : le modèle.\\
  639. \texttt{retour} : aucun.\\
  640. \textbullet \texttt{int vef\_model\_add\_vertex(vef\_model *m, double x, double y, double z)}\\
  641. Ajout d'un sommet au maillage.\\
  642. Le tableau de \texttt{vef\_vertex} contenant les coordonnées sera agrandi, le compteur de sommet \texttt{m->nbvertex} est incrémenté automatiquement.\\
  643. Le sommet est initialisé avec les paramètres et la liste des arêtes partant de ce sommet est initialisée à NULL.\\
  644. ~\\
  645. \underline{Paramètres et type de retour :}\\
  646. \texttt{m} : le modèle.\\
  647. \texttt{x} : coordonnées en X du nouveau sommet.\\
  648. \texttt{y} : coordonnées en Y du nouveau sommet.\\
  649. \texttt{z} : coordonnées en Z du nouveau sommet.\\
  650. \texttt{retour} : aucun.\\
  651. \textbullet \texttt{int vef\_model\_search\_vertex(vef\_model m, double x, double y, double z)}\\
  652. Recherche d'un sommet dans le modèle. L'index dans le tableau des sommets est retourné. Si le sommet n'est pas trouvé, on retourne -1.\\
  653. ~\\
  654. \underline{Paramètres et type de retour :}\\
  655. \texttt{m} : le modèle.\\
  656. \texttt{x} : coordonnées en X du nouveau sommet.\\
  657. \texttt{y} : coordonnées en Y du nouveau sommet.\\
  658. \texttt{z} : coordonnées en Z du nouveau sommet.\\
  659. \texttt{retour} : aucun.\\
  660. \textbullet \texttt{int vef\_model\_remove\_vertex(vef\_model *m, int numvertex)}\\
  661. Suppression d'un sommet du modèle.\\
  662. Si le sommet est utilisé dans des aretes, des faces ou polyhèdres, ces aretes, faces et polyhèdres sont d'abord supprimés.
  663. Le tableau des sommets est ensuite mis à jour en décalant tous les sommets dont l'index est supérieur à celui supprimé et l'espace est réalloué. Toutes les arêtes sont ensuites mises à jour pour prendre en compte le décalage d'index.\\
  664. ~\\
  665. \underline{Paramètres et type de retour :}\\
  666. \texttt{m} : le modèle.\\
  667. \texttt{numvertex} : numéro du sommet à supprimer.\\
  668. \texttt{retour} : aucun.\\
  669. \textbullet \texttt{int vef\_model\_remove\_list\_of\_vertex(vef\_model *m, int *listvertex, int sizelist)}\\
  670. Suppression d'une list de sommets du modèle.\\
  671. Si les sommets sont utilisés dans des aretes, des faces ou polyhèdres, ces aretes, faces et polyhèdres sont d'abord supprimés.
  672. Le tableau des sommets est ensuite mis à jour en décalant tous les sommets dont l'index est supérieur à celui supprimé et l'espace est réalloué. Toutes les arêtes sont ensuites mises à jour pour prendre en compte le décalage d'index.\\
  673. ~\\
  674. \underline{Paramètres et type de retour :}\\
  675. \texttt{m} : le modèle.\\
  676. \texttt{listvertex} : liste de numéro de sommet à supprimer.\\
  677. \texttt{sizelist} : taille de la liste.\\
  678. \texttt{retour} : aucun.\\
  679. \textbullet \texttt{int vef\_model\_add\_edge(vef\_model *m, int ve1, int ve2, int verif)}\\
  680. Ajout d'une arête au modèle.\\
  681. Le tableau des arêtes sera agrandi automatiquement et le compteur d'arêtes \texttt{m->nbedge} sera incrméenté automatiquement.\\
  682. La liste des arêtes partagées par les deux sommets sera mis à jour.\\
  683. ~\\
  684. \underline{Paramètres et type de retour :}\\
  685. \texttt{m} : le modèle.\\
  686. \texttt{ve1} : numéro du premier sommet.\\
  687. \texttt{ve2} : numéro du second sommet.\\
  688. \texttt{verif} : passer 1 en paramètre s'il faut vérifier si l'arete existe existe, 0 s'il faut faire l'ajout sans vérification.\\
  689. \texttt{retour} : aucun.\\
  690. \textbullet \texttt{int vef\_model\_search\_edge(vef\_model m, int ve1, int ve2)}\\
  691. Recherche d'une arête dans le modèle. L'index dans le tableau des arêtes est retourné ou -1 si l'arête n'existe pas.\\
  692. L'ordre des sommets n'a pas d'importance ici donc le recherche de l'arête (0,5) ou (5,0) retournera le même résultat.\\
  693. ~\\
  694. \underline{Paramètres et type de retour :}\\
  695. \texttt{m} : le modèle.\\
  696. \texttt{ve1} : numéro du premier sommet.\\
  697. \texttt{ve2} : numéro du second sommet.\\
  698. \texttt{retour} : aucun.\\
  699. \textbullet \texttt{int vef\_model\_remove\_edge(vef\_model *m, int numedge)}\\
  700. Suppression d'une arête.\\
  701. Si l'arete est utilisée par des faces ou polyhèdres, ils sont d'abord supprimés. Ensuite les aretes sont décalés et enfin les face sont parcourus pour prendre en compte le décalage d'index des arêtes.\\
  702. ~\\
  703. \underline{Paramètres et type de retour :}\\
  704. \texttt{m} : le modèle.\\
  705. \texttt{numedge} : numéro de l'arete.\\
  706. \texttt{retour} : aucun.\\
  707. \textbullet \texttt{int vef\_model\_remove\_list\_of\_edge(vef\_model *m, int *listedge, int sizelist)}\\
  708. Suppression d'une liste d'arête.\\
  709. Si les aretes sont utilisées par des faces ou polyhèdres, ils sont d'abord supprimés. Ensuite les aretes sont décalés et enfin les face sont parcourus pour prendre en compte le décalage d'index des arêtes.\\
  710. ~\\
  711. \underline{Paramètres et type de retour :}\\
  712. \texttt{m} : le modèle.\\
  713. \texttt{listedge} : liste de numéro d'arete.\\
  714. \texttt{sizelist} : taille de la liste.\\
  715. \texttt{retour} : aucun.\\
  716. \textbullet \texttt{int vef\_model\_add\_face(vef\_model *m, int ed1, int ed2, int ed3)}\\
  717. Ajout d'une face au maillage.\\
  718. Le tableau des faces sera agrandi automatiquement et le compteur de faces \texttt{m->nbface} sera incrémenté automatiquement. La liste des adjacences des trois arêtes sera mis à jour automatiquement.\\
  719. ~\\
  720. \underline{Paramètres et type de retour :}\\
  721. \texttt{m} : le modèle.\\
  722. \texttt{ed1} : numéro de la première arete.\\
  723. \texttt{ed2} : numéro de la seconde arete.\\
  724. \texttt{ed3} : numéro de la troisieme arete.\\
  725. \texttt{retour} : aucun.\\
  726. \textbullet \texttt{int vef\_model\_search\_face(vef\_model m, int ed1, int ed2, int ed3)}\\
  727. Recherche d'une face dans un maillage. L'index de la face dans le tableau des faces sera renvoyé si la face est trouvée. on retournera -1 si la face n'existe pas.\\
  728. Les faces sont orientés donc la face (0,5,9) et (0,9,5) sont différentes. Si la première est trouvée, la seconde ne le sera pas. \textbf{L'ordre des arêtes est donc important !}\\
  729. \textbf{Exemple : }\\
  730. liste de faces (index -> ve1 ve2 ve3):
  731. \begin{verbatim}
  732. 0 -> 0 1 2
  733. 1 -> 0 2 3
  734. 2 -> 0 3 1
  735. 3 -> 1 3 2
  736. \end{verbatim}
  737. le code
  738. \begin{verbatim}
  739. vef_model_search_face(m,0,3,1);
  740. ou
  741. vef_model_search_face(m,3,1,0);
  742. ou
  743. vef_model_search_face(m,1,0,3);
  744. \end{verbatim}
  745. retournera 2 alors que
  746. \begin{verbatim}
  747. vef_model_search_face(m,3,0,1);
  748. \end{verbatim}
  749. retournera -1\\
  750. ~\\
  751. \underline{Paramètres et type de retour :}\\
  752. \texttt{m} : le modèle.\\
  753. \texttt{ed1} : numéro de la première arete.\\
  754. \texttt{ed2} : numéro de la seconde arete.\\
  755. \texttt{ed3} : numéro de la troisieme arete.\\
  756. \texttt{retour} : aucun.\\
  757. \textbullet \texttt{int vef\_model\_remove\_face(vef\_model *m, int numface)}\\
  758. Suppression d'une face dans le maillage.\\
  759. Si la face est utilisée dans des polyhèdres, les polyhèdres sont d'abrod supprimés.\\
  760. Le tableau des faces sera automatiquement mis à jour en décalant les faces dont l'index est supérieur à la face à supprimer. De plus, les sommets inutilisés après la suppression de la face seront supprimés eux aussi.\\
  761. ~\\
  762. \underline{Paramètres et type de retour :}\\
  763. \texttt{m} : le modèle.\\
  764. \texttt{numface} : numéro de la face à supprimer.\\
  765. \texttt{retour} : aucun.\\
  766. \textbullet \texttt{int vef\_model\_remove\_list\_of\_face(vef\_model *m, int *listface, int sizelist)}\\
  767. Suppression d'une liste de faces dans le maillage.\\
  768. Si les faces sont utilisées dans des polyhèdres, les polyhèdres sont d'abrod supprimés.\\
  769. Le tableau des faces sera automatiquement mis à jour en décalant les faces dont l'index est supérieur à la face à supprimer. De plus, les sommets inutilisés après la suppression de la face seront supprimés eux aussi.\\
  770. ~\\
  771. \underline{Paramètres et type de retour :}\\
  772. \texttt{m} : le modèle.\\
  773. \texttt{listface} : liste de numéro de faces à supprimer.\\
  774. \texttt{sizelist} : taille de la liste.\\
  775. \texttt{retour} : aucun.\\
  776. \textbullet \texttt{int vef\_model\_add\_polyhedron(vef\_model *m, int fa1, int fa2, int fa3, int fa4)}\\
  777. Ajout d'un polyhèdre au maillage.\\
  778. Le tableau des polyhèdres sera agrandi automatiquement et le compteur de polyhèdres \texttt{m->nbpolyhedron} sera incrémenté automatiquement. La liste des adjacences des quatres faces sera mis à jour automatiquement.\\
  779. ~\\
  780. \underline{Paramètres et type de retour :}\\
  781. \texttt{m} : le modèle.\\
  782. \texttt{fa1} : numéro de la première face.\\
  783. \texttt{fa2} : numéro de la seconde sommet face.\\
  784. \texttt{fa3} : numéro de la troisième sommet face.\\
  785. \texttt{fa4} : numéro de la quatrième face.\\
  786. \texttt{retour} : aucun.\\
  787. \textbullet \texttt{int vef\_model\_search\_polyhedron(vef\_model m, int fa1, int fa2, int fa3, int fa4)}\\
  788. Recherche d'un polyhèdre dans un modèle. L'index du polyhèdre dans le tableau des polyhèdres sera renvoyé si le polyhèdre est trouvé. On retournera -1 si le polyhèdre n'existe pas.\\
  789. ~\\
  790. \underline{Paramètres et type de retour :}\\
  791. \texttt{m} : le modèle.\\
  792. \texttt{fa1} : numéro de la première face.\\
  793. \texttt{fa2} : numéro de la seconde sommet face.\\
  794. \texttt{fa3} : numéro de la troisième sommet face.\\
  795. \texttt{fa4} : numéro de la quatrième face.\\
  796. \texttt{retour} : aucun.\\
  797. \textbullet \texttt{int vef\_model\_remove\_polyhedron(vef\_model *m, int numpolyhedron)}\\
  798. Suppression d'un polyhèdre dans un modèle.\\
  799. Le tableau des polyhèdres sera automatiquement mis à jour en décalant les polyhèdres dont l'index est supérieur à la face à supprimer. De plus, les sommets et faces inutilisés après la suppression du polyhèdre seront supprimés eux aussi.\\
  800. ~\\
  801. \underline{Paramètres et type de retour :}\\
  802. \texttt{m} : le modèle.\\
  803. \texttt{numpolyhedron} : numéro du polyhèdre à supprimer.\\
  804. \texttt{retour} : aucun.\\
  805. \textbullet \texttt{int vef\_model\_remove\_list\_of\_polyhedron(vef\_model *m, int *listpolyhedron, int sizelist)}\\
  806. Suppression d'une liste de polyhèdres dans le modèle.\\
  807. Le tableau des polyhdères sera automatiquement mis à jour en décalant les polyhèdres dont l'index est supérieur au polyhèdre à supprimer. De plus, les sommets et faces inutilisés après la suppression de la face seront supprimés eux aussi.\\
  808. ~\\
  809. \underline{Paramètres et type de retour :}\\
  810. \texttt{m} : le modèle.\\
  811. \texttt{listpolyhedron} : liste de numéro de polyhèdres à supprimer.\\
  812. \texttt{sizelist} : taille de la liste.\\
  813. \texttt{retour} : aucun.\\
  814. \textbullet \texttt{void vef\_model\_translate(vef\_model *m, vector3d delta)}\\
  815. Translation du maillage. La translation est défini par le vecteur3d passé en paramètre.\\
  816. La translation de tout le maillage se fait en faisant la translation du même vecteur de tous les sommets.\\
  817. ~\\
  818. \underline{Paramètres et type de retour :}\\
  819. \texttt{m} : le modèle.\\
  820. \texttt{delta} : vecteur de translation.\\
  821. \texttt{retour} : aucun.\\
  822. \textbullet \texttt{void vef\_model\_rotateX\_radian(vef\_model *m, double angle)}\\
  823. Rotation du maillage suivant l'axe X d'un angle en radian.\\
  824. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  825. ~\\
  826. \underline{Paramètres et type de retour :}\\
  827. \texttt{m} : le modèle.\\
  828. \texttt{angle} : angle de rotation en radian.\\
  829. \texttt{retour} : aucun.\\
  830. \textbullet \texttt{void vef\_model\_rotateX\_degre(vef\_model *m, double angle)}\\
  831. Rotation du maillage suivant l'axe X d'un angle en degre.\\
  832. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  833. ~\\
  834. \underline{Paramètres et type de retour :}\\
  835. \texttt{m} : le modèle.\\
  836. \texttt{angle} : angle de rotation en degré.\\
  837. \texttt{retour} : aucun.\\
  838. \textbullet \texttt{void vef\_model\_rotateX\_radian\_center(vef\_model *m, double angle, point3d centre)}\\
  839. Rotation du maillage suivant l'axe X autour du point passé en paramètre d'un angle en radian.\\
  840. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  841. ~\\
  842. \underline{Paramètres et type de retour :}\\
  843. \texttt{m} : le modèle.\\
  844. \texttt{angle} : angle de rotation en radian.\\
  845. \texttt{centre} : centre de la rotation.\\
  846. \texttt{retour} : aucun.\\
  847. \textbullet \texttt{void vef\_model\_rotateX\_degre\_center(vef\_model *m, double angle, point3d centre)}\\
  848. Rotation du maillage suivant l'axe X d'un angle en radian d'un angle en degre.\\
  849. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  850. ~\\
  851. \underline{Paramètres et type de retour :}\\
  852. \texttt{m} : le modèle.\\
  853. \texttt{angle} : angle de rotation en degré.\\
  854. \texttt{centre} : centre de la rotation.\\
  855. \texttt{retour} : aucun.\\
  856. \textbullet \texttt{void vef\_model\_rotateY\_radian(vef\_model *m, double angle)}\\
  857. Rotation du maillage suivant l'axe Y d'un angle en radian.\\
  858. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  859. ~\\
  860. \underline{Paramètres et type de retour :}\\
  861. \texttt{m} : le modèle.\\
  862. \texttt{angle} : angle de rotation en radian.\\
  863. \texttt{retour} : aucun.\\
  864. \textbullet \texttt{void vef\_model\_rotateY\_degre(vef\_model *m, double angle)}\\
  865. Rotation du maillage suivant l'axe Y d'un angle en degre.\\
  866. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  867. ~\\
  868. \underline{Paramètres et type de retour :}\\
  869. \texttt{m} : le modèle.\\
  870. \texttt{angle} : angle de rotation en degré.\\
  871. \texttt{retour} : aucun.\\
  872. \textbullet \texttt{void vef\_model\_rotateY\_radian\_center(vef\_model *m, double angle, point3d centre)}\\
  873. Rotation du maillage suivant l'axe Y autour du point passé en paramètre d'un angle en radian.\\
  874. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  875. ~\\
  876. \underline{Paramètres et type de retour :}\\
  877. \texttt{m} : le modèle.\\
  878. \texttt{angle} : angle de rotation en radian.\\
  879. \texttt{centre} : centre de la rotation.\\
  880. \texttt{retour} : aucun.\\
  881. \textbullet \texttt{void vef\_model\_rotateY\_degre\_center(vef\_model *m, double angle, point3d centre)}\\
  882. Rotation du maillage suivant l'axe Y d'un angle en radian d'un angle en degre.\\
  883. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  884. ~\\
  885. \underline{Paramètres et type de retour :}\\
  886. \texttt{m} : le modèle.\\
  887. \texttt{angle} : angle de rotation en degré.\\
  888. \texttt{centre} : centre de la rotation.\\
  889. \texttt{retour} : aucun.\\
  890. \textbullet \texttt{void vef\_model\_rotateZ\_radian(vef\_model *m, double angle)}\\
  891. Rotation du maillage suivant l'axe Z d'un angle en radian.\\
  892. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  893. ~\\
  894. \underline{Paramètres et type de retour :}\\
  895. \texttt{m} : le modèle.\\
  896. \texttt{angle} : angle de rotation en radian.\\
  897. \texttt{retour} : aucun.\\
  898. \textbullet \texttt{void vef\_model\_rotateZ\_degre(vef\_model *m, double angle)}\\
  899. Rotation du maillage suivant l'axe Z d'un angle en degre.\\
  900. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  901. ~\\
  902. \underline{Paramètres et type de retour :}\\
  903. \texttt{m} : le modèle.\\
  904. \texttt{angle} : angle de rotation en degré.\\
  905. \texttt{retour} : aucun.\\
  906. \textbullet \texttt{void vef\_model\_rotateZ\_radian\_center(vef\_model *m, double angle, point3d centre)}\\
  907. Rotation du maillage suivant l'axe Z autour du point passé en paramètre d'un angle en radian.\\
  908. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  909. ~\\
  910. \underline{Paramètres et type de retour :}\\
  911. \texttt{m} : le modèle.\\
  912. \texttt{angle} : angle de rotation en radian.\\
  913. \texttt{centre} : centre de la rotation.\\
  914. \texttt{retour} : aucun.\\
  915. \textbullet \texttt{void vef\_model\_rotateZ\_degre\_center(vef\_model *m, double angle, point3d centre)}\\
  916. Rotation du maillage suivant l'axe Z d'un angle en radian d'un angle en degre.\\
  917. La rotation se fait en faisant subir cette rotation à tous les sommets du maillages.\\
  918. ~\\
  919. \underline{Paramètres et type de retour :}\\
  920. \texttt{m} : le modèle.\\
  921. \texttt{angle} : angle de rotation en degré.\\
  922. \texttt{centre} : centre de la rotation.\\
  923. \texttt{retour} : aucun.\\
  924. \textbullet \texttt{double vef\_model\_area\_model(vef\_model *m)}\\
  925. Calcule l'aire du modèle en faisant la somme des aires des faces.\\
  926. ~\\
  927. \underline{Paramètres et type de retour :}\\
  928. \texttt{m} : le modèle.\\
  929. \texttt{retour} : surface totale du modèle.\\
  930. \newpage
  931. \bibliographystyle{unsrt}
  932. \bibliography{manuel}
  933. \end{document}