xScope Home Page | xScope FAQ | Iconfactory Home Page
About xScope   xScope is an application that is ideal for designing, measuring, aligning and inspecting on-screen graphics and layouts. There are six tools that will help you do your job faster and produce more accurate results:
  • Rulers - On-screen rulers that measure distances and angles
  • Screens - A dynamic view of smaller screens and web browser content areas
  • Loupe - A magnifying glass that gives you a close-up view of your work
  • Guides - Markers for precise horizontal and vertical alignment
  • Frames - Markers for precise width and height alignment
  • Crosshair - Measures and aligns locations on-screen
The use of each tool is explained below—you can quickly jump to the description by clicking on its name in the list above. Please take a look at the Introduction before getting started.

In addition, we've included sections with Tips and Tricks and Keyboard Shortcuts.

Note: This page is displayed the first time you run xScope. If you need to refer to it again, choose Help from the xScope menu bar.

Registering   The cost to register xScope is only $14.95. Your registration helps support the Iconfactory and all the good things we do.

Register xScope

You will be reminded periodically to register your copy of xScope. The demo version of xScope expires after you have used it for 40 hours.

Introduction   In this tutorial, we'll introduce you to each of the tools in the xScope application.

To help navigate through the tutorial, we'll be using the toolbar: toolbar

If you don't see the toolbar on your screen for some reason, select Toolbar from the xScope Window menu. You can also press ⌘T (Command-T) to make the toolbar appear or disappear.

Rulers   The first tool we'll look at is Rulers. This tool provides a quick and easy way to measure both distance and angles on your screen.

The ruler icon on the toolbar looks like this: ruler

Click on this icon and you'll see two rulers appear: ruler

There are several controls which allow you to quickly configure these rulers:

  1. Adjusts the length
  2. Rotates the ruler
  3. Toggles the second ruler
The ruler also shows its length (d) and rotation (e).

When you are rotating the ruler, you can hold down the shift key and the position will be updated in 5º increments. Likewise, the shift key will adjust the length of the ruler in 10 pixel increments.

The preferences for Rulers allow you to display deltas on a rotated ruler. The deltas indicates the horizontal and vertical distance from the ruler origin (the point where the two rulers join) to the outer-most point on the ruler's edge.

When you are done with the ruler, you can click on its toolbar icon and it will be hidden until the next time you click on the icon.

Screens   Have you ever wondered how your design will look on a smaller screen? Or how much content area is available in IE 6 running on Windows? Screens has the answer.

When you click on this toolbar icon: screens

The Screens window will appear: screens

The controls are grouped into three tabbed sections:

  1. Adjusting the screen size
  2. Adjusting the Mac browser content area
  3. Adjusting the Windows browser content area
Each time you click on the screen size tab, it will switch to a new size. The "Custom" setting is defined in the preferences and allows you to set non-standard sizes like the PowerBook's 1280x854 screen or various PDA sizes (such as the Palm's 320x320.)

The area for browser content can be toggled off individually or as a group. When you click on the tab with the Mac icon, all of the content areas for Mac browsers will be turned on and off. Likewise, the Windows tab will toggle all of the PC browsers. This makes it easy to switch platforms.

When you click and highlight one of the browser names, you'll include its content area in the window. Sometimes, selecting one of the browser names will not adjust the display of the content area— this is because the browser's content area is larger than what is already shown in the Screens tool. The displayed content area is always the minimum size available, allowing you to maximize your design to fit within a space common to all the selected browsers.

Note: The content areas for each of the browsers is for default settings. Users can (and do!) adjust their toolbars, start menus, and other UI elements. The content areas should be used as a guideline, not as an exact measurement.

Like the other xScope tools, you can click on the Screens icon again to hide the window. This is a convenient way to "clean up" before you go back into your development environment to make any necessary changes. When you're ready to test again, just click on the Screens icon and away you go!

Loupe   Sometimes, you've got to get things pixel perfect in a design. Like the days when layouts were done on acetate, it's essential to have a tool that let's you magnify your work. Enter the Loupe tool: loupe

After clicking on this icon, you'll see the following window appear: loupe

By default, the Loupe tool follows your mouse. Getting a close-up view of your design is as simple as pointing at it. As your mouse travels across the desktop, you'll see the following information updated:

  1. HTML color value
  2. RGB color value (both as 0-255 values and percentages)
  3. HSB color value
  4. Mouse position
You can click in the lower right-hand corner (e) to adjust the Loupe window size.

There are also several options for adjusting the Loupe. Under Loupe in the menu bar, you'll find options to adjust the magnification level (200% to 800%) and display grid or center lines.

The "Avoid Mouse" option causes the Loupe window to automatically move away from the current mouse position. This can be convenient when you are examining a large design—it keeps the Loupe's display out of the way.

It is often useful to copy the Loupe's information into another application. There are keyboard shortcuts to copy both the magnified image (⌃⌘C) and the color values (⇧⌘C) to the clipboard. You can adjust the format of the copied color value with preferences—the default is HTML.

Finally, it can be useful to either "freeze" or "lock" the Loupe tool. When you freeze the Loupe, you get a snapshot of whatever is currently displayed. Locking the Loupe continues to update the display, but ignores any further mouse movements. Locking is handy if you are making changes to a design and want to see an update without repositioning the mouse.

And, of course, you can easily toggle this tool on and off using the toolbar.

Guides   Alignment. All good design requires it. And not all applications give you the tools do it.

The Guides tool allows you to align elements on your screen regardless of the application you are using. Here is the tool in the toolbar: guides

The first thing you'll want to do when using this tool is to create a new guide. The following methods can be used:

Use the Guides Wizard

The easiest way to create a new guide is to use the Guides Wizard. Just press ⌘G to display the wizard's dialog.

In this dialog, you have a choice to create the guide visually or numerically. The visual method lets you click anywhere on the screen to create a horizontal or vertical guide. The numeric method lets you enter exact coordinates for one or more guides.

When you are using the visual method, the screen will dim slightly to let you know that the tool is waiting for a mouse click. After you click on the dimmed screen, a new guide will be created.

Use the Menu

You can create a horizontal or vertical guide using the menu and shortcut keys.

Try this: position your mouse over the top of something on screen and press ⇧⌘H. You'll now have a new horizontal guide under your mouse. You can use ⇧⌘V to create a vertical guide with the same technique.

Now that you have created some guides, you'll see these controls on each: guides

  1. Removes the guide
  2. Adjust the guide position
When you adjust the guide, you'll see a number appear—this is the guide's position in pixels measured from the top-left corner of the screen.

After you've created all of your guides, you can save them in a file for later use. There are menu options, under Guides in the menu bar, that allow you to save and open guides. When you open a file with guides, you have an option to add them to the existing ones on screen. By default, the current guides will be removed before the new guides are loaded.

You can manually remove your guides one at a time using the icon shown above. There's also a menu item to remove all guides.

One final note before we move onto the next tool: you can easily toggle the guides on or off using the toolbar. Guides are useful when you are aligning objects, but can get in the way of design work. A quick toggle is all you need to get your screen back to normal.

Frames   We've just described guides and how they can be used for doing horizontal and vertical alignment. Now we'll add another dimension with the Frames tool: frames

This tool is ideal for tasks where you are working with areas: creating a UI in a fixed window size, visualizing a CSS box definition, or any other measurement that requires an origin (x,y) and size (width, height.)

As with guides, there are several ways to create a frame:

Use the Frames Wizard

The wizard makes it easy to create a new frame. Just press ⌘F to get things started.

The wizard dialog gives you two choices for creating a frame: Numeric and Visual. The numeric method can be used when you have the exact dimensions of a design element. If you want to draw the frame interactively, use the visual method.

When you choose the visual method, the screen will dim and wait for you to click and drag the mouse. The frame's origin (upper-left corner) will be where the click begins; the width and height is determined by how far you drag down and to the right.

Use the Menu

There is a shortcut key for creating a new frame. Just press ⇧⌘F to create a frame at the center of the screen.

Frames have several controls that allow you to manipulate the size and position: frames

  1. Removes the frame
  2. Adjusts the frame position
  3. Creates a copy of the frame
  4. Adjusts the frame size
When you adjust the frame's position, you'll see a number appear—this is the distance in pixels measured from the top-left corner of the screen. The width of the frame is always displayed along the bottom edge; the height is on the right edge.

You can use the menu options, located under Frames in the menu bar, to save and open files with frames. The option to add to the existing set of frames can also be used (it is turned off by default.)

The "Remove All Frames" menu item lets you quickly remove all frames.

And, if you weren't already getting bored with the similarity of frames to guides, the toggle feature in the toolbar can hide the frames.

Crosshair   The last tool in the xScope bag of tricks is the Crosshair. This is a simple tool that helps you locate and align points on screen. Just click on this toolbar icon to activate the Crosshair: crosshair

The Crosshair that appears looks like this: crosshairs

  1. The guides (horizontal and vertical)
  2. The position

By default, the Crosshair tool reports positions relative to the upper left-hand corner of the screen. You can, however, set any point as the origin—this allows you to get positions that are relative to an arbitrary point on the screen.

A good example of this is getting a point within the bounds of the ruler. If you have the Rulers tool displayed, you can select the "Center Follows Ruler" option from the Crosshair menu. After enabling this option, the position of the crosshair will always be relative to the point where the rulers are joined.

Alternatively, you can use ⌘0 (Command-Zero) to set the Crosshair origin using the current mouse position. After the new origin is set, the tool will display the offset from that position.

By default, the crosshair will appear no matter which application you are using. In some cases, this can be distracting; you can set a preference to hide the crosshair when xScope is in the background.

Finally, you'll find that the Crosshair tool is most effective when used in conjunction with the other tools. In addition to using it with the Rulers (as described above), try turning on the Loupe to get a close up of the current position. The Guides and Frames tools can also benefit from a crosshair—allowing quick position measurements without creating a new guide or frame.

Tips and Tricks  
Menu bar icons

You can configure the menu bar to show an icon for each of the xScope tools. This provides a quick and easy way to access the tool while using another application.

To add the icons, go to the General preference panel and enable the menu bar icons. You can then select any combination of tools to appear in the menu bar.

Note: The menu bar icons are designed to leave the current application in the foreground. This allows you to keep working in your development application (such as an HTML editor, web browser, or UI design tool) without having to switch applications.

When you want xScope to become the front-most application, you can click on its dock icon. This behavior can be changed with General preferences—there is an option to make xScope the front-most application whenever a tool is accessed.

Hotkeys

Use the General panel of xScope preferences to enable the global hotkeys. This allows you to access the tools from any application by pressing a key combination.

Note: Since the hotkeys are global, they may interfere with the keys used by other applications. If you encounter a conflict, use the preferences to choose another hotkey.

Running xScope without a dock icon

Normally, xScope displays with an icon in the dock. You can configure xScope to run as an application in "background mode" which will prevent the application icon from appearing in the dock.

When you run an application in background mode, you need to be aware of several limitations:

  • There is no menu bar for the application. The command keys will still work, so you can quit the application (Command-Q) or display preferences (Command-Comma). In order for these keys to work, you must click on one of the tools (such as the ruler) to make sure that xScope is the frontmost application.
  • xScope will not appear in the Force Quit menu when you use Command-Option-Escape. You will need to use a Terminal window to manually kill the xScope process.
  • Since the changes required are to the application's configuration, all users on the machine must use xScope in background mode.
Before making the change to background mode, make sure that you have configured hotkeys or the menu bar icons to access the tools.

To configure xScope to run in background mode, open the application package using a control-click on the application icon and selecting "Show Package Contents". Find the Info.plist file in the Contents folder and open it with TextEdit. Locate the LSUIElement and change the "<string>0</string>" to "<string>1</string>". Save the file and return to the Contents folder.

If you are running on Mac OS X 10.2, can just restart xScope at this point. If you are running on 10.3 or later (Panther or Tiger), the Launch Services information contained in the Info.plist file is cached, so you'll need to create a new application and update the cache. The easiest way to do this is to select xScope in the Finder and duplicate the file (using Command-D.) Then launch the new file (xScope copy) and verify that it is not displayed in the Dock. At this point, the cache has been updated, so you can quit xScope and return to the Finder. Delete the original xScope file and rename "xScope copy" to "xScope".

If you decide you don't want to run in background mode, change the LSUIElement back to it's original value of "0".

Keyboard Shortcuts   In the tables below, the ⌘ symbol represents the command key (next to the space bar on the keyboard.) The Control key is shown as a caret (⌃). Other symbols are ⌥ for the Option key and ⇧ for the shift key.

⌘F1 Show or hide the Rulers tool
⌘E Toggles ruler extension
⌘→ Rotate ruler 30º clockwise
⌘← Rotate ruler 30º counter-clockwise
⌘↓ Rotate ruler 1º clockwise
⌘↑ Rotate ruler 1º counter-clockwise
←, ↑, →, ↓ Arrow keys nudge ruler position by one pixel
⌘F2 Show or hide the Screens tool
⌘1 Set screen size to 640 x 480
⌘2 Set screen size to 800 x 600
⌘3 Set screen size to 1024 x 768
⌘4 Set screen size to custom size
⌘B Toggles browser content areas
⌘F3 Show or hide the Loupe tool
⌘= Zoom in (plus sign to increase magnification)
⌘- Zoom out (minus sign to decrease magnification)
⌘L Lock position of loupe and continue display updates
⌘D Freeze display (no updates)
⇧⌘C Copy color at center of loupe to clipboard
⌃⌘C Copy image of loupe to clipboard
⌘F4 Show or hide the Guides tool
⌘G Open guide wizard
⇧⌘H Create horizontal guide under mouse
⇧⌘V Create vertical guide under mouse
⌘ drag Holding down the command key will drag all guides at once
⌘F5 Show or hide the Frames tool
⌘F Open frame wizard
⇧⌘F Create frame guide under mouse
⌘ drag Holding down the command key will move all frames at once
⌘F6 Show or hide the Crosshair tool
⌥⌘P Show mouse position with crosshair
⌘0 Set crosshair origin (zero point)
⌘T Toggle the toolbar window
Known Problems The following are known issues in this release of xScope.

Ruler redraw error If you have deltas turned on in the Ruler and make the length of the ruler shorter than the text, the text will be displayed outside of the ruler. The text will also be left on the display as you rotate the ruler. If this happens, just turn off the ruler and turn it back on to refresh the display.

For the latest information, please check the product and FAQ pages on our website.


Contact Us The Iconfactory - webmaster@iconfactory.com

Technical Support - xscope@iconfactory.com
Copyright © 2003 ARTIS Software and The Iconfactory. All rights reserved.