---
title: "init(rulerView:markerLocation:image:imageOrigin:)"
framework: appkit
role: symbol
role_heading: Initializer
path: "appkit/nsrulermarker/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.

## Declaration

```swift
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

Return Value An initialized ruler marker object.

## Discussion

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(_:) or trackMarker(_:withMouseEvent:) methods. addMarker(_:) immediately puts the marker on the ruler, while 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 and isRemovable to change these attributes. The new ruler marker also has no represented object; use representedObject to set one. This method is the designated initializer for the NSRulerMarker class.

## See Also

### Related Documentation

- [image](appkit/nsrulermarker/image.md)
- [Ruler and Paragraph Style Programming Topics](apple-archive/documentation/Cocoa/Conceptual/Rulers.md)
- [markerLocation](appkit/nsrulermarker/markerlocation.md)
- [imageOrigin](appkit/nsrulermarker/imageorigin.md)