This is a child page. You can use Parent in the quick nav bar at the top or the bottom of the page to navigate directly back to the parent of this page. Some child pages are more than one level deep, and in that case will require more than one Parent click to reach the outermost document level.

§ 16.86 - Ruler

Quick Reference to Scripting Command
a=RULER(ALIGN, offset, start, NUMPRI, NEWIMAGE, nr, ng, nb, na, gr, gg, gb, ga, bar, bag, bab, baa, bor, bog, bob, boa)
Items in CAPS are 0/1 or ranges with more options than just 0/1.
Ranges other than 0/1 are indicated by brackets, such as [0-2].

Operation Example

The Ruler operator renders a ruler as long as the width or height of the selected image. The ruler measures pixels. Large gradients mark every 20 pixels, medium gradients mark every 10 and the small gradients mark every other pixel. This ruler can replace a part of the image or be rendered as an image all its own. This operator works with layered images. If you decide to create a new image from a layer you have the option of adding it to the layered image. Adding a new ruler to the layered image will bring it to the front immediately. The ruler does not display coordinates, that's already a feature of F/x. This operator provides the functionality of a real ruler for on-screen elements.

Ruler Operation Dialog

§ 16.86.1 - Ruler Controls

§ - Align

This orients the ruler. A bottom-aligned ruler will have gradients on the top, top-aligned will have gradients on the bottom, left-aligned will have gradients on the right and right-aligned will have gradients on the left. If new image is not chosen, it will align the ruler against it's corresponding edge. These rulers can be moved farther into the image with the offset option, more below.

§ - Offset

This option works only when the operator doesn't create a new image. If applicable, offset will move the ruler away from its starting position. Offset will never push the ruler off the edge of the image, any offset that would place the ruler past the edge will make it land on the opposite side.


Unless you want a ruler as a permanent part of your image, using offset isn't nearly as useful as creating a new ruler image inside a layer.

When you click on a layer image or a master image, the operator prompts you on whether or not you intend this to be part of the layered image, clicking yes will add it to the layered image on the top layer. Now you can move the ruler around, make it partially transparent, whatever you want.

More on layered images.

§ - Start

This number determines the number at the beginning of the ruler. From there, the ruler will measure normally. Choosing 8 would set the beginning value to 8, the 1st large mark would be 28, etc.

§ - Number Priority

This feature determines the order in which the elements of the ruler are drawn. If  Number Priority  is checked, it will draw in this order: background, border, numbers, then gradients. Otherwise, the ruler will be drawn in this order: background, gradients, numbers, border.

This is important because the border covers the bottom of the gradients and part of the numbers on the sides. If the color for both the border and the gradients/numbers are the same, the number priority is of no consequence. If the colors differ significantly, choosing number priority will put part of the gradients and part of the numbers on top of the border, so they will be more visible. If number priority is not chosen, the border will lay over everything on the edge of the ruler

§ - New Image

This checkbox determines if the operator will create a new image or draw the ruler over part of the image. Creating a new ruler image inside of a layered image will give you the option of making the ruler a new layer to the image. If the operation is working inside the TimeLine, no new image will be created, it will act as if  New Image  was not selected.

§ - Number, Gradient, Border and Background colors

This determines the color for any element of the ruler. You can choose any colors you want. The ruler defaults to a pale yellow background, black gradients numbers and outline, all opaque. Values for each color channel range from 0 to 255.

Keyboard Navigation
, Previous Page . Next Page t TOC i Index o Operators g Glossary
WinImages F/x, Morph and all associated documentation
Copyright © 1992-2007 Black Belt Systems ALL RIGHTS RESERVED Under the Pan-American Conventions
WinImages F/x Manual Version 7, Revision 6, Level A

Valid HTML 4.01 Loose

This manual was generated with wtfm
wtfm uses aa_macro and SqLite
aa_macro uses python 2.7
Page 168