Stars Docs
Fall 2026
API

# StarCoords

o1.stars.StarCoords
See the StarCoords companion object
class StarCoords(val `x`: Double, val `y`: Double)

A `StarCoords` object describes the location of a star on a two-dimensional star map. A location consists of two components, `x` and `y`, each of which has a value between -1.0 and +1.0. The x coordinate ranges from -1.0 at the very left of the map to +1.0 on the right; the y coordinate similarly ranges from -1.0 at the bottom to +1.0 at the top. For instance, a star with `StarCoords` of (0.0,0.0) appears at the exact center of the map.

## Parameters

x

  the x coordinate of a location on the star map, between -1.0 and +1.0

y

  the y coordinate of a location on the star map, between -1.0 and +1.0

## Attributes

Companion
  object
Graph
Supertypes
  class Object
  trait Matchable
  class Any

## Members list

### Value members

#### Concrete methods

def toImagePos(`image`: Pic): Pos

Converts this pair of star coords to the position (`Pos`) of a pixel within a given image (`Pic`). For instance, if this `StarCoords` represents the middle (0,0) of a star map, and a 400-by-400 pixel image is given, this method returns a `Pos` of (200,200). Another example: if this `StarCoords` is (-0.5,0.2) and the given image is a 1000-by-1000 pixel square, returns a `Pos` of (250,400).

Converts this pair of star coords to the position (`Pos`) of a pixel within a given image (`Pic`). For instance, if this `StarCoords` represents the middle (0,0) of a star map, and a 400-by-400 pixel image is given, this method returns a `Pos` of (200,200). Another example: if this `StarCoords` is (-0.5,0.2) and the given image is a 1000-by-1000 pixel square, returns a `Pos` of (250,400).

## Attributes

override def toString: String

Returns a string description of the star coords; e.g., "x=0.62, y=0.04".

Returns a string description of the star coords; e.g., "x=0.62, y=0.04".

## Attributes

Definition Classes
  Any

def xPercent: Double

Returns a value between 0 and 1 that indicates how many percent from the left this location’s x coordinate is. For example, 0.5 is halfway from the left.

Returns a value between 0 and 1 that indicates how many percent from the left this location’s x coordinate is. For example, 0.5 is halfway from the left.

## Attributes

def yPercent: Double

Returns a value between 0 and 1 that indicates how many percent from the top this location’s y coordinate is. For example, 0.25 is a quarter of the way down from the top.

Returns a value between 0 and 1 that indicates how many percent from the top this location’s y coordinate is. For example, 0.25 is a quarter of the way down from the top.

## Attributes

#### Concrete fields

val x: Double
val y: Double