Digital Image Measurement Tool

Transcription

1 Digital Image Measurement Tool Requirements Document Version 2 December 2004 Michael J. Cianni

2 Table of Contents Section Name Page 1. Introduction Purpose Scope Reference Materials Terms 4 2. General Description Product Perspective Product Functions User Characteristics 5 3. Functional Requirements Users Digital Camera Required Information Camera Specifications Photo Specifications The Functions Measurements Line Tool Area Tool Angle Tool Grid Ruler Undo Log File Saving Current Project Images Others Preferences User Guide 9 4. Example Scenarios Contractor Crime Scene Investigator Glossary 10 A. Appendix A Screen Shots 11 A.1 Line 12 A.2 Area 12 A.3 Angle 13 A.4 Grid 13 A.5 Ruler 14 A.6 Log File 14 2

3 A.7 Preferences 15 A.8 User Guide 15 3

4 1. Introduction 1.1 Purpose This document provides a description of the Digital Image Measurement Tool. It details the requirements that have been set forth by the developer, Michael Cianni, and the advisor Dr. Tom Way of Villanova University. 1.2 Scope The software described in this document is useful to a wide variety of professionals and amateurs with a basic to intermediate knowledge of computer programs. The Digital Image Measurement Tool is a program that aids a user in making several types of measurements from digital pictures. The professions that this is useful to include contractors, crime scene investigators, astronomers, and anyone else who needs to take measurements. 1.3 Reference Materials Software Engineering, 6th Edition, Ian Sommerville, Pearson Education Limited 1989, 2001; The JFC Swing Tutorial, Kathy Walrath, Mary Campione, Addison Wesley 2002; Dr. Tom Way, Villanova University. thomas.way@villanova.edu; 1.4 Terms These are terms that are commonly used in this document. For a list of other terms, see the Glossary. ACTUAL LENGTH: The distance between two points in the plane of the object in the image. DIMT: Digital Image Measurement Tool. 2. General Description 4

5 2.1 Product Perspective The Digital Image Measurement Tool is a software package that allows a user to import digital photos and take several types of measurements from the image. 2.2 Product Functions There are a variety of functions that make up the Digital Image Measurement Tool. They are listed here; visit 3.4 (The Functions) to read more information on each function. - Line Tool: Allows the user to select endpoints of a line and yields the actual distance. - Area Tool: Allows the user to select points of a rectangle and yields the actual area. - Angle Tool: Allows the user to select points of an angle and yields the actual angle. - Ruler Tool: Allows the user to select endpoints of a ruler and draws a ruler onto of the image that correspond to the actual distance. - Grid Tool: Allows the user to display a distance-based grid onto of the image. 2.3 User Characteristics The users of the Digital Image Measurement Tool should all have basic computer skills. The design is as simple and self explanatory as possible and the program ensures that the user has completed the prerequisites (importing information) before using the tools. 3. Functional Requirements 3.1 Users In order to use the Digital Image Measurement Tool all that is needed is the software, a digital camera with specifications, and a measuring device (See 3.3 Required Information). 5

6 3.2 Digital Camera Any digital camera can be used with the Digital Image Measurement Tool as long it has capabilities to upload pictures to a computer. Of course, the higher the quality pictures it takes, the higher quality the images will be and the more accurate the measurements will be. 3.3 Required Information In order to the use the Digital Image Measurement Tool the user must have some required information. The more accurate this information is the more accurate the measurements that are calculated will be Camera Specifications The nature of the measurements taken using the DIMT require that user input specifications for the camera they used to take the pictures. The user must know the field of view for their camera when taken from any distance. For example, this camera takes a picture 4 feet wide when the distance from the camera to the object is 6 feet away. This data only needs to be specified once for each camera used Photo Specifications The nature of the measurements taken using the DIMT require that the user input the distance between the object photographed and the camera lens in order for the program to make its calculations. This can be taken using any type of measuring device, but makes the job much easier if a laser measuring tape with memory capabilities is used. Hopefully, if this program is deemed useful by many professionals there could be a digital camera engineered that saves this data when it takes the pictures, making the process much easier for the user. 3.4 The Functions 6

7 Listed here are the functions that are available to all users of the Digital Image Measurement Tool Measurements The heart of the Digital Image Measurement Tool is its ability to take several types of measurements from images once they have been imported and displayed by the user Line Tool The line tool is the most basic tool used in the Digital Image Measurement Tool. After importing and displaying a user chosen image, the user can select two points on the image, each one specifying an endpoint of a line, and the system calculates the actual distance between the two points and outputs the calculation on the yield panel Area Tool The area tool allows the user to select three points of a rectangle. The first point corresponds to the upper left corner of the rectangle, the second point corresponds to the width of the rectangle, and the third point corresponds to the height of the rectangle. The system then calculates the area based on the points specified by the user and outputs the calculation on the yield panel Angle Tool The angle tool allows the user to select three points of an angle. The first point corresponds to the endpoint of a segment of the angle, the second point corresponds to the vertex of the angle, and the third point corresponds to the endpoint of another segment of the angle. The system then calculates the angle based on the points specified by the user and outputs the calculation on the yield panel. 7

8 Grid Tool The grid tool allows the user to display a grid on top of the image. The grid shows intervals of measurements along the left and bottom (or left and top) edge of the image. The user can set the layout of the grid from the Preferences Window Ruler Tool The ruler tool allows the user to select two endpoints of a ruler and the system then displays a ruler between those two points. The user can set the units and the opaqueness of the ruler from the Preferences Window Undo Tool The undo tool allows the user to remove the last item that they have added to the image. All the additions to an image are stored, so the user can remove any number of items whenever they wish Log File The DIMT keeps a log of all the items drawn on each image, and a list of these items can be viewed in a log file Saving There are two ways to save any work the user does in the DIMT Current Project The user can save the current project, including the images imported and the items drawn on the image. The user can later open it back up, or view the text file that includes all this information Images 8

9 The user can save the image that they are working on, including all the items that are drawn on top of the image. The image can then be viewed and printed from any program supporting the major image file types Others There are two other functions that are available to the user Preferences There are several preferences that are customizable by the user: System: Select US or Metric Angles: Select Degrees or Radians Grid Layout: Select West-South or West-North Line Thickness: Select Small, Medium, Large or Extra Large Line Color: Select Black, White, Yellow, or Red Draw Ruler: Select Opaque or transparent Save Image: Select jpeg, jpg, gif, tiff, or tif Quality: Select High or Low User Guide The DIMT will include a user guide that will help the user to learn the basic steps to take to use the program, more information about the tools available, and get answers to frequently asked questions. 4. Example Scenarios The following are two of the several example scenarios in which the Digital Image Measurement Tool would be a valuable option for professionals to use. 4.1 Contractor One of the possible users of the DIMT is a contractor who wants an easy way to determine how much material will be needed for a specific job. He would first take a picture of the side of a house that he needs to refinish, noting the distance 9

10 the picture was taken from. Next, he would import the image to his computer, start the DIMT, and import the image into the workspace. The program will then ask him for his camera specifications and the distance that he has noted. He can then ask the program to take measurements of that side of the house and the program will output those calculations on the yield panel. From those calculations he can then determine how much material will be needed for the job. The contractor can even save the image with the measurements and use it to show a set of before and after images when the work is done. 4.2 Crime Scene Investigator When a crime scene investigator takes pictures from the scene they often lay down a ruler, or a dollar if that is not available, before taking a picture of evidence to provide a scale when later looking at the pictures. Instead of doing this they can simply note the distances the photos were taken from and later use the DIMT to make any calculation they want. After taking the photo the investigator would import the image to their computer, then import the image into the DIMT workspace. After inputting the required camera specifications and image distances, the investigator can then take any of the several available measurements and the program will output the calculations on the yield panel. From these calculations the investigator can then determine anything from a shoe size to a tire type. The image and calculations can even be saved if this information would later be needed as evidence in a trial. 5. Glossary Preferences Window: A popup window that allows the user to customize the Digital Image Measurement Tool. Yield Panel: An area of the program where the calculations will be output. 10

11 Appendix A Screen Shots taken from the Digital Image Measurement Tool (Starts on the following page) 11

12 A.1 Line A.2 Area 12

13 A.3 Angle A.4 Grid 13

14 A.5 Ruler A.6 Log File 14

15 A.7 Preferences A.8 User Guide 15