Story Cards

Story Card Requirement #1

The requirement reads, “Paint will have a 'fill' tool that will change the canvas to be entirely the color selected.”

S1: The user will select (click) the fill tool from the tool bar.
S2: The user will select the desired color from the color palate.
S3: The user will click anywhere in the canvas to replace all pixels in the canvas with the color selected.

Story Card Requirement #2

The requirement reads, “Paint will have an erase tool that will allow the user to erase areas of the canvas.”

S1: The user will select (click) the eraser tool from the tool bar.
S2: The user will click or click and drag on the canvas where they would like to erase.
S3: The program will access a variable containing the last used background color and designate it as the current brush color.
S4: The program will employ the same method as the brush tool and replace pixels underneath the pointer with the background color.

Story Card Requirement #3

The requirement reads, “Paint will specify size of canvas in pixels for height and width.”

S1: By default, the canvas will be sized 200x200 pixels.
S2: The user can change the value of either or both height and width to any positive integer value greater than 0 and less than or equal to 600.
S2a: A number less than 1 will be automatically changed to 1.
S2b: A number greater than 600 will be automatically changed to 600.
S3: After changing the dimensions to the desired values, the user will click on the resize button to change the canvas size.
S3a: If either dimension is increased (i.e. pixels that were previously unavailable are now usable) the added pixels will be set to the background color.
S3b: If either dimension is decreased (i.e. causing some pixels to become unavailable) any changes in the now unavailable space is permanently lost.

Story Card Requirement #4

The requirement reads, “Paint will have a rectangle tool that allows user to click on a starting point, click on an ending point and create a rectangle using the two selected points as opposite corners.”

S1: The user will click the click on a button to select the rectangle drawing tool.
S2: After clicking the button, the user will click the left mouse button somewhere on the canvas to designate one corner of the rectangle.
S2a: If the user does not click on the canvas, the program ignores the click.
S3: After designating the first corner, the user moves the mouse to the desired location of the opposite corner in the rectangle and clicks the left mouse button.
S3a: If the user clicks the left mouse button off the canvas, the nearest legal point on the canvas will be used.
S4: A vertical rectangle will be drawn starting from the location of the first corner, moving vertically until horizontal with the location of the opposite corner. The rectangle will continue horizontally until reaching the designated opposite corner at which point, it will traverse vertically until it is horizontal with the starting corner. The drawing will then continue horizontally until ending at the starting point.

Story Card Requirement #5

The requirement reads, “Paint will respond to a 2d input device, mouse, to determine when a button is pressed or selection made.”

S1: The mouse will be used as in Windows to select various tools or locations on the canvas.
S2: To select a tool, the user left clicks once on the desired tool.
S3: If the tool requires additional designated inputs, the user will left click once and hold the mouse button down to select the first point. The user will release the left mouse button to select the second point.
S4: Each click/release of button on the canvas selects a single pixel on the canvas designated by the very tip of the pointer.

Story Card Requirement #6

The requirement reads, “Paint will paint when the left mouse button is pressed and stop painting when the mouse button is released”

S1: The user will press the left mouse button down to signal a response on the paint program
S2: Paint will detect where the mouse is pressed and what action to follow based on the x and y coordinates of where the mouse is clicked.
S3: A mouse press results if the action intended was achieved.

Story Card Requirement #7

The requirement reads, “Paint will allow the user the choice of eight colors to paint with: red, orange, yellow, green, blue, purple, black, or white.”

S1: The user will use the mouse to touch one of the color swatches provided on the palette
S2: Paint will respond by matching the color swatch with the designated private integers designated in the code
S3: A successful selection of brush color will paint the color selected on the canvas

Story Card Requirement #8

The requirement reads, “Paint will have a line tool that allows user to click point a, click point b and paint will connect a and b with a solid line.”

S1: The user will click on a button to select the line tool.
S2: The user will left click somewhere in the canvas to select point a.
S2a: If the user clicks outside of the canvas, the click is ignored.
S3: The user will left click again somewhere on the canvas to designate point b.
S3a: If the user clicks outside of the canvas, the closes point on the canvas is used.
S4. Paint will draw a single, straight line from point a to point b of the color selected in the color palate.

Story Card Requirement #9

The requirement reads, "Paint will open through double-clicking a file."

S1: The user will select (double click, press enter, etc.) the correct paint file.
S2: The program, including a blank canvas, menu, and buttons, will open, and the user will immediatly be able to paint. The white color and draw tool are automatically selected.

Story Card Requirement #10

The requirement reads, "There will be several buttons showing lines of different width. The width selected will be the width of paint strokes made."

S1: By default, the thinnest line will be selected.
S2: The user clicks on the line representing the thickness wanted.
S3: All paint strokes (including lines, rectangles, etc) will have a thickness equivalent to the thickness of the line selected.

Story Card Requirement #11

The requirement reads, “Paint will have a “‘File’ menu at the top of the window that allows the user to clear the canvas (fills with white) or quit the program.”

S1: The user will click on the word “File” which is located at the top left of the window.
S2: After single clicking on “File”, a drop down menu is displayed.
S2a: The dropdown menu contains “Clear canvas” and “Quit”.
S3: The user will left click on either of the options in the menu to select.
S3a: If the user selects “Clear canvas”, the program will completely fill the canvas with white pixels.
S3b: If the user selects “Quit”, the program will immediately close.
S4: If the user clicks anywhere on the screen outside of the dropdown menu, the dropdown menu will disappear and the user will resume the activity in process before clicking the “File” menu.

Story Card Requirement #12

The requirement reads, “Paint will have a "help" menu that contains the options to display a help page and an "about" page.”

S1: The user will click on the word “Help” which is located at the top left of the window, to the right of “File”.
S2: After single clicking on “Help”, a drop down menu is displayed.
S2a: The dropdown menu contains “Help page” and “About”.
S3: The user will left click on either of the options in the menu to select.
S3a: If the user selects “Help page”, a new window opens on top of the canvas with detailed explanations of all the tools available in the paint program.
S3b: If the user selects “About”, a new window opens on top of the canvas with information about the designers of the program.
S4: If the user clicks anywhere on the screen outside of the dropdown menu, the dropdown menu will disappear and the user will resume the activity in process before clicking the “File” menu.