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.
En el diagrama anterior se puede observar que la información del ejercicio que se está editando se va almacenando en la clase "CurrentEmparejarExercise", cuyos campos son todos estáticos. Esta clase almacena también la información de todos los pares imagen-sonido que posee el ejercicio, siendo cada uno de ellos representado por una instancia de la clase "PairInfo".
Por otra parte, el panel principal es un objeto de la clase "EmparejarMainPanel", que está formado por tres subpaneles: Pares imagen-sonido", "Imágenes" y "Sonidos".
El panel Pares imagen-sonido ("leftPanel") es de tipo "PreviewPanel" y contiene la barra de herramientas del panel Pares imagen-sonido y el panel que contiene todos los pares del ejercicio ("PairsPanel"). El panel de configuración del ejercicio es de tipo "ExerciseConfigPanel" y es instanciado cada vez que el usuario pulsa sobre el correspondiente botón situado en la barra de herramientas del panel Pares imagen-sonido.
La clase "MultimediaResourcesFilterPanel" ("rightPanel") crea dos instancias de la clase "MultimediaFilterPanel". Cada una de estas instancias representa un panel en el que se filtran los recursos multimedia disponibles que, en este caso, son "Imágenes" y "Sonidos".
Use cases
800px|Diagrama de casos de uso del editor manual de ejercicios Emparejar sonido-imagen.
A continuación se realizará una descripción textual de los casos de uso del editor manual de ejercicios Emparejar Sonido-Imagen.
1. Caso de uso: Configuración inicial.
Actor principal: Usuario.
Precondiciones: Se acaba de iniciar este editor de ejercicios para crear un ejercicio nuevo.
Escenario de éxito principal:
1. La herramienta muestra al usuario la ventana de configuración inicial.
2. El usuario selecciona el idioma del ejercicio, el número de pares vacíos que se añadirán al mismo y pulsa el botón “Aceptar”.
3. La herramienta inicia este editor con un nuevo ejercicio que tiene la configuración inicial seleccionada.
2. Caso de uso: Añadir un nuevo par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario pulsa el botón “Añadir” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta añade un nuevo par vacío al final de la lista de pares imagen-sonido.
3. Caso de uso: Eliminar el par seleccionado.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y tener un par imagen-sonido seleccionado.
Escenario de éxito principal:
1. El usuario pulsa el botón “Eliminar” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta elimina el par seleccionado en la lista de pares imagen-sonido.
4. Caso de uso: Subir una posición el par seleccionado.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución, tener un par imagen-sonido seleccionado y debe tener al menos un par situado por encima de él.
Escenario de éxito principal:
1. El usuario pulsa el botón “Subir” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta sube una posición al par seleccionado en la lista de pares imagen-sonido.
5. Caso de uso: Bajar una posición el par seleccionado.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución, tener un par imagen-sonido seleccionado y debe tener al menos un par situado por debajo de él.
Escenario de éxito principal:
1. El usuario pulsa el botón “Bajar” situado en la barra de herramientas del “Panel Pares imagen-sonido”.
2. La herramienta baja una posición al par seleccionado en la lista de pares imagen-sonido.
6. Caso de uso: Cambiar el estado correcto/incorrecto de un par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de pares imagen-sonido.
Escenario de éxito principal:
1. El usuario pulsa sobre la columna "Correcto" de un par determinado.
2. La herramienta cambia el estado del par de correcto a incorrecto o viceversa.
7. Caso de uso: Asociar un sonido a un par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de pares imagen-sonido.
Escenario de éxito principal:
1. El usuario buscará el sonido deseado en el panel "Sonidos". Una vez localizado el sonido, pulsará sobre él para seleccionarlo y, sin soltarlo, lo arrastrará y soltará sobre la columna "Sonido" del par situado
en el panel de pares imagen-sonido al que se le quiera asociar.
2. La herramienta asocia el sonido al par sobre el que fue soltado.
8. Caso de uso: Quitar un sonido de un par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de pares imagen-sonido.
Escenario de éxito principal:
1. El usuario pulsa con el botón derecho del ratón sobre el par al que quiere quitarle el sonido que tiene asociado.
2. La herramienta muestra al usuario un pequeño menú de opciones.
3. El usuario selecciona la opción "Quitar sonido".
4. La herramienta quita el sonido que tenía asociado el par.
9. Caso de uso: Asociar una imagen a un par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de pares imagen-sonido.
Escenario de éxito principal:
1. El usuario buscará la imagen deseada en el panel "Imágenes". Una vez localizada la imagen, pulsará sobre ella para seleccionarla y, sin soltarla, la arrastrará y soltará sobre la columna "Imagen" del par situado
en el panel de pares imagen-sonido al que se le quiera asociar.
2.La herramienta asocia la imagen al par sobre el que fue soltado.
10. Caso de uso: Quitar una imagen a un par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de pares imagen-sonido.
Escenario de éxito principal:
1.El usuario pulsa con el botón derecho del ratón sobre el par al que quiere quitarle la imagen que tiene asociada.
2.La herramienta muestra al usuario un pequeño menú de opciones.
3.El usuario selecciona la opción "Quitar imagen".
4.La herramienta quita la imagen que tenía asociada el par.
11. Caso de uso: Reproducir un sonido de un par.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución y debe existir al menos un par en la lista de pares imagen-sonido que tenga un sonido asociado.
Escenario de éxito principal:
1. El usuario pulsa sobre el contenido de la columna "Sonido" de un par determinado.
2. La herramienta reproduce el sonido asociado a dicho par.
12. Caso de uso: Obtener información.
Actor principal: Usuario.
Precondiciones: Este editor debe estar en ejecución.
Escenario de éxito principal:
1. El usuario sitúa el cursor del ratón sobre cualquier componente del editor.
2. La herramienta muestra información emergente de dicho componente.
13. Caso de uso: Editar el nombre 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 nombre del ejercicio en su campo correspondiente y pulsa el botón “Aceptar”.
4. La herramienta asocia el nuevo nombre al ejercicio que se está editando.
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.
