annoter: Créer une question demande d'annoter une image
In SARP.moodle: XML Output Functions for Easy Creation of Moodle Questions

annoter_image.moodle

R Documentation

Créer une question demande d'annoter une image

Description

Cette fonction permet de créer une question affichant une image et des champs de texte à compléter pour annoter cette image.

Usage

annoter_image.moodle( texte, titre = "Annoter la figure...",
                      f.creer_figure,
                      fichier.image,
                      legendes, 
                      x.numeros, y.numeros, 
                      numeros = if ( superposer ) rep( "", length( legendes ) )
		          else 1:length( legendes ),
                      superposer = all( !missing( x.numeros ),
                                        !missing( y.numeros ) ),
                      description.image = NULL, n.colonnes = 1,
                      commentaire.global = NA, penalite = NA, note.question = NA,
                      idnum = NA, temps, tags = NULL,
                      fichier.xml = get( "fichier.xml", envir = SARP.Moodle.env ),
                      ... )

Arguments

`texte`	L'énoncé de la question (une chaîne de caractères). Cet énoncé peut contenir n'importe quel caractère (codage en UTF-8) et n'importe quelles balises HTML.
`titre`	L'intitulé de la question, en HTML.
`f.creer_figure`	La fonction qui va construire l'image et les zones sur lesquelles déposer les éléments (voyez les détails, ci-dessous).
`fichier.image`	Le nom du fichier contenant l'image à légender. Ignoré si `f.creer_figure` est fournie.
`legendes`	Les textes à entrer dans les champs (réponses attendues)
`x.numeros`, `y.numeros`	Les coordonnées des points où placer le champ texte, sur l'image (exprimées en pixels). Si l'un, ou les deux, sont absents, les champs textes apparaîtront en-dessous de l'image. Si les deux sont présents, les champs apparaîtront sur l'image.
`numeros`	Le texte à faire apparaître avant chaque champ (typiquement, un numéro de champ)
`superposer`	Veut-on superposer les champs à l'image (`TRUE`) ou non (`FALSE`)?
`description.image`	Le texte alternatif à l'image à utiliser dans la balise HTML insérant l'image
`n.colonnes`	Si les champs sont placés sous l'image, les uns en-dessous des autres, sur combien de colonnes doivent-ils être répartis?
`commentaire.global`, `penalite`, `note.question`, `idnum`, `tags`	Options communes à toutes les questions Moodle, voyez `debut_question.moodle`.
`temps`	Le temps conseillé pour répondre à la question, en minutes.
`fichier.xml`	Le fichier correspondant au questionnaire qui contiendra cette question (par défaut, le dernier créé).
`...`	Arguments additionnels qui seront passés à `f.creer_figure`.