PixelStick Manual

Measure Distance (Pixels), Angle (Degrees) and Color (RGB)
Anytime, Anywhere on the Mac

By Plum Amazing

Originally by Ryan Leigland
2012-13 Updates by Mark Fleming
2014-17 Updates by Bernie Maier

Version Changes
Latest Download on Plum Amazing

Overview

PixelStick is a tool for measuring distances (in pixels), angles (in degrees)  and colors (RGB) on the screen. Photoshop has distance, angle and color tools but they only work in Photoshop. PixelStick works in any app, between app, in the Apple Finder in addition it is lightweight, handy, fast and inexpensive. Excellent for designers, navigators, mapmakers, biologists, astronomers, cartographers, graphic designers or anyone who uses a microscope or telescope or wants to measure a distance on their screen in any window or application. PixelStick is a sophisticated ruler, protractor and eyedropper that works anywhere that you do on your Mac.

Da Vinci’s Vitruvian Man illustrates the ratios of the dimensions of the human body; a human figure is often used to illustrate the scale of architectural or engineering drawings.

Measurement can be defined as ..

…the comparison of ..

…an unknown quantity of some physical quality/dimension/phenomena…

..with..

.. a known, pre-selected value of the same physical quality/dimension/phenomena, called the Unit..

..So that we can find out how many iteration or fractions of the unit..

..are contained in the unknown quantity.

Or..

… So that we can find out how many repeations of the unit equals the unknown quantity.

Once again, with no breaks

Measurement can be defined as the comparison of an unknown quantity of some physical quality/dimension/phenomenon with a known, pre-selected value of the same physical quality/dimension/phenomena, called the Unit so that we can find out how many iteration or fractions of the unit are contained in the unknown quantity Or so that we can find out how many repeations of the unit equals the unknown quantity. -Nadia Nongzai on Quora

When you can measure what you are speaking about, and express it in numbers, you know something about it, when you cannot express it in numbers, your knowledge is of a meager and unsatisfactory kind; it may be the beginning of knowledge, but you have scarely, in your thoughts advanced to the level of Science. – William Thomson, Lord Kelvin

Accurate measurement is essential in many fields, and all measurements are necessarily approximations.

PixelStick measures pixels and the distance between pixels. The relation between pixels and whatever you are measuring is scale. It is measurement by comparison. In this way PixelStick can measure distance between galaxies planets, countries, cities, people, molecules, atoms or various sub-atomic particles in a photo if the scale is known. It is the same as the use of scale in a map. In a map you can look at the bottom right and see the scale which might be 1 in/1 mile. On that map cities that are 5″ apart are 5 miles from one to the other. Custom scales are available are available in PixelStick and can be used by astronomers, microbiologists, etc.

PixelStick is a utility that allows easily measuring distances and angles on your screen, zooming in under the cursor to show colors and allows copying those colors in 7 formats (CSS, HTML and several RGB integer and hex variations) in any application, window and across the desktop. In addition it does scaling so if you know the scale of a document you can measure its contents. Out of the box its measurements will work with Google Maps, Yahoo Maps and Photoshop. Since there is no standardized scale for arbitrary documents on the Mac, for other documents you can create customized scaling options in PixelStick that it can use in its measurements.

Most of what PixelStick does is obvious. Drag the endpoints to change the distance or angle. Click the locks or hold down the shift key to constrain the distance or angles.

manual

How PixelStick behaves when you have more than one screen depends on your version of macOS/OS X. OS X Mavericks introduced a user preference to allow screens to have separate spaces. When this preference is set (it set on by default in OS X Yosemite), application windows cannot span multiple screens. Therefore, PixelStick can only measure on one screen at a time when this preference is set. You can switch which screen PixelStick is measuring on by dragging the midpoint (i.e. the square) between screens. You can also use the Reset Position menu item on the copy of the menu on screen you want to measure on; if the PixelStick menu is not visible on that screen you can just drag the palette to that screen.

When the screens have separate spaces preference is not set, or when PixelStick is running on older versions of macOS, PixelStick spans all available screens.

Requirements

PixelStick requires Mac OS X 10.6 or later.

Coordinate System

manual

PixelStick uses a coordinate system like the macOS coordinate system. X can be seen as width and y as height. This means that the origin (pixel 0,0) is at the lower left corner of the screen. However, macOS deals mainly in points, whereas PixelStick is all about pixels since pixels are easier to visualise when describing a document on a screen. A point has no width and resides between pixels. Note that on modern hardware and modern macOS versions, these pixels are not necessarily the physical pixels on a display, especially a Retina display. macOS has scaling options that take away the direct correspondence between hardware pixels and what it reports to apps (like PixelStick) as pixels.

Distance 

PixelStick reports both pixel distance and pixel difference. When you see two numbers together in the user interface of PixelStick like this 230,114 it is (x, y) or (width, height).

manual

x starts at the bottom left of the screen.

The pixel distance includes the width of the PixelStick endpoints. This is so that the actual size of the item being measured is reported. The pixel difference merely subtracts the coordinates.

In the illustration to the right, the height of the picture is 13 pixels, so the distance is reported as 13.00. Note that if the diamond endpoint is at a position of y = 1, then the circle endpoint is at a position of y = 13. Thus pixel difference is 13 – 1 = 12.

Angles

By default, PixelStick reports the angle between the baseline (usually the horizontal line but if you set a new baseline, this is the dotted line) and the line made by the endpoints with values increasing as you move the diamond endpoint anticlockwise. The angle values can be positive or negative depending on the position of the diamond endpoint relative to the circle endpoint.

If you turn on Map Mode PixelStick changes the way it reports angles to be like bearings on a map. It reports angles using only positive values from 0 to 360 degrees, increasing clockwise. The baseline still defaults to horizontal or whatever you set it to last time. To set the baseline as north / south, just shift+drag the diamond endpoint to be above the circle endpoint and set the baseline, which is now a vertical line.

PixelStick Palette

manual

manual   Preferences – open and close the PixelStick prefs.
manual  Eyedropper – expands the palette to reveal the loupe and eyedropper tools.
manual     Help – opens this online manual.
manual    Screenshot
– The screen grab icon displays a window with a preview of the current contents of all screens. You can then click and drag to select the region of the screen to grab. PixelStick then prompts you for a location to save the image file containing the screen grab.
manual    Screen elements – The screen elements ruler icon allows you to measure elements that make up the windows of the currently running applications. To do this, you must give PixelStick permission to access macOS’s accessibility services. Once you have granted permission to use the accessibility services (either globally or just for PixelStick), the next time you click on the screen elements ruler icon various screen elements underneath the mouse cursor will be highlighted and PixelStick shows the dimensions of the highlighted element.
manual       Circle endpoint – draggable point of measuring. Shows x and y.
manual       Diamond endpoint – draggable point of measuring. Shows x and y.
manual  manual  Distance – pixel distance in pixels based on the circle and square endpoints.
manual  manual  Distance – locks the distance when rotating or adjusting the ruler.
manual       Delta – pixel difference between the circle/square endpoints in x and y values.
manual  manual  Angle – unlocked freely change the angle.
manual  manual  Locked Angle – click to lock maintains the same angle when adjusting the ruler.
manual  manual   Locked Snap – click to lock or hold shift key so rotation snaps to 45° increments.
manual        Unlock – Click the lock to lock/unlock.

TIP : Double click any measurement to select it and then copy to the clipboard.

Measurement Via Scalemanual

The PixelStick palette (seen above) displays your measurements.manual

The drop down menu (at the bottom of the palette above) displays ‘No scaling’ clicking it reveals the items to the right.

Selecting Google Maps will allow you to scale the measurement for a particular zoom on google maps.

manualOr you can select custom and make a scale of your own which you can name and save

Q: Can i measure in millimeters?
A: 
PixelStick measures in pixels but it could measure anything but to do that it requires a scale. If I gave you a map with no scale, would you be able to tell me the real-world distance between two points? No. PixelStick can work and give you distances in maps when it knows the scale. The same is true for inches, miles or AU. This can be in the seen in the scaling dropdown menu of PixelStick which shows, Custom, Google Maps, Yahoo Maps and Photoshop. These we added and you can use custom to add your own scales.

Q: I’m an astronomer. How do I create a custom unit like AU for PixelStick and make 1 AU to be x pixels?
A: PixelStick has two ways to set scaling to custom units like AU. If you know how many pixels make up 1 AU, you can set the zoom factor directly. The zoom factor is the reciprocal of the distance in pixels. For example, if 1 AU is 100 pixels, the zoom factor is 1/100, i.e. .01. Select custom scaling and click on the Edit button or + button to add a new scale. In the Zoom field, enter 0.01. Click OK. Now, when you measure with PixelStick, the distance in your custom units is shown at the bottom of the panel in addition to the distance in pixels shown in the middle of the panel.

The other way is if you don’t know the exact scale, but you have a reference image where you can measure a known distance. You first use PixelStick to measure out on the screen a length of (say) 1 AU. Then select custom scaling and click on the Edit button or + button to add a new scale. In the Distance field, enter 1. Click OK. Now PixelStick will show the distance in your custom units is shown at the bottom of the panel as in the first example.

Q: When I set the Zoom or Distance field why do the other field changes automatically?
A: This is because of the two different ways you can specify a custom scale. Also, some users may just want a known zoom factor rather than alternative units, and so PixelStick allows the custom units to be set by either entering a zoom factor or by measuring a known length and entering that length.

Eyedropper

manualThe eyedropper icon leads you to the screen seen below.

manual

The point of the cursor is over a pixel and that area is magnified and the color is displayed. Below that you can choose from the drop down the color format to get that particular color number at the bottom.

Once the cursor point is over the color you want to capture select the text displayed in the palette and press Command+C to copy the number to the clipboard.

Menus

File

Preferences – See below for details.

Check for Updates – If you have the shareware version from us you can click this to check for new version. Getting fresh new versions right away is one very good reason to get your software direct from us.

Edit

Invert Colors – Inverts the colors.

Reset Position – If for some reason changing monitors puts the ruler out of your reach click this and it will center it on the screen.

Set Baseline – Sets the line between the two endpoints as the baseline against which angles are measured. This allows you to measure arbitrary angles, not just angles relative to the horizontal. PixelStick draws this baseline as a dotted line.

Map Mode – Changes the way angles are displayed in the palette: either increasing anticlockwise like on a regular geometric plane or (when map mode is on) increasing clockwise like bearings on a map.

Help – One way to get to this manual.

Preferences

manual

Activate app on click – Checking this means you can click on the ruler to bring the whole PixelStick app to the front. It is off by default because you can have the  app running and use the ruler to measure things in PhotoShop without pushing PhotoShop into the background.

Show loupe during drag – Check this option to be able to see the loupe that magnifies the area under the endpoint you are dragging.

Show grid in loupe – Check this option to add a grid to the loupe to help identify how the underlying pixels are magnified.

Draw guides during drag – Check this option to be able to see the guide lines when you are dragging the ruler around.

There are also options to choose the color of PixelStick’s endpoints plus the straight and circular guide lines and whether or not to display the guides.

In general changes take effect immediately, so you can try turning on/off and changing settings then try the ruler out to see how the preferences affect the way it works.

PixelStick Tips

  • When measuring, position the endpoints inside the area to be measured.
  • The easiest way to get both dimensions of an area is to position the endpoint exactly on top of the corner.
  • After measuring the height (see example), the circle endpoint can be dragged over to the other corner to get the width.

HotKeys

In the Pixelstick preferences set hotkeys for Show/Hide and to Center Ruler.

manual

Minimize Palette – double click title bar also hides guidelines.
Show/Hide Palette – hit the hotkey set in the preferences also hides guidelines.
Angle Lock – hold the shift key and it will lock every 45, 90 and 180 degree angles.
Invert Colors – control key and click to show the contextual menu.

* All of the below work when the Pixelstick app is the frontmost app.

Right, Left and Up, or Down Arrow Keys – moves the whole ruler 1 pixel in that direction.
Right, Left and Up, or Down Arrow Keys + Shift Key – moves the whole ruler 10 pixel in that direction.
Command + Left or Right Arrow Key – to have the square move 1 pixel away from the circle, so the ruler expands in size.
Command + Left or Right Arrow + Shift Key – to have the square move 10 pixel away from the circle., so the ruler expands in size.

Command + Up or Down Arrow Key –  to have the diamond rotate around the circle.
Command + Up or Down Arrow + Option Key – changes the angle, circle is the center and square is the part that moves 1 degree.
Command + Up or Down Arrow + Option + Shift Key – changes the angle., circle is the center and square is the part that moves 10 degree.

FAQ

Q: When I move the handles while holding down the shift key (so that the two handles are constrained to a horizontal line), I get two different numbers for the total-distance and component-distance.

An example would be in the screenshot provided. The distance shows 180.00, and the components read 179 and 0. Which is the right distance, and why is it different?
A: The answer is here under Distance.

Q: I am an orthopaedic surgeon and would like to measure the angle between the femur above and the tibia below. This is called the angle of knee flexion. How I can measure that angle with this software. Can you detail the steps?
A:  Pull up a photo of the item (femur, knee and tibia in this case) you want to measure the angle of and place the circle endcap of the pixelstick ruler on the knee, like the screenshot below. The circle is on the knee and the square on the femur and the angle reads -343.0907.

manual
To change this to 0.00 degrees (make sure that PixelStick is the frontmost app) then going up to the Edit menu in PixelStick choose ‘Set Baseline’ and you’ll see the angle change to 0.00 (screenshot below)

Swing the square endcap to the tibia. Below you see the angle is 137.2244 degrees.

It may be useful to use the hotkeys (above) to set the angle from the keyboard.

Q: Where are the preference files located?
A: They are here:
library/preferences/com.plumamazing.PixelStick.plist

Purchase

Please purchase PixelStick to remove all limitations and the dialog that comes up after 30 days, and to support the continuing evolution of PixelStick.

Plum Amazing Store

Thanks

The Folks at Plum Amazing
We appreciate suggestions and bug reports. Please write to us.