_eve
– Low-level BridgeTek EVE bindings¶
The _eve
module provides a class _EVE which
contains methods for constructing EVE command
buffers and appending basic graphics commands.
-
class
_eve.
_EVE
¶ -
-
flush
(self) → None¶ Send any queued drawing commands directly to the hardware.
- Parameters
width (int) – The width of the grid in tiles, or 1 for sprites.
-
cc
(self, b: ReadableBuffer) → None¶ Append bytes to the command FIFO.
- Parameters
b (ReadableBuffer) – The bytes to add
-
AlphaFunc
(self, func: int, ref: int) → None¶ Set the alpha test function
- Parameters
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
Begin
(self, prim: int) → None¶ Begin drawing a graphics primitive
- Parameters
prim (int) – graphics primitive.
Valid primitives are
BITMAPS
,POINTS
,LINES
,LINE_STRIP
,EDGE_STRIP_R
,EDGE_STRIP_L
,EDGE_STRIP_A
,EDGE_STRIP_B
andRECTS
.
-
BitmapExtFormat
(self, format: int) → None¶ Set the bitmap format
- Parameters
format (int) – bitmap pixel format.
-
BitmapHandle
(self, handle: int) → None¶ Set the bitmap handle
- Parameters
handle (int) – bitmap handle. Range 0-31. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
BitmapLayoutH
(self, linestride: int, height: int) → None¶ Set the source bitmap memory format and layout for the current handle. high bits for large bitmaps
-
BitmapLayout
(self, format: int, linestride: int, height: int) → None¶ Set the source bitmap memory format and layout for the current handle
-
BitmapSizeH
(self, width: int, height: int) → None¶ Set the screen drawing of bitmaps for the current handle. high bits for large bitmaps
-
BitmapSize
(self, filter: int, wrapx: int, wrapy: int, width: int, height: int) → None¶ Set the screen drawing of bitmaps for the current handle
- Parameters
filter (int) – bitmap filtering mode, one of
NEAREST
orBILINEAR
. Range 0-1wrapx (int) – bitmap \(x\) wrap mode, one of
REPEAT
orBORDER
. Range 0-1wrapy (int) – bitmap \(y\) wrap mode, one of
REPEAT
orBORDER
. Range 0-1width (int) – drawn bitmap width, in pixels. Range 0-511
height (int) – drawn bitmap height, in pixels. Range 0-511
-
BitmapSource
(self, addr: int) → None¶ Set the source address for bitmap graphics
- Parameters
addr (int) – Bitmap start address, pixel-aligned. May be in SRAM or flash. Range 0-16777215
-
BitmapSwizzle
(self, r: int, g: int, b: int, a: int) → None¶ Set the source for the r,g,b and a channels of a bitmap
-
BitmapTransformA
(self, p: int, v: int) → None¶ Set the \(a\) component of the bitmap transform matrix
- Parameters
The initial value is p = 0, v = 256. This represents the value 1.0.
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
BitmapTransformB
(self, p: int, v: int) → None¶ Set the \(b\) component of the bitmap transform matrix
- Parameters
The initial value is p = 0, v = 0. This represents the value 0.0.
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
BitmapTransformC
(self, v: int) → None¶ Set the \(c\) component of the bitmap transform matrix
- Parameters
v (int) – The \(c\) component of the bitmap transform matrix, in signed 15.8 bit fixed-point form. Range 0-16777215. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
BitmapTransformD
(self, p: int, v: int) → None¶ Set the \(d\) component of the bitmap transform matrix
- Parameters
The initial value is p = 0, v = 0. This represents the value 0.0.
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
BitmapTransformE
(self, p: int, v: int) → None¶ Set the \(e\) component of the bitmap transform matrix
- Parameters
The initial value is p = 0, v = 256. This represents the value 1.0.
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
BitmapTransformF
(self, v: int) → None¶ Set the \(f\) component of the bitmap transform matrix
- Parameters
v (int) – The \(f\) component of the bitmap transform matrix, in signed 15.8 bit fixed-point form. Range 0-16777215. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
BlendFunc
(self, src: int, dst: int) → None¶ Set pixel arithmetic
- Parameters
src (int) – specifies how the source blending factor is computed. One of
ZERO
,ONE
,SRC_ALPHA
,DST_ALPHA
,ONE_MINUS_SRC_ALPHA
orONE_MINUS_DST_ALPHA
. Range 0-7. The initial value is SRC_ALPHA(2)dst (int) – specifies how the destination blending factor is computed, one of the same constants as src. Range 0-7. The initial value is ONE_MINUS_SRC_ALPHA(4)
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
Call
(self, dest: int) → None¶ Execute a sequence of commands at another location in the display list
- Parameters
dest (int) – display list address. Range 0-65535
-
Cell
(self, cell: int) → None¶ Set the bitmap cell number for the vertex2f command
- Parameters
cell (int) – bitmap cell number. Range 0-127. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
ClearColorA
(self, alpha: int) → None¶ Set clear value for the alpha channel
- Parameters
alpha (int) – alpha value used when the color buffer is cleared. Range 0-255. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
ClearColorRGB
(self, red: int, green: int, blue: int) → None¶ Set clear values for red, green and blue channels
- Parameters
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
ClearStencil
(self, s: int) → None¶ Set clear value for the stencil buffer
- Parameters
s (int) – value used when the stencil buffer is cleared. Range 0-255. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
ClearTag
(self, s: int) → None¶ Set clear value for the tag buffer
- Parameters
s (int) – value used when the tag buffer is cleared. Range 0-255. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
ColorA
(self, alpha: int) → None¶ Set the current color alpha
- Parameters
alpha (int) – alpha for the current color. Range 0-255. The initial value is 255
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
ColorMask
(self, r: int, g: int, b: int, a: int) → None¶ Enable and disable writing of frame buffer color components
- Parameters
r (int) – allow updates to the frame buffer red component. Range 0-1. The initial value is 1
g (int) – allow updates to the frame buffer green component. Range 0-1. The initial value is 1
b (int) – allow updates to the frame buffer blue component. Range 0-1. The initial value is 1
a (int) – allow updates to the frame buffer alpha component. Range 0-1. The initial value is 1
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
ColorRGB
(self, red: int, green: int, blue: int) → None¶ Set the drawing color
- Parameters
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
End
(self) → None¶ End drawing a graphics primitive
Vertex2ii()
andVertex2f()
calls are ignored until the nextBegin()
.
-
Jump
(self, dest: int) → None¶ Execute commands at another location in the display list
- Parameters
dest (int) – display list address. Range 0-65535
-
LineWidth
(self, width: int) → None¶ Set the width of rasterized lines
- Parameters
width (int) – line width in \(1/16\) pixel. Range 0-4095. The initial value is 16
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
Macro
(self, m: int) → None¶ Execute a single command from a macro register
- Parameters
m (int) – macro register to read. Range 0-1
-
PaletteSource
(self, addr: int) → None¶ Set the base address of the palette
- Parameters
addr (int) – Address in graphics SRAM, 2-byte aligned. Range 0-4194303. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
PointSize
(self, size: int) → None¶ Set the radius of rasterized points
- Parameters
size (int) – point radius in \(1/16\) pixel. Range 0-8191. The initial value is 16
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
ScissorSize
(self, width: int, height: int) → None¶ Set the size of the scissor clip rectangle
- Parameters
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
ScissorXY
(self, x: int, y: int) → None¶ Set the top left corner of the scissor clip rectangle
- Parameters
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
StencilFunc
(self, func: int, ref: int, mask: int) → None¶ Set function and reference value for stencil testing
- Parameters
func (int) – specifies the test function, one of
NEVER
,LESS
,LEQUAL
,GREATER
,GEQUAL
,EQUAL
,NOTEQUAL
, orALWAYS
. Range 0-7. The initial value is ALWAYS(7)ref (int) – specifies the reference value for the stencil test. Range 0-255. The initial value is 0
mask (int) – specifies a mask that is ANDed with the reference value and the stored stencil value. Range 0-255. The initial value is 255
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
StencilMask
(self, mask: int) → None¶ Control the writing of individual bits in the stencil planes
- Parameters
mask (int) – the mask used to enable writing stencil bits. Range 0-255. The initial value is 255
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
StencilOp
(self, sfail: int, spass: int) → None¶ Set stencil test actions
- Parameters
sfail (int) – specifies the action to take when the stencil test fails, one of
KEEP
,ZERO
,REPLACE
,INCR
,INCR_WRAP
,DECR
,DECR_WRAP
, andINVERT
. Range 0-7. The initial value is KEEP(1)spass (int) – specifies the action to take when the stencil test passes, one of the same constants as sfail. Range 0-7. The initial value is KEEP(1)
These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
TagMask
(self, mask: int) → None¶ Control the writing of the tag buffer
- Parameters
mask (int) – allow updates to the tag buffer. Range 0-1. The initial value is 1
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
Tag
(self, s: int) → None¶ Set the current tag value
- Parameters
s (int) – tag value. Range 0-255. The initial value is 255
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
VertexTranslateX
(self, x: int) → None¶ Set the vertex transformation’s x translation component
- Parameters
x (int) – signed x-coordinate in \(1/16\) pixel. Range 0-131071. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
VertexTranslateY
(self, y: int) → None¶ Set the vertex transformation’s y translation component
- Parameters
y (int) – signed y-coordinate in \(1/16\) pixel. Range 0-131071. The initial value is 0
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
VertexFormat
(self, frac: int) → None¶ Set the precision of vertex2f coordinates
- Parameters
frac (int) – Number of fractional bits in X,Y coordinates, 0-4. Range 0-7. The initial value is 4
This value is part of the graphics context and is saved and restored by
SaveContext()
andRestoreContext()
.
-
Vertex2ii
(self, x: int, y: int, handle: int, cell: int) → None¶ - Parameters
This method is an alternative to
Vertex2f()
.
-
cmd0
(self, n: int) → None¶ Append the command word n to the FIFO
- Parameters
n (int) – The command code
This method is used by the
eve
module to efficiently add commands to the FIFO.
-