<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSRulerMarker/init(rulerView:markerLocation:image:imageOrigin:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSRulerMarker(im)initWithRulerView:markerLocation:image:imageOrigin:"
  },
  "title" : "init(rulerView:markerLocation:image:imageOrigin:)"
}
-->

# init(rulerView:markerLocation:image:imageOrigin:)

Initializes a newly allocated ruler marker, associating it with (but not adding it to) a specified ruler view and assigning the attributes provided.

```
init(rulerView ruler: NSRulerView, markerLocation location: CGFloat, image: NSImage, imageOrigin: NSPoint)
```

## Parameters

`ruler`

The ruler view with which to associate the ruler marker. This method raises an `NSInvalidArgumentException` if `aRulerView`  is `nil`.

`location`

The x or y position of the marker in the client view’s coordinate system, depending on whether the ruler view is horizontal or vertical.

`image`

The image displayed at the marker location. This method raises an `NSInvalidArgumentException` if `anImage` is `nil`.

`imageOrigin`

The point within the image positioned at the marker location, expressed in pixels relative to the lower-left corner of the image.

## Return Value

An initialized ruler marker object.

## Discussion

The image used to draw the marker must be appropriate for the orientation of the ruler. Markers may need to look different on a horizontal ruler than on a vertical ruler, and the ruler view neither scales nor rotates the images.

To add the new ruler marker to `aRulerView`, use either of NSRulerView’s [`addMarker(_:)`](/documentation/AppKit/NSRulerView/addMarker(_:)) or [`trackMarker(_:withMouseEvent:)`](/documentation/AppKit/NSRulerView/trackMarker(_:withMouseEvent:)) methods. [`addMarker(_:)`](/documentation/AppKit/NSRulerView/addMarker(_:)) immediately puts the marker on the ruler, while [`trackMarker(_:withMouseEvent:)`](/documentation/AppKit/NSRulerView/trackMarker(_:withMouseEvent:)) allows the client view to intercede in the addition and placement of the marker.

A new ruler marker can be moved on its ruler view, but not removed. Use [`isMovable`](/documentation/AppKit/NSRulerMarker/isMovable) and [`isRemovable`](/documentation/AppKit/NSRulerMarker/isRemovable) to change these attributes. The new ruler marker also has no represented object; use [`representedObject`](/documentation/AppKit/NSRulerMarker/representedObject) to set one.

This method is the designated initializer for the NSRulerMarker class.

## See Also

[`image`](/documentation/AppKit/NSRulerMarker/image)

The receiver’s image.

  [Ruler and Paragraph Style Programming Topics](https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/Rulers/Rulers.html#//apple_ref/doc/uid/10000089i)

[`markerLocation`](/documentation/AppKit/NSRulerMarker/markerLocation)

The location of the receiver in the coordinate system of the ruler view’s client view.

[`imageOrigin`](/documentation/AppKit/NSRulerMarker/imageOrigin)

The point in the receiver’s image that is positioned at the receiver’s location on the ruler view.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)