AbstractColourBall

HspBall

public abstract class AbstractColourBall : IColourSpace

Represents an immutable, generic colour sphere with a normalised 4d coordinate. X equals longitude and ranges from zero to 360, Y equals latitude and ranges from -90 to +90, Z is a normalised perpendicular dimension used only by the texture cache, and W is always assumed to represent transparency.

Constructors

AbstractColourBall

protected AbstractColourBall(Nomen nomen, Point4d point, Colour colour, SphereRotation rotation = null)

Create a new sphere.

Parameters:

nomen (Nomen)	Description of ball.
point (Point4d)	Sphere coordinate.
colour (Colour)	Colour associated with coordinate.
rotation (SphereRotation = null)	Optional rotation.

Properties

Colour

public Colour Colour { get; }

Gets the colour currently selected.

Implements: Colour

Coordinate

public Point4d Coordinate { get; }

Gets or sets the sphere pivot location. The coordinate is normalised along all dimensions, with x representing the longitude, y the latitude, z the perpendicular and w the opacity.

Disc

public CircleF Disc { get; }

Gets the boundary of the disc. This field will be unset before the first paint.

Filter

public abstract NamedPalette Filter { get; set; }

Implements: Filter

Format

public abstract string Format { get; }

Format the current model.

Implements: Format

Icon

public abstract IIcon Icon { get; }

Implements: Icon

Nomen

public Nomen Nomen { get; }

Gets the description of this model.

Implements: Nomen

Pivot

public PointF Pivot { get; }

Gets the centre point of the pivot. This field will be unset before the first paint.

PivotVisible

public bool PivotVisible { get; }

Gets whether the pivot is on the visible part of the sphere.

Rotation

public SphereRotation Rotation { get; }

Gets the current rotation for this sphere.

Sphere

public Sphere Sphere { get; }

Gets the physical sphere.

Zoom

public float Zoom { get; }

Gets the zoom factor that was relevant during the most recent paint operation.

Methods

AssignSphereState

protected void AssignSphereState(Point4d point, Colour colour, SphereRotation rotation)

Most-derived type constructor invoke.

Parameters:

point (Point4d)	New point.
colour (Colour)	New colour.
rotation (SphereRotation)	Rotation.

Returns: Must return new instance of the derived type.

Draw

public void Draw(Context context, RectangleF bounds, ColourModelVisuals visuals)

Render this sphere into a graphics context.

Parameters:

context (Context)	Graphics context.
bounds (RectangleF)	Sphere bounds.
visuals (ColourModelVisuals)	Sphere drawing properties.

Implements: Draw

GetChannels

public abstract void GetChannels(out UiNumber channel1, out UiNumber channel2, out UiNumber channel3)

Gets the channel values of the current space.

Parameters:

channel1 (out UiNumber)	Properties of first channel.
channel2 (out UiNumber)	Properties of second channel.
channel3 (out UiNumber)	Properties of third channel.

Implements: GetChannels

GetTexture

protected abstract IMultiResolutionTexture GetTexture()

Gets the texture for the current projection.

Explicit

IColourSpace.RespondToMouseDown

object IColourSpace.RespondToMouseDown(PointF mouse, MouseButtons buttons)

Parameters:

mouse (PointF)
buttons (MouseButtons)

Implements: RespondToMouseDown

Explicit

IColourSpace.RespondToMouseMove

void IColourSpace.RespondToMouseMove(object mouseRecord, PointF mouse, MouseButtons buttons, Keys keys)

Parameters:

mouseRecord (object)
mouse (PointF)
buttons (MouseButtons)
keys (Keys)

Implements: RespondToMouseMove

Explicit

IColourSpace.RespondToMouseUp

void IColourSpace.RespondToMouseUp(object motionData, PointF mouse, MouseButtons buttons, Keys keys)

Parameters:

motionData (object)
mouse (PointF)
buttons (MouseButtons)
keys (Keys)

Implements: RespondToMouseUp

SetChannels

public abstract void SetChannels(UiNumber channel1, UiNumber channel2, UiNumber channel3)

Sets the three channel values.

Parameters:

channel1 (UiNumber)	First channel.
channel2 (UiNumber)	Second channel.
channel3 (UiNumber)	Third channel.

Returns: True if new channels were successfully applied, false if some rounding/clipping was required.

Implements: SetChannels

SetColour

public void SetColour(Colour colour)

Modify the point of this cube to match a certain colour.

Parameters:

colour (Colour)

Colour to match.

Returns: Modified cube.

Implements: SetColour

ToColour

protected abstract Colour ToColour(Point4d point)

Convert from sphere coordinate to colour.

Parameters:

point (Point4d)

ToPoint

protected abstract Point4d ToPoint(Colour colour)

Convert from colour to sphere coordinate.

Parameters:

colour (Colour)