MSFCelestialArc

Objective-C


@interface MSFCelestialArc : MSFCelestialObject

Swift

class MSFCelestialArc : MSFCelestialObject

A curve drawn on the sky: a circle about an axis (a body’s daily path: axis = rotation axis, radius = 90 - declination), or an explicit list of directions. Width is in screen pixels.

  • Undocumented

    Declaration

    Objective-C

    -(id)init;

    Swift

    init!()

  • Defines the arc as a circle about an axis.

    Declaration

    Objective-C

    - (void)setCircle:(float)axisAzimuth
     axisAltitude:(float)axisAltitude
           radius:(float)radius;

    Swift

    func setCircle(_ axisAzimuth: Float, axisAltitude: Float, radius: Float)

    Parameters

    axisAzimuth

    The azimuth of the axis in degrees, clockwise from north.
    axisAltitude

    The altitude of the axis in degrees above the horizon.
    radius

    The angular radius in degrees: the angle between the axis and the curve.

  • Defines the arc as an explicit list of directions, each an (azimuth, altitude) pair in degrees. The curve runs through them in order and is not closed.

    Declaration

    Objective-C

    - (void)setDirections:(MSFDoubleVector *)directions;

    Swift

    func setDirections(_ directions: MSFDoubleVector!)

    Parameters

    directions

    The directions, as alternating azimuth and altitude values in degrees.

  • Defines the arc as separate segments: every pair of directions is one line, consecutive pairs are not joined. Still one object: one draw call, one clickable thing.

    Declaration

    Objective-C

    - (void)setSegments:(MSFDoubleVector *)directions;

    Swift

    func setSegments(_ directions: MSFDoubleVector!)

    Parameters

    directions

    The directions, as alternating azimuth and altitude values in degrees.

  • Returns true if the directions are read as separate segments rather than as a path.

    Declaration

    Objective-C

    - (BOOL)isSegmented;

    Swift

    func isSegmented() -> Bool

    Return Value

    True if the arc is a segment list.

  • Returns the directions of an explicitly defined arc.

    Declaration

    Objective-C

    - (MSFDoubleVector *)getDirections;

    Swift

    func getDirections() -> MSFDoubleVector!

    Return Value

    The directions, as alternating azimuth and altitude values in degrees.

  • Returns the angular radius of a circular arc.

    Declaration

    Objective-C

    - (float)getRadius;

    Swift

    func getRadius() -> Float

    Return Value

    The angular radius in degrees.

  • Returns the line width.

    Declaration

    Objective-C

    - (float)getWidth;

    Swift

    func getWidth() -> Float

    Return Value

    The width in pixels.

  • Sets the line width. The default is 2.

    Declaration

    Objective-C

    - (void)setWidth:(float)pixels;

    Swift

    func setWidth(_ pixels: Float)

    Parameters

    pixels

    The width in pixels.

  • Returns whether the part of the curve below the horizon is drawn.

    Declaration

    Objective-C

    - (BOOL)isBelowHorizonVisible;

    Swift

    func isBelowHorizonVisible() -> Bool

    Return Value

    True if the curve is drawn below the horizon.

  • Sets whether the part of the curve below the horizon is drawn. The default is false.

    Declaration

    Objective-C

    - (void)setBelowHorizonVisible:(BOOL)visible;

    Swift

    func setBelowHorizonVisible(_ visible: Bool)

    Parameters

    visible

    True to draw the curve below the horizon.

  • Returns the click radius of the curve.

    Declaration

    Objective-C

    - (float)getClickRadius;

    Swift

    func getClickRadius() -> Float

    Return Value

    The click radius in degrees.

  • Sets the click radius: how far a touch ray may miss the curve and still hit it. 0 makes the curve unclickable. The default is 2 degrees.

    Declaration

    Objective-C

    - (void)setClickRadius:(float)degrees;

    Swift

    func setClickRadius(_ degrees: Float)

    Parameters

    degrees

    The click radius in degrees.

  • Undocumented

    Declaration

    Objective-C

    -(void)dealloc;

    Swift

    func dealloc()