====== Tout ce qu'il faut savoir pour créer des compléments aux manuels Sésamath ======
===== Image de l'énoncé de l'exercice =====

==== Trouver et insérer l'image de fond ====

Dans l'exemple des cahiers, il faut se rendre d'abord sur le site des manuels et des cahiers : http://manuel.sesamath.net/
Puis cliquer par exemple sur le cahier numérique 5e : http://mep-outils.sesamath.net/manuel_numerique/index.php?ouvrage=cm5_2010&page_gauche=0
On choisit l'exercice dans le chapitre correspondant et pou pouvoir récupérer facilement l'adresse de l'image, il faut l'avoir en mode diaporama (en cliquant dessus), ce qui ouvre une fenêtre avec juste l'exercice choisi dedans. Par exemple, http://mep-outils.sesamath.net/manuel_numerique/diapo.php?atome=28212&ordre=1
Ensuite on fait un clic droit sur l'image de l'exercice, puis "copier l'adresse de l'image" qu'il suffira ensuite de coller :

   * soit directement dans le script, comme dans l'exemple suivant :
<code XML><action id="1" url="http://www.devsesamath.net/zoneur/vign/cm5_2010/28336-1.gif" mouvement="chargement" objet="image" /></code>
   * soit en utilisant le bouton "chargement de l'image" et en collant l'adresse dans la boîte de dialogue qui s'ouvre.

==== Positionner l'image de fond ====

Le positionnement peut se faire à la souris, en bougeant l'image de fond, ou directement dans le script :
<code XML><action abscisse="0" ordonnee="60" id="1" mouvement="translation" objet="image" /></code>
Si on laisse en l'état, au moment de lire l'animation on verra le déplacement de l'image.
Si on veut avoir l'impression que l'image est placée au bon endroit, il suffit d'accélérer fortement ce déplacement avec ''vitesse="1000"'' ce qui donne :
<code XML><action abscisse="0" ordonnee="60" id="1" mouvement="translation" objet="image" vitesse="1000" /></code>
(A noter que l'image est repérée par son numéro de ''id'', ici c'est ''id="1"'' puisque c'était ''id="1"'' au moment du chargement)

Si on veut que l'image se place à une certaine position dès le chargement, on peut insérer les coordonnées voulues dans le script. Par exemple, on ajoute des attributs ''abscisse'' et ''ordonnee'' dans le script de chargement vu plus haut :

<code XML><action id="1" url="http://www.devsesamath.net/zoneur/vign/cm5_2010/28336-1.gif" 
                  mouvement="chargement" objet="image" abscisse="0" ordonnee="60" /></code>

==== Traitements spéciaux ====

   * Parfois on voudrait n'avoir que le milieu de l'image par exemple (verticalement). Il est possible pour cela de monter l'image avec une partie en dehors de l'écran. L'ordonnée de l'image sera alors négative.
On peut aussi être amené à déplacer l'image en cours d'animation : dans ces cas-là, en général on évite l'accélération pour justement montrer le déplacement.
   * Parfois on voudrait réduire ou agrandir l'image (plutôt réduire car agrandir peut avoir un effet néfaste sur la qualité de l'image).
C'est possible avec <code XML><action id="1" echelle="50" mouvement="zoom" objet="image" /></code>
Il s'agit ici d'une réduction de moitié (''échelle = "100"'' ne change rien).
   * Parfois on voudrait juste un morceau de l'image. Dans ce cas, il faut découper l'image avec un logiciel de traitement d'image, puis la réuploader sur l'interface collaborative (il y a une entrée pour ce besoin spécifique) et récupérer son adresse dans l'interface. Puis procéder comme précédemment.



=====Mise en forme des textes=====

a.Pour écrire un texte avec une police identique à celle de l'énoncé (Bitstream Vera Sans par exemple) ou autre.
Voici les instructions utiles à ajouter dans le script:

couleur="__" permet de choisir la couleur du texte ( vaste choix cf.  http://instrumenpoche.sesamath.net/IMG/xml_iep.pdf )
taille="__"    permet de choisir la taille du texte
police="_______"permet de choisir la police (qui doit être présente aussi chez le lecteur de l'animation)

exemple:
<action couleur="bleu" taille="30" police="Bitstream Vera Sans" texte="blabla...bla" id="text1" mouvement="ecrire" objet="texte" />

b. Ecrire un texte dans une zone de texte

On peut  taper un peu de code html dans les textes d'IEP, ce qui permet de souligner du texte, le mettre en italique ou en gras,
<b> texte </b>  met le texte en gras.
<i> texte </i>  met le texte en italique.
<u> texte </u> souligne le texte.
<br> dans le texte provoque un retour à la igne 

Quelques symboles particuliers :
chapeau d'angle ABC : taper £a(ABC) dans la zone texte. 
vecteur AB : taper £v(AB) dans la zone texte.
crochets AB : taper £c(AB) dans la zone texte.
fraction  a/b : taper £f(a,b) dans la zone texte.
racine carrée n : taper £r(n) dans la zone texte.

Les  lettres grecques :
Il suffit de mettre dans le texte £(nom de la lettre)£
Les versions majuscules s'obtiennent en mettant la première lettre en Majuscule : £pi£ donne £Pi£ en majuscule
exemple:   texte= "Le nombre £pi£ est compris entre 3,14 et 3,15."
Noms des lettres :
alpha - beta - chi - delta - epsilon - phi - gamma - eta - iota - phi - kappa - lambda - mu - nu
omicron - pi - theta - rho - sigma - tau - upsilon - sampi - omega - xi - psi – dzeta

Autres symboles utilisables dans un texte:
£perp£   perpendiculaire
£divise£  division
£fois£ ou  *  pour la multiplication
£inferieura£  inférieur ou égal
£environ£  environ
£appartienta£  appartient à

et autres ( cf. http://tracenpoche.sesamath.net/spip.php?article113)


b. Nommer un point
Dans la zone ouverte pour nommer un point "M" on pourra utiliser la syntaxe suivante pour avoir la police "Bitstream Vera Sans" dans la taille"30"
<font face="Bitstream Vera Sans" size="30"> M </font>

c. Règles d'écriture ou de correction le script.
Le problème est qu'on ne peut pas mettre les caractères <  " et > dans un script IEP, car c'est du xml.
Dans le script, ces caractères seront remplacés :
< par £lt£
> par £gt£
" (guillemet) par £guillemet£

Pour nom= "<font face="Bitstream Vera Sans" size="30"> M </font>"
On lira donc dans le script  :
nom="£lt£font face=£guillemet£Bitstream Vera Sans£guillemet£ size=£guillemet£30£guillemet£ £gt££ M £lt£/font£gt£