The main component of MyFreePACS is the Image Viewer. A common session with the image viewer will look something like this (note: patient data has been removed):
For the purposes of this documentation, I will split up discussion into three components: The Viewer Window, The Toolbar, and The Toolset.
The Viewer Window
The viewer window is the main window that the images are viewed in. The default configuration is a 2x1 array of image windows. You can use the toolbar to change this. You will use the tools from the toolset to manipulate the images in these windows. See 'The Toolset' section below for more information on this.
After you retrieve images using the search window, they will be attached to the viewer window. As series are downloaded, they will be automatically loaded into any empty image windows in the viewer. If you want to change what set is viewed in a window, simply right click on a window. It will pop up a list of all downloaded image series, sorted by patient and study. Click the new set and it will be loaded into that window.
The currently selected window is denoted by a light blue box around it. Non-selected windows have dark grey boxes around them. You can use the mouse wheel to scroll through an image set one by one, or you can use tools from the Toolset to do other functions.
I will draft documentation on the overlay information at a later time. The layout of the overlay information has not yet been finalized, and so I'm going to hold off on documenting the non-finalized overlay because it's highly likely it will change drastically before the final release.
The toolbar is the area on the right of the window that contains all the buttons and tools. Note that the toolbar can be hidden by clicking the vertical column of right-pointing arrows. This will hide the toolbar on the right side of the screen. Click the now-left-facing arrow column to restore the toolbar.
At the top of the toolbar is the Tool Select area. This is covered in the next section, The Toolset, and will not be discussed here.
Below that is the window selection grid. This is how you can change the window layout of the Viewer Window. By clicking in a box in the grid, it will change the Viewer Window layout to be an array as big as you select. The light blue boxes indicate the current window layout, while the teal boxes are the inactive windows. If you cleck the "Array" box, then it will link the windows by rows. If you enable array mode, then it will clear the windows. You can then load a single set into any of the windows. It will then load the set into the whole array of windows, ordered by row. You can then scroll through the set row by row. This is especially useful for Ultrasound, though it works for all modalities.
Below the window grid is the first group of tools. These are mainly control tools:
|This will open the search window. Middle clicking in the image viewer window will have the same result.|
|This will open the download queue.|
|This will open the JPEG Export window. This will allow you to save images from the currently selected window as JPEG. The window will open and give you two options. If you save the current view, then it will save the JPEG exactly as currently seen in the image window. If you save the original view, it will use the current window/level settings, but save it in the original exact size of the source image.|
|This will open up a dump window containing the DICOM elements for the currently selected image.|
|This tool will reset the selected window to its default settings. It will restore the Window/Level, Pan, Zoom, Invert, Flip, and Rotation all to their defaults. It will also clear any overlay tools currently used on it (line/oval).|
|This tool toggles a simple image color invert on the selected window.|
|These tools will rotate the currently selected image either clockwise or counter-clockwise.|
|These tools will flip the currently selected image either horizontally or vertically.|
|This tool, when enabled, will perform linked scrolling. This means that when you scroll one image set, the viewer will check all the other series that are in the same plane (within ~30 degrees) and find the closest image to the image that you just scrolled to.|
|This tool will do the same thing as the link tool, with one major difference. When you first enable this tool, it records how far all the currently displayed series are off from each other. Then, when you scroll through a set, it will remember the offset and the linking will be an offset link. This is useful for comparing multiple studies that may not have the exact same coordinate sets. You'll scroll one set to approximately match the same set in another study and enable an offset link. You will then be able to scroll through it like a normal linked set.|
|When these localizer lines are enabled, the viewer will overlay a box on all the other open series showing where the selected image showes up on that series. Note that the box is not a measure of the thickness of the slice, it is an orthogonally-projected 3D display of the 4 connected corners of the slice. The lines will move on all the other sets as you scroll through a current set, and the lines will instantly switch over to represent a new set if you click a different window.|
|This toggles whether patient info is displayed or not. Tool Overlays are displayed regardless. To remove overlays, click the Reset button.|
|When this option is disabled (as by default,) when you perform any acts that require speedy image updates (scrolling, window/level, zoom, pan, etc.,) it will not bilinear filter the image until you release the mouse button (it will simply use nearest-neighbor stretching). If you enable this option, it will always use bilinear filtering. Note that enabling this option gives the viewer a rather significant speed hit.|
|This tool will log you out of MyFreePACS. This was only tossed onto this tool group for space reasons.|
|Chest: Window: 350, Level: 65|
|Lung: Window: 1500, Level: -600|
|Brain: Window: 80, Level: 40|
|Bone: Window: 2500, Level: 480|
The toolset I am referring to is the set of tools that are associated with mouse buttons. In the upper right of the window, you will see "Tool Select", under which are two buttons with 'L' and 'R' on them. These are the tools currently associated with the 'L'eft and 'R'ight mouse buttons. To change what tool is selected, hold the left mouse button down on either of the two buttons. A list of all available tools will then pop up. Move the mouse down to the tool you want to select and then release the mouse button. That tool will then be selected into that mouse button for use in the main viewer.
These are the tools currently included in the MyFreePACS Toolset:
|This tool will scroll through an image set. Hold the button down and move the mouse up and down. This will move forward and backward through the current image set. Note: moving the mousewheel has the same effect.|
|This tool will change the window and level of the selected image set. Holding the button down and moving the mouse vertically will change the level, and horizontally will change the window. If you don't window and level a set, the viewer will take the embedded suggested window and level from the image and use that for each image. After the first time you window and level a set, it will lock on whatever you set it to and use that for all the images. You can go back to the suggested levels by pressing the Reset button on the toolbar.|
|This tool will allow you to pan around an image. Click a point and drag it around to pan around that point. Once you pan a set once, it will hold that pan for the rest of the set. You can reset to the center by pressing the Reset button on the toolbar.|
|This tool will allow you to zoom in and out on an image. Click a point and move the mouse up and down to zoom in and out. Once you zoom a set once, it will hold that zoom for the rest of the set. You can reset to the standard setting of automatic zoom selection by pressing the Reset button on the toolbar.|
|This tool will measure the distance from one point to another in cm. Click down at one point, drag to another point, and release the button. To clear the line, either change images, hit Reset on the toolbar, or click with the line tool selected. Any line under 5 pixels will not be drawn. If you need to measure something more precise than 5 pixels on a view, zoom in before using the tool.|
|This is the 3D localization tool. When you have multiple sets open, you can click on an image with the localization tool, and all the other sets will then go to the closest image to that point, and highlight the point on the image closest to your selected point. This will work for all sets in all planes. Note that it requires the coordinate systems to be the same, so it will likely not work across multiple studies.|
|This is the Multi-Planar Reformation tool. When this tool is selected, it will force the viewer into a 2x2 array. Select the series you want to reconstruct from into one of the top two windows. After that, click and drag the MPR tool to create your MPR axes. The two axes will be perpendicular to each other. It will place the new generated sets in the lower windows. There may be a load time on larger sets as it loads the entire set into memory. (Before images are viewed for the first time, they are not loaded into memory.) It will then force the toolset to be MPR on the right mouse button and 3D localization on the left mouse button. You can then use the MPR-generated sets as you would use ordinary sets. You can use the MPR tool to drag new axes on the original set and it will instantly re-form the generated sets at bottom.|
|This tool will show the information about a selected point. Click on a point and it will show the raw image number at that point.|
|This tool will show the information about an oval area. Click and drag to make an oval. While dragging, it will show the current 2D area of the oval. After forming the oval, it will generate the mean and standard deviation of the data inside the oval.|