Open topic with navigation

Understanding Reference Points

Reference points in BarTender help you to:

Each object or control has a unique object reference point as well as a unique template reference point that are configured separately from those of other objects or controls. For simplicity, the following discussion uses templates and objects to describe reference points, but all the information is also relevant to data entry forms and controls.

In the following images, the red boxes illustrate the reference point options and are for visual aid only. They do not appear on the actual template or object.

The following reference points are available:

ClosedTemplate Reference Point

The template reference point is any one of nine points on your design area that BarTender uses to place objects. You can select the template reference point for an object by using the Advanced Position Settings dialog. That object then is positioned on the template relative to the template reference point. The available template reference point options are shown as red boxes on the following image. Top Left is the default.

If the template is elliptical or has rounded corners, the nine possible reference points are the center and around the perimeter of an invisible rectangle whose lines intersect the template at its highest, lowest, rightmost, and leftmost points.

ClosedObject Reference Point

The object reference point is any one of nine points on your object that BarTender uses to place objects, relative to the template reference point. The object reference point is configured on the object's Position property page. The available object reference point options are shown as red boxes on the following image. Top Left is the default.

Reference points for barcode objects do not include the human readable area.

If the object is elliptical, has rounded corners, or is a shape other than a rectangle, the nine possible reference points are the center and around the perimeter of an invisible rectangle whose lines intersect the object at its highest, lowest, rightmost, and leftmost points.

If you use Snap to Object or Ruler to assist you in moving objects on your template, the object's reference point might be reset. For more information, refer to Object Snapping.

Using Reference Points to Position Objects

As previously noted, BarTender uses an object's reference point to place the object relative to its template reference point. How these two reference points position the object is determined by the object's X-coordinate and Y-coordinate, as configured on the object's Position property page. The X-coordinate is the distance of the object's reference point right or left from the template reference point. The Y-coordinate is the distance of the object's reference point up or down from the template reference point.

Negative values for the X-coordinate and Y-coordinate are supported. For more information about their impact on an object's position relative to the template reference point, see the Position property page.

When you update reference points, BarTender automatically updates the X-coordinate and Y-coordinate to values that reflect the object's current position rather than moving the object based on the new reference point.

Example:

The following image shows a 1 x 2 inch template. The object's template reference point is Top Left and the object's reference point is Top Left. The object's X-coordinate and Y-coordinate are each set to 0.5 inches. Based on these settings, the object's reference point is placed downward 1/2 inch and rightward 1/2 inch from the template reference point (the upper left edge of the template).

The following image shows the object placed at 1/4 inch from the top and left edge of the template. Although there are several ways this can be achieved, either of the following methods would place the object in the desired location: 

The object reference point for a line object will always be the center point of the line. Also, you are not required to specify the position of a line in terms of the X-coordinate and Y-coordinate of the object reference point relative to the template reference point. You have the option of using the X-coordinate and Y-coordinate of one or the other end point of the line (relative to the template reference point).