displayp3

Documentation

Overview

Package displayp3 provides support for the Display P3 colour space.

Index

• Variables
• func EncodeColor(c color.Color) color.RGBA64
• func EncodeImage(dst draw.Image, src image.Image, parallelism int)
• func LineariseColor(c color.Color) color.RGBA64
• func LineariseImage(dst draw.Image, src image.Image, parallelism int)
• type Color
  • func ColorFromEncodedColor(c color.Color) (col Color, alpha float32)
  • func ColorFromLinear(r, g, b float32) Color
  • func ColorFromLinearColor(c color.Color) (col Color, alpha float32)
  • func ColorFromNRGBA(c color.NRGBA) (col Color, alpha float32)
  • func ColorFromRGBA(c color.RGBA) (col Color, alpha float32)
  • func ColorFromXYZ(c ciexyz.Color) Color
  • func (c Color) ToNRGBA(alpha float32) color.NRGBA
  • func (c Color) ToRGBA(alpha float32) color.RGBA
  • func (c Color) ToRGBA64(alpha float32) color.RGBA64
  • func (c Color) ToXYZ() ciexyz.Color

Variables

var PrimaryBlue = ciexyy.Color{X: 0.15, Y: 0.06, YY: 1}

var PrimaryGreen = ciexyy.Color{X: 0.265, Y: 0.69, YY: 1}

var PrimaryRed = ciexyy.Color{X: 0.68, Y: 0.32, YY: 1}

var StandardWhitePoint = ciexyy.D65

Functions

func EncodeColor

func EncodeColor(c color.Color) color.RGBA64

EncodeColor converts a linear colour value to a Display P3 encoded one.

func EncodeImage

func EncodeImage(dst draw.Image, src image.Image, parallelism int)

EncodeImage converts an image with linear colour into a Display P3 encoded one.

src is the linearised image to be encoded.

dst is the image to write the result to, beginning at its origin.

src and dst may be the same image.

parallelism specifies the degree of parallel processing; a value of 4 indicates that processing will be spread across four threads.

func LineariseColor

func LineariseColor(c color.Color) color.RGBA64

LineariseColor converts a Display P3 encoded colour into a linear one.

func LineariseImage

func LineariseImage(dst draw.Image, src image.Image, parallelism int)

LineariseImage converts an image with Display P3 encoded colour to linear colour.

src is the encoded image to be linearised.

dst is the image to write the result to, beginning at its origin.

src and dst may be the same image.

parallelism specifies the degree of parallel processing; a value of 4 indicates that processing will be spread across four threads.

Types

type Color

type Color struct {
	linear.RGB
}

Color represents a linear normalised colour in Display P3 space.

func ColorFromEncodedColor

func ColorFromEncodedColor(c color.Color) (col Color, alpha float32)

ColorFromEncodedColor creates a Color instance from a Display P3 encoded color.Color value. The alpha value is returned as a normalised value between 0.0–1.0.

func ColorFromLinear

func ColorFromLinear(r, g, b float32) Color

ColorFromLinear creates a Color instance from a linear normalised RGB triplet.

func ColorFromLinearColor

func ColorFromLinearColor(c color.Color) (col Color, alpha float32)

ColorFromLinearColor creates a Color instance from a linear color.Color value. The alpha value is returned as a normalised value between 0.0–1.0.

func ColorFromNRGBA

func ColorFromNRGBA(c color.NRGBA) (col Color, alpha float32)

ColorFromNRGBA creates a Color instance by interpreting an 8-bit NRGBA colour as Display P3 encoded. The alpha value is returned as a normalised value between 0.0–1.0.

func ColorFromRGBA

func ColorFromRGBA(c color.RGBA) (col Color, alpha float32)

ColorFromRGBA creates a Color instance by interpreting an 8-bit RGBA colour as Display P3 encoded. The alpha value is returned as a normalised value between 0.0–1.0.

func ColorFromXYZ

func ColorFromXYZ(c ciexyz.Color) Color

ColorFromXYZ creates a Display P3 Color instance from a CIE XYZ colour.

func (Color) ToNRGBA

func (c Color) ToNRGBA(alpha float32) color.NRGBA

ToNRGBA returns an encoded 8-bit NRGBA representation of this colour suitable for use with instances of image.NRGBA.

alpha is the normalised alpha value and will be clipped to 0.0–1.0.

func (Color) ToRGBA

func (c Color) ToRGBA(alpha float32) color.RGBA

ToRGBA returns an encoded 8-bit RGBA representation of this colour suitable for use with instances of image.RGBA.

alpha is the normalised alpha value and will be clipped to 0.0–1.0.

func (Color) ToRGBA64

func (c Color) ToRGBA64(alpha float32) color.RGBA64

ToRGBA64 returns an encoded 16-bit RGBA representation of this colour suitable for use with instances of image.RGBA64.

alpha is the normalised alpha value and will be clipped to 0.0–1.0.

func (Color) ToXYZ

func (c Color) ToXYZ() ciexyz.Color

ToXYZ returns a CIE XYZ representation of this colour.