To match sound-image editor
From PatioWiki
Class diagrams
The following image shows the summarized class diagram of the manual editor of To match sound-image exercises that is part of Tareas.
1000px|Diagrama de clases del editor Emparejar Sonido-imagen manual.
In the diagram above we can see that the information of the exercise that is being edited will be stored in the "CurrentEmparejarExercise" class, that has all static fields. This class also stores the information of all image-sound pairs that the exercise has and each of them is represented by an instance of the "PairInfo" class.
The main panel is an object of class "EmparejarMainPanel" which contains three subpanels: "Image-sound pairs", "Images" and "Sounds".
The image-sound pairs panel ("leftPanel") is a "PreviewPanel" object and contains a toolbar and the panel that contains all exercise pairs ("PairsPanel"). The exercise configuration panel is an "ExerciseConfigPanel" object and it is instantiated each time the user clicks on the corresponding button located in the image-sound pairs panel toolbar.
An object of type "MultimediaResourcesFilterPanel" ("rightPanel") creates two instances of the class "MultimediaFilterPanel". Each of these instances represents a panel that filters all the available multimedia resources by type (images, sounds, videos...) and in this case are "Images" and "Sounds" panels.
Use cases
800px|Diagrama de casos de uso del editor manual de ejercicios Emparejar sonido-imagen.
Next there is a textual description of the use cases of the "To match sound-image pairs" exercises manual editor.
1. Use case: Initial configuration.
Main actor: User.
Preconditions: It has just started this exercises editor to create a new exercise.
Main success scenario:
1. The tool shows the user the initial configuration window.
2. The user selects the exercise language, the number of empty pairs to be added to it and presses the "OK button". The tool shows this editor with a new exercise with the initial configuration.
2. Use case: Add a new pair.
Main actor: User.
Preconditions: This editor must be running.
Main success scenario:
1. The user presses the "Add" button located in the "Image-sound pairs" panel.
2. The tool adds a new empty pair at the end of the image-sound pairs list.
3. Use case: Delete the selected pair.
Main actor: User.
Preconditions: This editor must be running and an image-sound pair has to be selected.
Main success scenario:
1. The user presses the "Delete" button located in the "Image-sound pairs" panel toolbar.
2. the tool removes the selected pair in the image-sound pairs list.
4. Use case: The selected pair goes up.
Main actor: User.
Preconditions: This editor must be running, an image-sound pair has to be selected and must have at least one pair placed above.
Main success scenario:
1. The user presses the "Up" button located in the "Image-sound pairs" panel toolbar.
2. The tool raises one position the selected pair in the image-sound pairs list.
5. Use case: The selected pair goes down.
Main actor: User.
Preconditions: This editor must be running, an image-sound pair has to be selected and must have at least one pair placed below.
Main success scenario:
1. The user presses the "Down" button located in the "Image-sound pairs" panel toolbar.
2. The tool lowers one position the selected pair in the image-sound pairs list.
6. Use case: Change the correct/incorrect state
Main actor: User.
Preconditions: This editor must be running and the image-sound pairs list can't be empty.
Main success scenario:
1. The user clicks in the "Correct" column of a pair.
2. The tool changes the state of the pair from correct to incorrect or viceversa.
7. Use case: Associate a sound with a pair.
Main actor: User.
Preconditions: This editor must be running and the image-sound pairs list can't be empty.
Main success scenario:
1. The user looks for the desired sound in the "Sounds" panel. Once the sound is located, the user clicks on it to select it and, without releasing the button, he drags it and drops it onto the "Sound" column
of the desired pair located in the image-sound pairs panel.
2. The tool associates the sound with this pair.
8. Use case: Remove the sound of a pair.
Main actor: User.
Preconditions: This editor must be running and the image-sound pairs list can't be empty.
Main success scenario:
1. The user clicks with the right button of the mouse over the pair that he wants to remove the associated sound.
2. The tool shows the user a small menu of options.
3. The user selects the "Remove sound" option.
4. The tool removes the associated sound of the pair.
9. Use case: Associate an image with a pair.
Main actor: User.
Preconditions: This editor must be running and the image-sound pairs list can't be empty.
Main success scenario:
1. The user looks for the desired image in the "Images" panel. Once the image is located, the user clicks on it to select it and, without releasing the button, he drags it and drops it onto the "Image" column
of the desired pair located in the image-sound pairs panel.
2. The tool associates the image with this pair.
10. Use case: Remove the image of a pair.
Main actor: User.
Preconditions: This editor must be running and the image-sound pairs list can't be empty.
Main success scenario:
1. The user clicks with the right button of the mouse over the pair that he wants to remove the associated image.
2. The tool shows the user a small menu of options.
3. The user selects the "Remove image" option.
4. The tool removes the associated image of the pair.
11. Use case: Play a sound of a pair.
Main actor: User.
Preconditions: This editor must be running, the image-sound pairs list can't be empty and there must be at least one pair with an associated sound in the list.
Main success scenario:
1. The user clicks in the "Sound" column of a pair.
2. The tool plays the associated sound of the pair.
12. Use case: Get information.
Main actor: User.
Preconditions: This editor must be running.
Main success scenario:
1. The user places the mouse cursor over any component of the editor.
2. The tool shows the popup information about the component.
13. Use case: Edit the exercise name.
Main actor: User.
Preconditions: This editor must be running.
Main success scenario:
1. The user clicks the "Exercise configuration" button located in the "Image-sound pairs" panel toolbar.
2. The tool shows the exercise configuration panel.
3. The user enters the exercise name in the "Name" field and presses the "OK" button.
4. The tool associates the new name to the exercise.
14. Caso de uso: Editar enunciado del ejercicio.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario introduce el enunciado del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
4. La herramienta asocia el nuevo enunciado al ejercicio que se está editando.
15. Caso de uso: Cambiar el tiempo mostrando imagen.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario introduce el tiempo mostrando imagen (en milisegundos) en su campo correspondiente y pulsa el botón “Aceptar”.
4. La herramienta asocia el nuevo tiempo mostrando imagen al ejercicio que se está editando.
16. Caso de uso: Cambiar tiempo entre imagen y sonido.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario introduce el tiempo entre imagen y sonido (en milisegundos) del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
4. La herramienta asocia el nuevo tiempo entre imagen y sonido al ejercicio que se está editando.
17. Caso de uso: Cambiar tiempo entre sonido e imagen.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario introduce el tiempo entre sonido e imagen (en milisegundos) del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
4. La herramienta asocia el nuevo tiempo entre sonido e imagen al ejercicio que se está editando.
18. Caso de uso: Cambiar orden de aparición de los pares.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario pulsa sobre la casilla “Orden de imágenes aleatorio” y pulsa el botón “Aceptar”.
4. La herramienta cambia el orden de aparición que tendrán los pares durante la ejecución del ejercicio de normal a aleatorio o viceversa.
19. Caso de uso: Cambiar modo del ejercicio.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario selecciona el modo (Aprendizaje o Evaluación) en el campo “Modo” y pulsa el botón “Aceptar”.
4. La herramienta establece el modo seleccionado para el ejercicio que se está editando.
20. Caso de uso: Asignar un sonido general.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario busca el sonido deseado en la parte inferior del panel “Sonidos generales del ejercicio”.
4. Una vez localizado el sonido, el usuario pulsa sobre él para seleccionarlo y, sin soltarlo, lo arrastrará y soltará sobre uno de los sonidos generales (Enunciado, Correcto, Incorrecto y Despedida)
situados encima de este panel para asignárselo.
5. La herramienta asocia el sonido seleccionado al sonido general sobre el que fue soltado.
21. Caso de uso: Quitar un sonido general.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario pulsa el botón "Quitar sonido" (representado por una cruz roja) que estará situado a la derecha de sonido general al que se le quiere quitar el sonido.
4. La herramienta quita el sonido general del ejercicio.
22. Caso de uso: Reproducir un sonido general.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y el sonido general debe haber sido asignado previamente.
Escenario de éxito principal:
1. El usuario pulsa el botón “Configuración del ejercicio” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta muestra el panel de configuración del ejercicio.
3. El usuario pulsa sobre el sonido general a reproducir (representado por la imagen de un altavoz) .
4. La herramienta reproduce el sonido general.
