_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
¶ -
register
(self, o: object)¶
-
flush
(self)¶ 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)¶ Append bytes to the command FIFO.
Parameters: b (ReadableBuffer) – The bytes to add
-
AlphaFunc
(self, func: int, ref: int)¶ 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)¶ 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)¶ Set the bitmap format
Parameters: format (int) – bitmap pixel format.
-
BitmapHandle
(self, handle: int)¶ 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)¶ Set the source bitmap memory format and layout for the current handle. high bits for large bitmaps
Parameters:
-
BitmapLayout
(self, format: int, linestride: int, height: int)¶ Set the source bitmap memory format and layout for the current handle
Parameters:
-
BitmapSizeH
(self, width: int, height: int)¶ Set the screen drawing of bitmaps for the current handle. high bits for large bitmaps
Parameters:
-
BitmapSize
(self, filter: int, wrapx: int, wrapy: int, width: int, height: int)¶ Set the screen drawing of bitmaps for the current handle
Parameters: - filter (int) – bitmap filtering mode, one of
NEAREST
orBILINEAR
. Range 0-1 - wrapx (int) – bitmap \(x\) wrap mode, one of
REPEAT
orBORDER
. Range 0-1 - wrapy (int) – bitmap \(y\) wrap mode, one of
REPEAT
orBORDER
. Range 0-1 - width (int) – drawn bitmap width, in pixels. Range 0-511
- height (int) – drawn bitmap height, in pixels. Range 0-511
- filter (int) – bitmap filtering mode, one of
-
BitmapSource
(self, addr: int)¶ 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)¶ Set the source for the r,g,b and a channels of a bitmap
Parameters:
-
BitmapTransformA
(self, p: int, v: int)¶ 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)¶ 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)¶ 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)¶ 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)¶ 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)¶ 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)¶ 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()
.- src (int) – specifies how the source blending factor is computed. One of
-
Call
(self, dest: int)¶ 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)¶ 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)¶ 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)¶ 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()
.
-
Clear
(self, c: int, s: int, t: int)¶ Clear buffers to preset values
Parameters:
-
ClearStencil
(self, s: int)¶ 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)¶ 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)¶ 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)¶ 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)¶ Set the drawing color
Parameters: These values are part of the graphics context and are saved and restored by
SaveContext()
andRestoreContext()
.
-
Display
(self)¶ End the display list
-
End
(self)¶ End drawing a graphics primitive
Vertex2ii()
andVertex2f()
calls are ignored until the nextBegin()
.
-
Jump
(self, dest: int)¶ Execute commands at another location in the display list
Parameters: dest (int) – display list address. Range 0-65535
-
LineWidth
(self, width: int)¶ 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)¶ Execute a single command from a macro register
Parameters: m (int) – macro register to read. Range 0-1
-
Nop
(self)¶ No operation
-
PaletteSource
(self, addr: int)¶ 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)¶ 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()
.
-
RestoreContext
(self)¶ Restore the current graphics context from the context stack
-
Return
(self)¶ Return from a previous call command
-
SaveContext
(self)¶ Push the current graphics context on the context stack
-
ScissorSize
(self, width: int, height: int)¶ 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)¶ 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)¶ 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()
.- func (int) – specifies the test function, one of
-
StencilMask
(self, mask: int)¶ 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)¶ 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()
.- sfail (int) – specifies the action to take when the stencil test fails, one of
-
TagMask
(self, mask: int)¶ 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)¶ 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)¶ 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)¶ 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)¶ 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)¶ Parameters: This method is an alternative to
Vertex2f()
.
-
Vertex2f
(self, b: float)¶ Draw a point.
Parameters:
-
cmd0
(self, n: int)¶ 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.
-
cmd
(self, n: int, fmt: str, args: Tuple[str, ...])¶ Append a command packet to the FIFO.
Parameters: Supported format codes: h, H, i, I.
This method is used by the
eve
module to efficiently add commands to the FIFO.
-