Speechi Quiz Editor

From Speechi WiKi

Contents 1 Speechi Quiz Editor 1.1 Launching the application 1.1.1 Designing a Quiz 1.1.2 Modify a Quiz 1.2 Correct Order 1.2.1 Create a question 1.2.2 Options 1.2.2.1 Points 1.2.2.2 Number of realizations 1.2.2.3 Time Limit 1.2.2.4 Include a Title 1.2.2.5 Label Colors 1.2.2.6 Question Difficulty 1.2.3 Reading a Question 1.2.4 Remarks 1.3 Labels 1.3.1 Add an image 1.3.2 Add label 1.3.3 Add arrows 1.3.4 Label menu 1.3.4.1 Modify label text 1.3.4.2 Delete arrows 1.3.5 Delete all 1.3.6 Options (Label Mode) 1.3.6.1 Question options 1.3.6.1.1 Number of realizations 1.3.6.1.2 Score 1.3.6.1.3 Other 1.3.6.2 Display Options 1.3.6.2.1 Labels display 1.3.6.2.2 Arrows display 1.3.7 Operating a question in flash area 1.3.7.1 Example of a default question 1.3.7.2 Options 1.3.7.2.1 Number of realizations 1.3.7.2.2 Temps limite 1.3.7.2.3 Correction 1.3.7.2.4 Colors 1.4 Multiple Choice 1.4.1 Create a multiple choice question 1.4.2 Options (Multiple Choice) 1.4.2.1 Score points 1.4.2.2 Time limit 1.4.2.3 One answer allowed 1.5 Puzzle 1.5.1 Create Puzzle 1.5.2 Options 1.5.3 Import a puzzle 1.5.4 Make a puzzle 1.6 Hangman 1.6.1 Creator Interface 1.6.2 Candidate Interface

Speechi Quiz Editor

Speechi Quiz Editor is an autonomous tool allowing the creation of quizzes. A quiz can contain 5 different types of exercises:

• Correct order
• Labels
• Multiple Choice
• Puzzle
• Hangman

During the next sections, we will explain to you

• How to create/set up a Quiz (Quiz Design)
• How to edit every question (Quiz Design)
• How to answer questions (Quiz Usage)

Throughout the documentation,

• The one who prepares the Quiz will be called “creator”, it could be a professor.
• The one who answers the Quiz will be called “candidate”, it could be a student.

Launching the application

To edit a Quiz, you must launch the "Quiz Editor" program.
By default, it can be found by selecting "Start", then "All the programs", then "Speechi" and then "Quiz Editor".

When launching the application, a window appears,

The creator must also choose between "Create a new Quiz" and "modify a Quiz"

Designing a Quiz

To design a new Quiz, start by giving it a title. Once the operation is validated, the Quiz editing window appears.

To add a question (an exercise),
Click on the "Add" icon,

You must then choose between the proposed Question types and validate.

To edit your questions, please refer to the corresponding paragraphs below.

To delete a question, click on the desired question. It becomes underlined. Click then on the "Delete" icon.

Modify a Quiz

After selecting the "Modify a Quiz" option in the first window, a file browser appears. You need to go then to the location of the Quiz to be modified. (By default, the location is: MyDocuments\SpeechiQuiz\ )

At this moment, you can see all the quizzes that can be modified. Click on the quiz of your choice then on the Quiz folder and finally on the XML file having the same title as the Quiz.

If the quiz to be modified is titled QuizN1, then the corresponding XML file would be: QuizN1.xml

Afterwards, the procedure is the same as for Quiz creation. You can then modify only the settings that you wish to change.

Correct Order

The goal of the exercise is to allow the creator (professor) to easily create labels that the candidate (student) should place into order.

The interface that is shown to the creator is the following:

The creator can import a question of type "order" which was already created, create a new question, manage its options or cancel the operation.

Create a question

The creator should start by giving a title to the question (limited to 40 characters).

Then, he must suggest answers that will be shuffled subsequently.

When creating labels, the creator selects a word or a sentence in the provided area and clicks the “add an expression” button. This word or sentence is then placed in the grid. The sentence can contain up to 90 characters. At any moment, the professor can modify or delete a line in the grid by selecting that line and clicking the “Modify” or “Delete” button.

It is also possible to modify the order of the words or sentences using the up or down arrows. For this, select a sentence and click on the arrows on the right of the grid.

Options

The creator has the ability to facilitate or not the task for the candidate by using several options.

The creator will find the usual options but also options that are typical to this type of exercises:

Points

The creator chooses the number of points to allocate to the question that he just composed. He can choose two counting modes:

• Require all answers to be correct: The candidate must correctly place all the labels in order so that he can get the points.

• Score proportionally: The candidate points are counted as a function of the number of correctly placed labels and the number of labels to place. Example: The candidate correctly placed 7 labels out of 10. The creator allocated 3 points to the question. The points are calculated in the following manner: 7/10*3 = 2.1. The candidate will obtain a score of 2.1/3 on this question.

Number of realizations

By default, the candidate can only take the exercise once; however, it is possible to give several chances to the candidate. A fixed number of realizations can be set otherwise; the candidate can be allowed to repeat the exercise until he succeeds in it. At every realization, the creator can show the errors to the candidate. For example, if a creator decides to give 2 chances to the candidate in order to correctly answer the questions, at the end of the first question, and if the candidate doesn’t succeed, the creator can decide to show him his errors. In this case, the labels that were correctly placed will become green (by default) and the labels incorrectly placed will become red (by default). The creator should then check the option “show wrong answers at every time”.

Time Limit

It is possible to set a time limit to the realization of an exercise. For this, check the box “Time limit” and set the number of seconds as the maximal time for the exercise realization.

Include a Title

The candidate should replace sentences and words. It is sometimes necessary to include a title for the sentences and words to be replaced. When checking this option, the new label will be formed with a title. In the case where the creator has required from the candidate to correctly place all labels in order to get all of the score, the label containing the title should also be correctly placed at the corresponding location. In the case where the creator has checked the proportional scoring option, the title label will be an additional label to the total.

For example, if the user added 10 labels and decides to include a title; that would make 11 labels. If he allocates 10 points to the exercise, the score counting will be the following: number of labels placed / 11 * 10.

Label Colors

The creator can choose label colors.

• The default color (blue) is the color of labels at the start of the exercise, when candidates have to place them.
• The color of wrong answers (red) is used to mark labels that are incorrectly placed, if the creator has checked the option “Show wrong answers at every time”. This color is also used to mark labels when the candidate incorrectly places them, used during correction time.
• The color for correct answers (green) is used to mark labels that were correctly placed, if the creator has checked the option “Show wrong answers at every time”. It is also used to mark labels that the candidate correctly placed, at correction time.

To modify the default colors, the creator should click on the colored buttons and choose a color from the palette appearing in the small window that opens.

Question Difficulty

The creator can choose to facilitate or not the question by deciding to fix certain labels on the right place at the beginning of the question. For this, the creator should check the option “Place some words or sentences”. If the creator has already added some sentences or words to the grid, then the list containing the sentences will disappear. The creator can then check the sentences or words that he wants to place at the start. At the time of score counting, the sentences that were already placed by the creator will be considered as acquired points for the candidate.

Reading a Question

We just created a small text. This is how the exercise appears to the candidate.

Here, the candidate should replace the sentences in the correct order, but also the title as well, then click on the “Validate” button. We impose a time limit of 20 seconds to perform the exercise. The candidate has the right to 3 trials. At every time that he validates and if he can’t place the story into order, the program will show his/her errors. Finally, 10 points will be awarded to the student if he succeeds in the exercise. We chose the proportional scoring mode.

The labels that the candidate should replace are randomly positioned at the bottom of the interface. He must replace them correctly into the grid by using a “drag-and-drop” movement.

If the time elapses before the candidate has the time to finish, or if he clicks on the “Validate” button while he has made some errors, the labels will change colors in order to show which labels are correctly placed and which are not.

Here we can see that time elapsed while the candidate hasn’t changed anything yet. He obtains nevertheless a point since we have chosen to leave a sentence in place to help him. The incorrectly placed labels are in red.

In the end, the correction is revealed to the candidate.

The labels are placed at their correct place. The labels that the candidate has correctly placed turn green. The labels that the candidate misplaced are correctly placed and become red.

Here, the candidate has correctly placed 4 labels out of 9, and hence obtains the score of 4.44/10 (4/9 * 10).

Remarks

If within the exercise several sentences or words are identical, the exercise could become more complicated. Let’s take an example to be clearer:

Consider the following text produced by the creator:

The exercise appears to the candidate as follows:

Two sentences are identical, which one is to be placed first? The program allocates to each label a number in order to easily count the score. It doesn’t verify if the labels are correctly placed depending on their text but rather depending on their number. That is why the creator should avoid putting several identical words or sentences in a solution.

Example: The creator proposes several identical words or sentences.

The student placed the labels correctly; that is literally it is correct but not computationally.

Therefore, in case of repetitive text, it is more interesting to initially place the labels that are duplicated in the text (at least one of them) in order to avoid the problems previously cited.

Labels

The goal of this quiz is to ask the candidate to place labels next to the right arrows pointing to an image.

Add an image

To create this type of Quiz, you need to select an image first.

By clicking on “Add an image”, an explorer window opens and lets the user choose a file.

For the moment, the creator can only choose images in the jpg or bmp formats. The jpg should not be “progressive” since it is not supported by flash.

Hence, functions to convert png, gif..formats to non-progressive jpg format should be used in prior.

Once the image is chosen, the button to add a label becomes active. The image is reduced and centered when necessary. The maximal size of the image allows the creator to have sufficient space to position the labels. The scheme that he will put into place will be identical to the one published in flash. The dimensions will be preserved.

Add label

The creator can add a label by click on the “Add label” button. It is limited to 10 labels.

A blue label (by default) appears on the top left of the interface. At this moment, the button for adding arrows becomes accessible. However, the button to add an image becomes inactive. To change the image then, you must click on the “Start again” button. This button reinitializes the window.

Add arrows

The label can now be moved by maintaining the mouse’s right button pressed. The label cannot be deposited on the image though. Once the label is added, the user can add an arrow. He can actually add up to three arrows per label. For this he needs to click on the “Add arrow” button. This button remains pressed, to tell the user that any drag-and-drop operation can draw an arrow. The user then clicks on the label on which the arrow is to be attached and, while maintaining the right mouse button pressed, moves the cursor on the image, drawing a line. Once the cursor is set free, the user can move the label, and the arrow follows. However, he cannot move the other end of the arrow which is attached on the image.

Label menu

When performing a right-click on the label, a small menu appears.

Modify label text

If the creator clicks on the “Modify text” menu item, a window opens allowing him to input a message of 26 characters maximum. This function is also available when double clicking on the label.

The length of the caption is limited to 26 characters.

Delete arrows

If the creator clicks on “Delete arrows”, all the arrows that are linked with the label on which he right-clicked will be deleted.

Delete all

If the creator clicks on “Delete all”, all the arrows will be deleted as well as the label itself on which he right-clicked.

Options (Label Mode)

The Options window is available at any time from the “Option” button. The modifications are applied once the user clicks on the “Apply” button.

Question options

Number of realizations

The number of realizations lets the creator choose how many trials a person has in order to realize the quiz provided. He can then choose either a fixed number, by default 1, or leave the candidate repeat the question until he succeeds in positioning all labels correctly.

Score

This part of the options lets the creator set the number of points to be allocated on the question as well as the allocation mode. He must enter the number of points and chose whether to require all answers correct or proportional scoring mode.

If the creator requires all the correct answers, the candidate is obliged to place all labels at the right place in order to get the points.

If the creator checks the proportional mode, then a prorata will be counted between the numbers of correct answers and the total number of answers to be given. The score will be as follows: number of correct answers / number of total answers * points for the question.

Other

The creator can also choose to display or not the correction at the end of the question. He can also add a time limit, measured in seconds.

Display Options

Labels display

The creator can choose colors for the labels. For now he cannot choose the font police of the labels (XML interfaces are expected though). The default color is the label’s appearance color at the beginning of the question. The color for false answer and the color for correct answers appear when the correction is displayed. During correction, labels that were correctly placed are shown in green, by default, while labels that were not correctly placed are shown in red. By clicking on the color button, a window for color selection appears allowing the user to select the label display color.

Arrows display

The creator can change the thickness of arrows, from 1 to 5. However, under visual basic any dotted line with thickness greater than 1 is not displayed as dotted anymore. This is a limitation of Visual Basic; however, dots will be displayed in the area in Flash.

Operating a question in flash area

Example of a default question

Here is a question produced by a creator, selected settings are the default settings, besides arrows that have a purple color instead of black.

This question will be displayed in the following manner in flash area:

The candidate can then move the labels that are on the right using drag-and-drop. Labels are placed on the right in a random fashion. The candidate should drop the label at the arrow’s end. The arrow becomes thicker when the user moves the label into a sensitive zone.

When the label is not dropped on a sensitive zone, the label returns to its place, or is attached to the arrow.

When ready, the user clicks on the “Validate” button. A small box shows then his score.

When clicking on this box the candidate has access to the correction (since by default the correction is given). Suppose that I gave the following answers:

The correction will be as follows:

The well placed labels become green. The misplaced labels become red and are put in the correct place.

When clicking “Next”, we move on to the next question. Since for now I only operate the xml of the question just shown, we move on to the final score display.

Options

Number of realizations

On the top left is shown the number of trials remaining for the candidate to put the labels in their place. This number is decreased every time the candidate validates an answer. For every validation, the number of correctly placed labels is shown, without showing which ones they are. Labels are put back into their original place. Obviously, the correction is shown at the end. If the candidate has the right to repeat the question until he succeeds, then the mention “Number of remaining trials” doesn’t appear.

Temps limite

The time limit, in seconds, is displayed on the top right above the label column.

If the candidate didn’t click on the “Validate” button before the time ends, the result is displayed automatically.

Correction

If the creator chose not to show the correction to the question, when the candidate clicks on the results window, he is automatically redirected to the next question.

Colors

Label colors depend on the creator’s choice. By default the palette used is:

• Blue for labels
• Green for correct labels during correction
• Red for incorrect labels during correction
• Black for arrows

Here we chose to put the labels in yellow, arrows in black and to use orange and blue colors for correction. A colors legend is displayed on the right.

Multiple Choice

Create a multiple choice question

You can see below the Multiple Choice Question editing window:

Just like each other question you must start by giving a title to the question in the designated cell at the top of the window.

Then, you just need to write below, the answers that you provide for the question.

It is possible to add comments to each answer; these comments will be displayed after the answers of the candidate.

To select one or many correct answers, you must check the corresponding box on the left of the window.

Options (Multiple Choice)

Score points

It is possible to allocate a certain number of points to each question. A scrolling bar lets you assign 1 to 9 points per question, but actually, it is possible to assign up to 10000 points per question. For this, you have to enter the value with the digital keyboard in the corresponding box.

Points allocation can be done in two ways:

Either you require all the correct answers and in this case the awarded score will be maximum or null; or you award a score that will be proportional to the number of provided answers.

Time limit

It is possible to set a time limit to answer the question. For this you must check the corresponding box. It is also possible to change the duration of this time limit, which is configured by default to 30 seconds. The time limit should be between 1 and 999 seconds.

One answer allowed

Finally, it is possible to create a Multiple Choice Question where only one answer is possible. In this case, you must check the corresponding case. This action will have the effect of preventing the Quiz designer from proposing two correct answers.

Puzzle

At the launch of the program, the first interface shown to the creator is the following:

The creator can import a puzzle already created, create a new puzzle, manage the options or cancel the operation.

Create Puzzle

To create a puzzle, you just need to select an image of type .jpg and .bmp from its directory. For this, the creator must click on the “Add an image” button. An explorer window opens, allowing him to select a file.

The image can be a portrait or a landscape. Ideally it should have the following dimensions:

Portrait: 500*400 Landscape: 400*600

In the case where these dimensions are not met, the image will be automatically resized and centered so that the puzzle takes into consideration most parts of the image. For this reason some areas of the image will be cropped. Only the part of the image framed by a red rectangle will be used to construct the puzzle.

To select a puzzle, you must select a number of pieces as well as the shape of the piece from the dropdown lists on the right, and then click on “Apply this puzzle” button. The creator can choose from 5 puzzles:

- Number of pieces: 12, 30, 54, 80 or 100

By clicking on the “Apply this puzzle” button, a grid is applied on the previously selected image. Cuttings that appear hence will be applied to the image.

To save the puzzle, click on “Save” button.

Options

By clicking on “Options” button, the user can choose to whether require or not certain constraints on the candidate who’s realizing the puzzle.

By default, a puzzle is realized in 30 seconds. The creator can allocate a specific number of points. We propose for the creator to facilitate or not the realization of the puzzle through 3 options:

• “Display shapes” simply shows the border of the pieces in the background
• “Display the image in background” shows transparent image in the background
• “Display picture in pop-up” allows showing the image in small besides the puzzle. This image can be moveable by the one who realizes the puzzle.

Import a puzzle

To import a puzzle, you just need to click on the “Import” button. An explorer window will then open allowing the creator to select an .xml file which is initially named PuzzleXML.xml.

Make a puzzle

Let’s take the example of a puzzle for which we would have checked the 3 options. This is how the puzzle will appear at the start:

Pieces are randomly placed on the left and should be replaced on a magnetized area on the right. To move the pieces, you just need to perform a drag-and-drop operation while maintaining the mouse button pressed.

The black grid corresponds in fact to the “Display shapes” option being displayed. In the background, the image appears in transparence due to the option “Display image in background”. Finally, the image surrounded by a thick white frame, representing a smaller puzzle, appears due to the “Display picture pop-up”. This image is also movable using drag-and-drop.

In the bottom left, the number of points allocated to this question is shown. On the top right, the elapsed time appears if the creator has chosen to impose a time limit.

Hangman

Creator Interface

The realization of a question of type hangman is certainly the simplest to do.

When the creation window below appears, you just need to fill in the required fields.

In the box below “Add a question”, you just need to type in your question.

The answer will have to be typed below the “add sentence to find” box.

The only options available for this question are the number of points and the time limit.

Candidate Interface

Here is the interface shown to the candidate.

To suggest a letter, just click on it. If the letter is part of the answer, it will be placed on the corresponding location(s), whereas if the letter is not part of the answer, then, the hangman drawing is being completed.

The already suggested letters are dimmed grey. They cannot be suggested anymore.