tftdrv

type ByteNWriter ¶

type ByteNWriter interface {
	WriteByteN(b byte, n int)
}

ByteNWriter is an optional interface that may be implemented by DCI to speed up drawing some colors (gray colors in case of 18/24-bit pixel format and some other in case of 16-bit pixel format).

WriteByteN writes n times the byte to the display controller using data transfer mode.

type Ctrl ¶

type Ctrl struct {
	StartWrite func(dci DCI, reg *Reg, r image.Rectangle)
	Read       func(dci DCI, reg *Reg, r image.Rectangle, buf []byte)
	SetPF      func(dci DCI, reg *Reg, size int)
	SetDir     func(dci DCI, reg *Reg, dir int)
}

Ctrl contains display specific control functions.

type DCI ¶

type DCI interface {
	// Cmd writes len(p) bytes from p to the display controller using command
	// transfer mode. The dataMode parameter describes the direction of possible
	// data transfer which together with p forms a complete write or read
	// transaction.
	Cmd(p []byte, dataMode int)

	// WriteBytes writes len(p) bytes from p to the display controller using
	// data transfer mode.
	WriteBytes(p []uint8)

	// ReadBytes reads len(p) bytes into p from the display controller using
	// data transfer mode. Some displays are write-only so the implementation
	// designed exclusively for write-only displays may do nothing.
	ReadBytes(p []byte)

	// End ends the conversation with the display controller. The undelying
	// shared communication interface can be used by another application until
	// next command.
	End()

	// Err returns the saved error and clears it if the clear is true.
	Err(clear bool) error
}

DCI defines the basic Display Controller Interface.

type Driver ¶

type Driver struct {
	// contains filtered or unexported fields

} // ont 32-bit MCU the size of this struct is 256 B, a full 256 B allocation unit (see runtime/sizeclasses_mcu.go)

Driver implements pix.Driver interface with a limited support for draw.Over operation. It is designed for write-only displays (doesn't use DCI.ReadBytes method) so the alpha blending is slow and reduced to 1-bit resolution. Use DriverOver if the full-fledged Porter-Duff composition is required and the display supports reading from its frame memory.

func New(dci DCI, w, h uint16, pf PF, ctrl *Ctrl) *Driver

func (d *Driver) Draw(r image.Rectangle, src image.Image, sp image.Point, mask image.Image, mp image.Point, op draw.Op)

func (d *Driver) Err(clear bool) error

func (d *Driver) Fill(r image.Rectangle)

func (d *Driver) Flush()

func (d *Driver) Init(cmds []byte)

func (d *Driver) SetColor(c color.Color)

func (d *Driver) SetDir(dir int) image.Rectangle

type DriverOver ¶

type DriverOver struct {
	// contains filtered or unexported fields

} // ont 32-bit MCU the size of this struct is 256 B (bufLen=222), a full 256 B allocation unit (see runtime/sizeclasses_mcu.go)

DriverOver implements pix.Driver interface with the full support for draw.Over operator. The DCI must fully implement ReadBytes method to read the frame memory content. If the display has write-only interface use Driver instead.

func NewOver(dci DCI, w, h uint16, pf PF, ctrl *Ctrl) *DriverOver

func (d *DriverOver) Draw(r image.Rectangle, src image.Image, sp image.Point, mask image.Image, mp image.Point, op draw.Op)

func (d *DriverOver) Err(clear bool) error

func (d *DriverOver) Fill(r image.Rectangle)

func (d *DriverOver) Flush()

func (d *DriverOver) Init(cmds []byte)

func (d *DriverOver) SetColor(c color.Color)

func (d *DriverOver) SetDir(dir int) image.Rectangle

func (d *DriverOver) Size() image.Point

type PF ¶

type PF byte

PF describes pixel data formats supported by display cpntroller.

type Reg ¶

type Reg struct {
	PF   [1]byte // pixel format related register
	Dir  [1]byte // direction/orientation related register
	Xarg [4]byte // scratch buffer to avoid allocation
}

Reg contains local copy of some controller registers to allow working with write-only displays.

type StringWriter ¶

type StringWriter interface {
	WriteString(s string)
}

StringWriter is an optional interface that may be implemented by DCI to speed up drawing of immutable images.

WriteString writes len(s) bytes from s to the display controller using data transfer mode.

type WordNWriter ¶

type WordNWriter interface {
	WriteWordN(w uint16, n int)
}

WordNWriter is an optional interface that may be implemented by a DCI to improve drawing pertformance in case of 16-bit pixel format.

WriteWordN writes n times the 16-bit word to the display controller using data transfer mode.