Fifo Logical Addresses for Control and Error Recovery

The present invention relates to video controllers, and more particularly to graphics processors for display of graphics.

High performance graphics processing commonly requires a separate graphics processor including a graphics engine, which may utilize a FIFO buffer, in communication with a host processor over a bus. Control over a graphics processor of this sort has been achieved by a variety of means, typically involving hardware configured to supervise the operation of the graphics engine.

In accordance with a preferred embodiment of the present invention there is provided an improved graphics processor of the type having a graphics engine and a graphics FIFO buffer in communication with the graphics engine. The buffer is also in communication with a host processor over a bus so as to provide request code and data from the host processor to the graphics engine. The improvement utilizes a plurality of logical FIFOs, including a normal FIFO and a protected FIFO, having addresses all mapping to the same physical graphics FIFO buffer. User access via an application is provided only to the normal FIFO, whereas system level code is provided access to all of the logical FIFOs, so that the protected FIFO can be used for control of the graphics processor. In a further embodiment, a logical sync FIFO is employed also. The sync FIFO is used in error recovery to receive and store a request that can be detected by the graphics engine as a cue to restart normal processing. Related methods are also provided.

FIG. 1 is a block diagram of showing modules of a video graphics processor-controller in accordance with a preferred embodiment of the present invention;

FIG. 2 is a block diagram of a graphics processor system in accordance with a preferred embodiment of the present invention;

FIG. 3 is a block diagram of a frame buffer system in accordance with a preferred embodiment of the present invention.

Disclosure generally pertinent to the context of the present invention is contained in the following related applications, all filed on the same day as the application herewith, and having the same assignee as the present application: "Apparatus and Method for A High-Performance Video Controller," Ser. No. 08/432,106 for an invention of William Steve Pesto, Jr.; "Vertex List Management System," Ser. No. 08/432,314 for an invention of Jeffrey J. Holt; "Video Stream Data Mixing for 3D Graphics Systems," Ser. No. 08/431,821, for an invention of David W. Young and Jeffrey J. Holt; "Graphics Processing with Efficient Vector Drawing," Ser. No. 08/432,820, for an invention of Jeffrey J. Holt; "Direct Access to Slave Processor by Unprotected Application Using Context Saving and Restoring," Ser. No. 08/431,820, for an invention of David W. Young; and "System and Method for Controlling A Slave Processor," Ser. No. 08/432,272, for an invention of David W. Young and Jeffrey J. Holt. These related applications are hereby incorporated herein by reference.

I. ARCHITECTURE.

A preferred embodiment of the present invention has been implemented in a graphics controller-processor having the general structure shown in FIG. 1. This embodiment is suitable for use with computers, such as those utilizing the Intel family of 80X86 processors (including the Pentium), running an operating system such as Microsoft Windows NT, designed to communicate over a PCI (Peripheral Component Interchange) Local Bus, pursuant to the PCI Local Bus Specification version 2.0 (Apr. 30, 1993) published by PCI Special Interest Group, M/S HF3-15A, 5200 N. E. Elam Young Parkway, Hillsboro, Oreg. 97124-6497, which is hereby incorporated herein by reference. However, the embodiment may also be configured, for example, to operate in an X-windows Unix environment, and on other buses, such as VL (VESA local bus). There are different implementations of this embodiment's architecture that may have reduced functionality and/or plane sets.

The architecture can be broken down into six basic subsystems. Of these two are optional. The basic system has a graphics engine 12 that accepts requests via a FIFO buffer 11. These requests are broken down by the graphics engine 12 into pixel requests, which are written over a wide high speed bus 17 to a set of resolvers 13, which in turn control reading and writing of the frame buffer 14. The back end subsystem 18 reads the frame buffer and displays it on the screen of a suitable monitor.

The texture processors 15 and roam processor 16 are optional subsystems. The roam processor subsystem includes its own resolvers 161 and roam frame buffer 162.

FIGS. 2 and 3 are more detailed block diagrams of a graphics processor system and a frame buffer system in accordance with the embodiment of FIG. 1 and are referred to in the discussion below. The rendering subsystem includes the PCI buffer 202, which is an ASIC, the DMA ASIC 211, graphics FIFO 21, and graphics engine ASIC 22. Rendering is the process of drawinig triangles, lines, and line strings. The rendering subsystem also performs region fill operations, but expands, and blit operations. Software on the host processor performs the necessary 3D transform and lighting calculations. These calculations result in vertex data which consists of coordinate (X,Y,Z) and color information (R,G,B,A). The host computer typically sends the vertex data to a buffer in main memory.

The vertex data enters the rendering subsystem through the PIC bus interface in the PCI buffer ASIC 202. The PCI buffer 202 ASIC provides an internal FIFO to allow PCI bus burst transfers. It also provides an interface to the expansion cable.

The DMA ASIC 211 is a multichannel, Direct Memory Access (DMA) engine capable of burst transfer for lengths of up to 4ME. The system software uses the DMA ASIC to transfer vertex data from main memory of the host computer to the graphics FIFO 21.

Graphics Engine

The graphics engine ASIC 22 is the main graphics processor and the core of the rendering subsystem. It takes vertex data from the graphics FIFO 21 and produces rendered spans of pixel data. The graphics engine ASIC 22 sends the data to the frame buffer subsystem over a high speed pixel path called the Image/Z (IZ) bus 27.

The graphics engine uses for major logic blocks to perform the pixel rendering. They are: (1) request handler, (2) slope calculation, (3) span generation, and (4) pixel interpolation.

Request Handler. The request handler monitors the output of the graphics FIFO 21 for data. When data arrives, the request handier analyzes it and writes it to an appropriate processing block. The request handler routes vertex data for triangles and lines to the slope calculation block. Drawing requests (other than vertex data for triangle and lines) such as blits, fills, and bit expands, bypass the slope calculation and span generation blocks. The request handler routes this data directly to the pixel interpolation block.

Slope Calculation. The slope calculation block performs the slope calculation part of the rendering process for triangles and lines. Floating-point math ensures the accuracy of triangle edges. The slope calculation block calculates color derivatives, depth derivatives, and edge slopes. It also adjusts the vertex data to a pixel center for the topmost vertex. The slope calculation block converts all data to a fixed-point format and routes it to the span generation block.

Span Generation. The span generation block performs the span calculation part of the rendering process for triangles and lines. The span generation block determines the leftmost x and y coordinates for each scan line in a triangle. It also calculates the initial color and depth value for each scanline, and routes the data to the pixel interpolation block.

Pixel Interpolation. The pixel interpolation block is common for all graphics drawing requests. For triangle meshes, the pixel interpolation block expands the data from the span generation block to pixel data by successively adding the x-derivative value to the initial color and depth values (z) for each span. The pixel interpolation block also maps the (x,y) address to a linear address before sending the address and pixel data to either the frame buffer or texture subsystem 250 over the IZ bus. The IZ bus 27 is a 64 bit, 256 MB per second bus with a pixel span protocol to facilitate high data throughput. This protocol allows burst transfers of pixel data to occur between the rendering subsystem and the frame buffer subsystem. The maximum burst size is 4096 pixels.

The graphics engine 22 is thus an ASIC that receives requests from a host processor via the PCI system bus 201. Requests are written to graphics FIFO buffer 21 and are read, decoded and executed by the graphics engine 22. Requests include graphic primitives (points, lines and triangles), rectangular fill, get/put pixel data, blits, and control requests.

These requests are broken down into "span" requests--requests to read or write a horizontal sequence of adjacent pixels. The span requests are written to the "IZ" bus 27. For requests which require read back data, such as register read or frame buffer read requests, an output FIFO is provided. Both the input and output portions of FIFO 21 are accessible by programmed or DMA transfers. DMA controllers 211 are provided on board.

The graphics engine also supports a second FIFC interface which can connect to a boardset enabling fast JPEG decompression and display to the frame buffer.

Graphics FIFO

The graphics FIFO buffer 21 is implemented in an unusual way on the input side to permit efficient control and error recovery. Although there is only a single physical FIFO used to receive requests, there are three logical FIFO addresses, all mapping to the same physical FIFO. The three logical FIFOs are "normal", "protected", and "sync". The normal FIFO is used for handling drawing onto the display screen. Whereas system level code has access to all three logical FIFOs, the user via the application can utilize only the normal FIFO.

The graphics FIFO 21 is implemented as 4.times.9 bit input FIFOs, giving a 36 bit bus between the PCI bus interface and the graphics engine. The low 32 bits of this bus correspond to the 32 bits of request code and/or data and are as defined in the section on requests. The 4 extra bits generated by the bus interface logic are defined as follows: ##STR1##

The P bit will be set if the data was written to one of the two protected logical FIFOs. This indicates to the graphics engine that it is OK to perform the request if it is one of the protected requests. The S bit will be set if the request was written to the sync FIFO address. This bit is monitored while flushing the FIFO. Note that the S bit is ignored unless the P bit is also set.

For diagnostic purposes. the two FIFOs can be turned around by setting FIFO.sub.-- TURN.sub.-- H in the CSR. In this mode all 36 bits of the input FIFO are read out and written to the output FIFO. As the output FIFO is read, the S and P bits above are latched and may be read back as the FF.sub.-- SYNC.sub.-- H and FF.sub.-- PROT.sub.-- H bits in the SSR.

Error handling in utilizing the sync FIFO is described in the last section, ERROR HANDLING below.

Resolvers

The four resolver ASICs 331-334 on the graphics processor board control the flow of data to and from the frame buffer memory. These resolvers provide a 256-bit frame buffer interface. This wide interface allows the embodiment to achieve a very high drawing bandwidth. The resolvers thus coordinate the movement of data from the frame buffer memory to the video selector and mapper (VSM) ASIC chips 381-388 and DAC 39 (digital to analog coiverter) in the display subsystem. The graphics engine ASIC 22 sends interpolated pixel data over the IZ bus 27 to the resolver ASIC's IZ input FIFO. The pixel data consists of color (Red, Green, Blue, and Alpha--RGBA) and depth (Z) data. The resolver IZ input FIFO is 128 words deep, so that the resolver can accommodate bursts of pixel data without slowing overall system performance.

The resolver examines pixel data from the input FIFO and determines if it should write the pixel data to the VRAM on the frame buffer board. The resolver performs Z, mask and alpha tests to determine if data should be written.

The resolver may perform an Arithmetic and Logic Unit (ALU) operation on a combination of the source data (data from the graphics engine) and the destination data (data in VRAM). The operations include logical operations, Porter and Duff style alpha blend operations, and OpenGL style alpha blend operations.

The resolver performs several different types of VRAM write cycles including reads, writes, or read-modify-writes. It maximizes memory bandwidth by choosing an appropriate type. The resolver performs block write cycles to maximize performance for window clear and fill requests.

The resolvers 331-334 are thus a set of identical ASICs that accept span requests over the IZ bus 27 and read from or write to the frame buffer formed by VRAM memory chips 341-314. They also perform the following tasks:

masking

alpha test

Z buffering

frame buffer merge (read/modify/write) operations:

X windows ALU operations

alpha blend operations

Frame buffer

The basic system contains one frame buffer--virtual screens are not supported--but in a typical embodiment 34 MB of memory is provided by 136 VRAMs, each VRAM having 2 megabits of memory. Each pixel in the frame buffer memory in this embodiment then has 126 bits or planes, as follows:

Image planes: double buffered 24 bit RGB planes. These can be used either as 24 bit RGB color, or any of the 3 groups of 8 can be used in pseudo color mode.

WID2: 4 bit single buffered Window ID planes associated with the image planes.

Image VLT context: 3 bit double buffered Video Lookup Table context select

Overlay planes: double buffered 8 bit pseudo color planes. These planes display if the value is non-transparent (selectable as 0 or 0.times.FF), otherwise the RGB planes "below" it display.

WID1: 4 bit single buffered window ID planes associated with the overlay planes.

Overlay VLT context: 1 bit double buffered video lookup table context select

Highlight plane: double buffered 1 bit highlight plane if non-transparent (selectable 0 or 1) this will display overriding both the RGB planes and the overlay planes.

WIDO: 4 bit single buffered window ID planes associated with the highlight plane.

8 bit single buffered alpha planes which are used by the resolver for alpha blend operations on the image planes

Z buffer: 32 bits single buffered. Z buffering can be enabled for writes to any of the planes.

mask planes: 6 mask planes are available. Any combination of 0 or more may be enabled for reads and/or writes. Mask plane 0 is designated as the "user mask plane" and intended for application use.

The WID bits allow window based double buffering on up to 15 different windows independently in each of the three sets of planes. They are also used to specify RGB to VLT routing for the image planes, and are used to allow roam buffer display in a window.

Most writes to the frame buffer are to a single "visual"--i.e. a single set of planes. For example, visual 2 is the image (RGB) set of planes, and visual 1 is the overlay set of planes.

Certain "implied" data may be written at the same time a write occurs to some visuals. The implied data comes out of a static register in the graphics engine (via the span header) and consists of the control data which is listed with the visible planes above--for example a write to the image planes can also write the WID2 bits and the image VLT context bits. Implied writes may be independently enabled or disabled via write enables.

Note that different implementations of this architecture may contain a subset of the above planes.

Back end

The back end has a set of VSMs 381-388 (Video Selector and Mapper) which drive RAM DACs 39 (Digital to Analog Converters), and the video timing logic. the VSM ASIC receives pixel data from the frame buffer. It selects which buffer (front or back), and which data (image or overlay), to display. The VSM uses the video selection planes to choose a VLT mapping if it decides to display image planes. The VSM sends the mapping result to the DAC on the processor board. The VSMs thus read the appropriate planes of the frame buffer, perform lookup through one of the 8 VLTs, and send RGB to the RAMDACs.

The DAC converts pixel data from the VSM to an analog voltage and sends it to a monitor 391 for display. The integrated DAC contains a Video Lookup Table (VLT) consisting of 256 locations.times.3 colors (RGB).times.10 bits per color used for gamma correction. The DAC also provides a user definable 64.times.64 pixel hardware cursor.

For each of the three plane sets (highlight, overlay and image) the WID bits associated with those planes are used to index into one of three small lookup tables. A bit in this LUT selects which buffer is to be displayed for that plane set. The LUT associated with the image planes also is used to specify routing between the RGB planes and the VLTs. The overlay VLT context bit is used to select between VLT context O and 1. The image VLT context bits can select any of the 8 VLT contexts available. All VLT contexts are capable of being specified as either pseudo color or true color when driven by the image visual.

Bits in the WID tables are also provided to select the roam buffer, and disable display of the overlay and highlight planes.

Roam processor subsystem

The roam subsystem is shown in FIG. 1. (For purposes of simplicity, it is not shown in FIG. 3, but is generally analogous in structure to the frame buffer structure shown in FIG. 3.) This subsystem is effectively an additional frame buffer larger than the actual screen size. This buffer can be roamed in a toroidal fashion within a window in the static frame buffer. The frame buffer has:

image: single buffered RGB planes (24).about..about.

image VLT context (3 bit single buffered)

overlay: single buffered (8)r

overlay VLT context (1 bit single buffered)

highlight: double buffered (2)

mask planes (2)

It has a set of resolvers 161 that are configured as "roamers" connected to the IZ bus 17, the frame buffer 14 as above, and a pixel shifter followed by a set of VSMs (like 381-388) which feed into the digital RGB stream to the RAMDACs 39. Since the VLTs are in the VSMs, the roam buffer has its own set of 8 VLT contexts.

The roam buffer displays through a window defined by the WID bits in the static frame buffer. Each of the WIDs index into their lookup table in the static frame buffer VSMs, and if all three enable the roam buffer, the roam buffer will display. If any do not select roam, roam will not display. This allows static frame buffer pixels to overlay the roam buffer.

Texture processor

The texturing subsystem 250 is an optional subsystem which interfaces solely through the IZ bus 27. The texturing subsystem 250 logically lies between the rendering subsystem and the frame buffer subsystem. The texturing subsystem 250 comprises four texture processor ASICs 251-254 and 32 MB of texture memory 251a, 252a, 253a and 254a. Each texture processor ASIC performs texturing operations for a single band (red, green, blue or alpha) or texture memory.

The texture processors 251-254 receive two types of setup parameters from the graphics engine 22: one type for triangles and one type for pixel spans within a triangle. The triangle setup parameters consist of texturing control information and texture coordinate derivatives, and the pixel span setup parameters consist of initial texture coordinates. These texturing processors 251-254 correct for perspective during texture coordinate interpolation and thereby reduce image distortion.

The texture memory is capable of storing several sets of mip-mapped textures for subsequent texture mapping. In mip-mapping, multiple-sized versions of a texture are stored. Each version is filtered to account for distance from the viewer. The texture processor chooses eight texels nearest the actual texel value from the nearest two mip maps. The texture processor interpolates these eight texels to produce the actual texel value through the use of trilinear interpolation. The actual texel value replaces or blends with the Gouraud shaded pixel value generated by the graphics engine 22. Finally, the texture processors route the textured pixels to the resolvers 331-334 and the resolvers 331-334 write the textured pixels into the frame buffer 341-344.

When the graphics engine 22 receives textured requests (that is, requests which contain texture coordinates), it sends special span requests to the texturing subsystem 250 over the IZ bus 27. The texturing subsystem 250 intercepts these spans, textures the pixels within it, and then resends the span to the resolvers 331-334. Texture memory 251a, 252a, 253a, and 254a looks like frame buffer memory 341-344 to the graphics engine, and is loaded/read back by normal get/put and fill operations.

II. IMPLEMENTATION.

Graphics Engine

The graphics engine 22 is request-based, in that it receives requests from a host processor to perform draw, data movement, and control operations affecting the frame buffer. The host processor is responsible for performing all floating point calculations, such as lighting, transformations, etc.

The types of operations performed by the graphics engine are listed below, along with some performance figures for 1.3 and 2 MPix systems::

Static Frame Buffer

The maximum configuration for the static frame buffer contains a total of 132 planes:

The static frame buffer "stacks" the overlay and highlight visuals on top of the image visual. A selectable value for the highlight and overlay planes is specified as "transparent" allowing the visual(s) below to display. A non-transparent value in the overlay planes will override the image visual. A non-transparent value in the highlight plane will override both the image visual and the overlay visual. Display of both highlight and overlay may be independently disabled via the WID lookup tables. Overlay transparency may also be turned off via the WID LUT.

A total of 8 VLT contexts are supported. Only the first two are accessible by the overlay planes, while all S are accessible by the image planes. All contexts may be configured as either pseudo color or true color contexts, and this determines whether the image planes are being used in true color or pseudo color mode.

Hardware contrast adjustment is supported

A hardware cursor is provided. It will support cursor sizes up to 64.times.64 and 2 planes in depth. One of the two planes is configured as an enable plane.

The frame buffer supports interlaced stereoscopic displays.

Roam Frame Buffer

The optional roam frame buffer contains a total of 40 planes, with the following breakdown:

III. HARDWARE REQUEST FORMATS.

All requests begin with a 32 bit request word. The upper halfword contains the request code, and the lower halfword contains graphics control information. The graphic control information for all graphic requests is the same and as follows:

The format of control information for non-graphic requests is defined with the requests themselves.

The upper halfword containing the request code is further divided into 3 subfields as follows:

Requests may be fixed length (e.g. most of the control requests), fixed length dependent on parameters in the request (e.g. raster placement requests) or variable length (open ended) (e.g. the vector request). Open-ended requests end with a 1 or 2 word terminator. Terminators vary depending on the particular request.

Requests are further divided into protected and nonprotected requests. Protected requests will not be executed unless they were written to the protected FIFO. Nonprotected requests will execute from either FIFO. Note there is only one physical FIFO, mapped into several addresses. The sync FIFO is considered a protected FIFO, and hence can execute protected requests.

It is intended that for application "direct access" to the graphics processor of this implementation, the applications will be able to write to the nonprotected FIFO, but not the protected or sync FIFOs.

Context switching will be supported at any point in any non-protected request written to the non-protected FIFO. Protected requests or requests written to a protected FIFO are not interruptible.

No support for clipping or clip checking is provided in the graphics engine, apart from the masking planes. X,Y coordinates and window origins are signed, but all generated pixels must end up as valid screen coordinates.

IV. DRAW REQUESTS.

There are two main draw requests: E3Vec (vector) and E3Tri (triangle). These requests are open ended and consist of a request header word and then an open ended sequence of vertices. The vertex format is the same for the vector request and the triangle request. The format of the vertex expected by the graphics engine is encoded in the 8 bit "vertex control" field (VCTRL) of the request header word. The VCTRL field specifies both the format of data in the vertex, and the existence of optional data.

There is also a special purpose clipped vector request, E3ClipVec. This request draws one stroke, and has only one data format--there is no vertex control field.

The Graphics Engine processes draw requests the same way regardless of the destination visual selected in the GE.sub.-- BUFSEL register. A 32 bit RGBA value is generated--this will come from the iterator if shading is being done, or else from the GE.sub.-- FGCOLOR/BGCOLOR registers. If dithering is enabled, this value will be dithered as described in the application notes, and the 8 bit dither index placed in the low 8 bits of the RGBA value (the "R" field). The G, B and A fields are left as is. This value is written to IZ›31:00!--the low half of the resolver bus.

The upper 32 bits of the IZ bus have a Z value placed on it. This comes from the iterator or the GE.sub.-- Z register, depending on whether Z is included with the vertex.

In the resolver IZ›63:32! is used to perform Z buffering ALWAYS if it is enabled, regardless of the destination visual selected. The destination visual selects the planes to which IZ›31:00! are written. If the destination visual is less than 32 bits, only the lower portion of the IZ bus will be written to it. Alpha operations always use IZ›31:24! as the source alpha, the destination alpha is either the contents of the alpha planes or 0.times.FF depending on the visual selected.

Vertex Format

The minimum information in a vertex is simply an (X,Y) pair. Optional data is Z, (U,V,S), color (RGB), and alpha. Thus the maximum is (X,Y,Z,U,V,S,R,G,B,A). This is also the required order for the vertex data. The number of 32 bit words of data required to represent a vertex can be from 1 word (packed X,Y, no optional data) to 20 words (double precision for all data, all optional data included).

The format of VCTRL is as follows: ##STR2## XFMT data format for X,Y,Z,U,V,S Specifies the data format of coordinate data. It is encoded as follows

Specifies that Z is included with the vertex. Z always follows X,Y if it exists. Z is a minimum of 32 bits, so is in unsigned 32 bit format even if XFMT is 00. If it is zero then the Z value of pixels generated is considered to be the value in GE.sub.-- Z for Z buffer operations. If Z is provided with the vertex, Z values will be interpolated along line segments and triangle facets.

TF Texture flag

Specifies that the request is to be textured. If TF is set, texture coordinates (U,V,S) are included with the vertex and are in the format as specified by XFMT. Note that if XFMT is O (packed format) U and V are packed, and S is a 32 bit quantity in the next word. U, V and S coordinates are interpolated along line segements and on triangle facets.

CFMT Color format

The CFMT field specifies whether color is included with the-vertex, and if mat of the color data. CFMT is encoded as follows: ##STR3##

Color follows the S coordinate if it exists, else it follows the Z coordinate if it exists, else it follows the (X,Y) coordinate. If color is not supplied with the vertex, segments or facets are drawn in the foreground color. If they are supplied then they are interpolated along line segments, or Gouraud shading is performed for triangle facets. If SHADE.sub.-- FLAT.sub.-- H is set in the GE-GCR then shading is inhibited and each stroke or facet is drawn flat shaded in the color of the last vertex received.

AF Alpha flag

This flag indicates whether alpha is included with the color coordinate. AF is ignored if CFMT is 00. If AF is set, alpha is taken from the high 8 bits of the color word if color is in packed format. For CFMT=10 or 11 alpha is a single or double precision value which follows blue in the vertex. If AF is clear, the alpha value is taken from the foreground color register. In this case the high 8 bits of the packed color are ignored, and alpha will not be in the vertex data for floating point formats. Note that the AF bit does not have any effect on alpha operations--alpha blending, if enabled, will still occur on pixel writes using the alpha value from the foreground register.

Vertex Handling

Vertex data is transformed to internal format as it is read from the FIFO. The transform can be handled differently depending on some of the bits in the graphics control register (GE.sub.-- GCR).

X and Y coordinates are signed and window relative. If they are in an integer format they are used as is. If they are in a floating point format, and FIX.sub.-- VER.sub.-- H is set, they will be truncated before use. If COORD.sub.-- OFFSET.sub.-- H is set in the GCR then either 2028 or 4096 will be subtracted from both X and Y before use, depending on OFFSET.sub.-- 4R.sub.-- H. This is done after derivatives are calculated, so that the derivatives are independent of screen position.

Z is unsigned, and will be clamped to 0 if in floating point format and negative. If Z is not specified, Z from the GE.sub.-- Z register will be used for any Z operations requested. If Z is specified, it is interpolated for both vector and triangle requests.

U, V and S coordinates are described in the appendix on texture processing.

Color values are used as is if in packed format. For floating point color values, the color components are in the range ›0,1!. Internally the graphics engine scales the value to the range ›0,255!. If alpha exists it is treated the same as one of the color components.

If dithering is enabled, the color range is different, and color scaling is handled differently. See the application notes on dithering for a discussion on this. Dithering can be applied to both vector and triangle requests.

Vertex Terminators

The vector and triangle requests are open ended, and are terminated by a terminator value as the first data value of a vertex. This value depends on the XF field as follows:

Terminators are a single 32 bit value, except in the case of double precision values in which case it is two 32 bit words, where the first is arbitrary (least significant part of the double) and the second word is as above.

Floating point terminators are not completely decoded--the sign bit and part of the mantissa are not used and thus may be arbitrary. The following bit patterns represent the floating point terminators. "x"s represent bits that are arbitrary:

Single precision

Double precision

For example, the following hex values would be considered terminators for floating point formats:

float: 0x7FFS0000

double: 0x7FFS0000 00000000

Vector Request

The vector request uses a stroking algorithm to draw a single pixel width line. These lines can be used for weight O X windows lines since X does not require any particular pixelization. They cannot be used for width 1 X windows lines, because they do not produce the characteristic "knobbly" thickening and thinning which weight 1 X windows lines produce.

Two different algorithms are used to stroke vectors: the Bresenham algorithm, and a DDA algorithm which lights the closest pixel to a line, including lines with floating point coordinates--i.e. subpixel accuracy. In the case of a tie between two pixels in the DDA algorithm, the pixel below or to the right will be drawn.

Additional setup time in the graphics engine is required for DDA stroking, and this will impact short vector performance. 10 pixel solid DDA vectors will run at about 50% of the Bresenham rate, 10 pixel shaded color/Z at about 70% the Bresenham rate. For vectors over about 20 pixels the extra setup time will be hidden, so there would be no degradation in performance

The algorithm used depends on the state of the GCR. If antialiasing is enabled (VEC.sub.-- AA.sub.-- H set), the DDA algorithm is always used. Otherwise if FIX.sub.-- VER.sub.-- H is set, the Bresenham algorithm is used, and if FIX.sub.-- VER.sub.-- H is clear, the DDA algorithm is used. This is independent of the format of the X,Y coordinate.

Normally a vector request produces a linestring, but if VEC.sub.-- SEGMENT.sub.-- H is set in the graphics control register there is an implied disconnect between each pair of vertices, producing a sequence of disconnected segments.

The graphics engine maintains the concept of a "first segment" attribute while stroking vector requests. Normally the first segment of a request has the "first segment" attribute, while subsequent segments do not. If VEC.sub.-- SEGMENT.sub.-- H is set, then all segments have the "first segment" attribute. If VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H is set, then NO segments have the "first segment" attribute (even if VEC.sub.-- SEGMENT.sub.-- H is set). "First segments" differ from subsequent segments in the following areas:

symbology is reset before the segment is drawn

VEC.sub.-- DRAW.sub.-- FIRST.sub.-- H is ignored, and the first pixel is drawn always

for anti-aliased lines the AA.sub.-- V.sub.-- FBFUNC is NOT used for the first pixel

There are two bits in the GCR which define behavior of the vector stroker at the first and last pixels of lines/linestrings. These are VEC.sub.-- DRAW.sub.-- FIRST.sub.-- H and VEC.sub.-- DROP.sub.-- LAST.sub.-- H. If VEC.sub.-- DRAW.sub.-- FIRST.sub.-- H is not set, the first pixel of linestring segments AFTER the first are not drawn. If VEC.sub.-- DROP.sub.-- LAST.sub.-- H is set, the last pixel of all line segments, including first and single segments, are not drawn.

If neither of these bits are set, the graphics engine is in "X windows" mode. If the request produces a linestring the first pixel of segments after the first are not drawn, so that internal vertex pixels are not drawn twice. All pixels of the first segment are drawn. All pixels of segments are drawn if VEC.sub.-- SEGMENT.sub.-- H is set.

If both bits are set, the graphics engine is in "Windows" mode, and the last pixel of all segments is dropped. The pixel is dropped even if VEC.sub.-- SEGMENT.sub.-- H is set.

These mode bits also affect DDA stroked lines. In this case they operate slightly differently. Pixels are only dropped if the start/endpoint of the segment falls exactly on a pixel center in the major axis. If a segment "crosses" a pixel center, that pixel will always be drawn, even if it is the first or last pixel, and regardless of the state of the two bits. The two bits should be set such that first and last pixels are always drawn for antialiased lines.

E3Vec vector requests can be antialiased with a performance penalty.

Symbology will be applied to vector requests if VEC.sub.-- SYMB.sub.-- H is set in GE.sub.-- GCR. As each pixel for a stroke is generated, the LSB of the symbology mask is checked. If it is a 1 then the pixel is drawn normally. If the symbology bit is O, then there are two possibilities. If BG.sub.-- WE.sub.-- H is set in GE.sub.-- GCR then this pixel is drawn in the color in GE.sub.-- BGCOLOR. If BG.sub.-- WE.sub.-- H is clear in the GE.sub.-- GCR then the pixel is not drawn. After each pixel is drawn (or not) a specified number of times, the symbology mask is rotated right 1 pixel. Only the number of bits defined in the symbology count register are included in the rotate. The repeat count register specifies the number of pixels drawn before the symbology mask is rotated. The symbology repeat count is not incremented on pixels not drawn due to the VEC.sub.-- DRAW.sub.-- FIRST.sub.-- H/VEC.sub.-- DROP.sub.-- LAST.sub.-- H bits in the GCR.

Symbology is reset to the original loaded values at the start of every request, and also at the start of every segment if VEC.sub.-- SEGMENT.sub.-- H is set in the GE.sub.-- GCR. Symbology reset across requests and segments can be suppressed by setting VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H in the GCR.

Registers which affect the vector request:

GE.sub.-- GCR

GE.sub.-- GCR.sub.-- WEMASK

Selects which bits in the GCR may be modified by the control part of the request word

GE.sub.-- FGCOLOR

this defines the data written for requests which do not include a color as part of the vertex data, and alpha for requests in which alpha is not included in the vertex data.

GE.sub.-- BGCOLOR

defines the color of "off" pixels of symbolized lines if BG.sub.-- WE.sub.-- H is set in the GE.sub.-- GCR.

GE.sub.-- Z

this defines the Z value which will be used for Z buffering if it is enabled, and Z is not included with the vertices.

GE.sub.-- MISC.sub.-- DATA

this defines "implied" data which will be written to control planes if the appropriate plane enables are set, and the visual is one of 0-5. See section on visuals for description of implied data for each visual.

GE.sub.-- SYMBOLOGY

GE.sub.-- SYMB.sub.-- CTRL

GE.sub.-- AA.sub.-- CTRL

controls antialiasing parameters

GE.sub.-- WORG or GE.sub.-- ROAM.sub.-- WORG

GE.sub.-- SWIDTH or GE.sub.-- ROAM.sub.-- SWIDTH

GE.sub.-- DITH.sub.-- CTRL

GE.sub.-- TEX.sub.-- ORG

GE.sub.-- TEX.sub.-- BCOLOR

GE.sub.-- TEX.sub.-- CTRL

GE.sub.-- ATST.sub.-- CTRL

Value and function used for alpha test if enabled

GE.sub.-- ZFUNC

selects the Z buffer function performed if Z buffering is enabled

GE.sub.-- FBFUNC

selects the frame buffer merge function to be performed

GE.sub.-- BUFSEL

selects which visual is written to, plus selects which buffer of the visual, or roam buffer.

GE.sub.-- IMAGE.sub.-- PLN.sub.-- EN

plane enables for the true color visual

GE.sub.-- OL.sub.-- PLN.sub.-- EN

plane enables for overlay visuals

GE.sub.-- HL.sub.-- PLN.sub.-- EN

plane enable for highlight visuals

GE.sub.-- MISC.sub.-- PLN.sub.-- EN plane enables for the Z buffer (if enabled) plus WID, mask, and VLT context depending on the visual selected.

Valid visuals for vector requests are 0-5 and 8. Drawing to visual 14 will give a graphics engine error. Drawing to other visuals will not generate an error; however the results in the frame buffer are not defined. Masking is guaranteed to work on all visuals, however.

Clipped vector request: E3ClipVec

A special purpose request is provided for X windows clipped and wide vectors. This request draws a single Bresenham stroke with provision to initialize the Bresenham error parameters and starting symbology position. The request takes a starting pixel in packed form only, and no support is provided for shading color, Z or texture. The vector is always drawn in the foreground color, at the depth specified in GE Z (if Z buffering is enabled), and cannot be textured.

Wide lines

X windows wide lines can be drawn using this request by multistroking with different initial Bresenham setup parameters. There is an explicit "DRAW FIRST" bit in the symbology control field. The wide line code must explicitly set this for the first stroke, and clear for subsequent strokes of the wide line.

Clipped vectors

1) Vector starts in window and goes out:

If the vector was not part of a previous line string, reset the symbology by clearing LOAD.sub.-- CUR.sub.-- SYMB.sub.-- H in the request and VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H in the GCR.

If the vector is part of a linestring, clear LOAD.sub.-- CUR.sub.-- SYMB.sub.-- H and DRAW.sub.-- FIRST in the request, set VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H in the GCR so that symbology continues across the vertex, and the first pixel is dropped.

2) Vector starts and finishes out of the window:

In this case, the symbology mask must be set to the correct position for the first drawn pixel. The correct symbology bit and repeat count must be calculated for the first pixel, and loaded by the request.

3) Vector starts outside, and finishes inside:

For standalone vectors, this case can be handled the same as the previous case. If the vector is part of a linestring, and is to be continued by a linestring request, then it should be set up as above, but 1 subtracted from the pixel count. After the clipped stroke is drawn the linestring is started with VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H set in the GCR so symbology continues from where the clipped stroke finished. The interior vertex will only be drawn once, but as the first pixel of the linestring, rather than the last pixel of the clipped line segment.

Notes on symbology: VEC.sub.-- SYMB.sub.-- H is supported in the GCR--symbology can be enabled or disabled. If symbology is enabled, then symbology can be set to any required initial value by setting the symbology bit select and repeat count, and setting LOAD.sub.-- CUR.sub.-- SYMB.sub.-- H. Note that setting the bit select and repeat count to zero is the same as resetting the symbology.

If LOAD.sub.-- CUR.sub.-- SYMB.sub.-- H is clear, then the standard GCR bits apply. If VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H is set, the symbology will continue from its current position, if it is clear the symbology will restart.

The registers which affect the clipped vector request are the same as those which affect the E3Vec request, except for the following:

Support for GCR bits:

all other bits are supported normally

Request code word ##STR4## followed by ##STR5## terminated by: ##STR6##

This request draws a single stroked linestring (polyline). If VEC.sub.-- SEGMENT.sub.-- H is set pairs of coordinates are drawn as disconnected segments. The data consists of a sequence of vertices followed by a terminator which is dependent on the coordinate data type. Each coordinate is an (X,Y) pair optionally followed by a Z coordinate, a texture coordinate, a color value and an alpha value.

If Z is provided Z will be interpolated along each stroke. If Z is not provided the static Z value from GE.sub.-- Z will be used.

If U, v and S are provided, they will be interpolated, and used as texture coordinates by the texture processor.

If color is provided per vertex, shading will be performed, unless SHADE.sub.-- FLAT.sub.-- H is set in the GE.sub.-- GCR in which case each stroke is drawn in the color associated with the second vertex of the stroke.

If alpha is provided it is shaded like one of the color components. If it is not, a constant alpha value from the foreground color register is used.

Symbology will applied if enabled.

If VEC.sub.-- AA.sub.-- H is set the line will be antialiased.

If FIX.sub.-- VER.sub.-- H is set, floating point X,Y coordinates are truncated before use.

If COORD.sub.-- OFFSET.sub.-- H is set, a 2K or 4K offset will be subtracted from the X and Y coordinates.

The source of IZ›31:00! is GE.sub.-- FGCOLOR, GE.sub.-- BGCOLOR or the color iterator

The source of IZ›63:32! is GE.sub.-- Z or the Z iterator

E3Clipvec ##STR7##

This is a special purpose request to draw clipped line segments, and aid in drawing X wide lines. It draws a single Bresenham stroke with the specified starting Bresenham parameters and symbology start point. The stroke is drawn in the current foreground color. If Z buffering is enabled the static Z value in GE.sub.-- Z is used.

Request data is as follows

SYMB.sub.-- CTRL controls symbolization of the line, including current symbology position, whether the first pixel is drawn or riot and octant.

COORD.sub.-- OFFSET.sub.-- H is ignored for this request.

Note that VEC.sub.-- DRAW.sub.-- FIRST.sub.-- H and VEC.sub.-- DROP.sub.-- LAST.sub.-- H in the GCR are ignored, thus there is no support for DROP LAST. The same effect can be obtained by decrementing the COUNT field.

Also DRAW FIRST H defined here applies independently of VEC.sub.-- CONTIN.sub.-- SYMB.sub.-- H in the GCR, as opposed to the behavior of VEC.sub.-- DRAW.sub.-- FIRST.sub.-- H in the GCR.

The source of IZ›31:00! is GE.sub.-- FGCOLOR or GE.sub.-- BGCOLOR

The source of IZ›63:32! is GE.sub.-- Z

Triangle Request

The triangle request is open ended and accepts a stream of vertices. After the first two vertices a triangle is drawn between each new vertex and the previous two vertices.

Pixelization uses the "top left" rule. All pixels whose center falls within the triangle boundary are drawn. Pixels whose center fall exactly on the triangle boundary are drawn if they are on a left hand edge, or a horizontal top edge. They are not drawn if they fall on a right hand edge or a horizontal bottom edge.

Note on using triangles for X wide lines:

The problem with drawing wide lines (with butt ends) as two triangles is pixelization of boundary points. All points completely inside a rectangle must be drawn. This is OR. However boundary pixels appear to be a problem. X specifies that boundary pixels are drawn if the body of the line is below or to the right of the pixel. Triangles have the rules specified above, and hence boundary pixelization is not necessarily the same for the two.

For lines which are horizontal or vertical, two triangles give the correct pixelization.

For lines with positive slope (i.e. top left.fwdarw.bottom right, since origin is top left), pixelization is also correct.

Lines with negative slope have potentially incorrect pixelization on the top and bottom--the bottom edge will include the "on" pixels, while the top edge will exclude them. This is because the "top" edge of the line is a "right" edge of one of the triangles. The left and right edges of the line will be correct.

Possibilities

use two triangles if slope >=0, else use software

use two triangles to draw the "body" of the line (a parallelogram) and use software to draw the two small triangles on the top and bottom.

a combination of the above two

use two triangles and shift the rectangle a tiny amount in an upwards direction in the direction of the line segment

The registers which affect triangle requests are the same as for vector requests, except for the following:

V. ERROR HANDLING.

When the graphics engine detects all error, it performs the following sequence:

If the error interrupt enable bit is set in the CSR, an interrupt will occur. The following requests are detected

To restart the graphics engine, the CPU must deassert and then assert GE.sub.-- RUN.sub.-- H in the CSR. At this point the graphics engine loads the GSR with GS.sub.-- CONTINUE. If ERROR.sub.-- FLUSH.sub.-- H is set in the CSR when GE.sub.-- RUN.sub.-- H is asserted, the graphics engine will assert SYNC.sub.-- ACTIVE.sub.-- H and flush the fifo until it comes to a request which was written to the sync fifo. At this point it will deassert SYNC.sub.-- ACTIVE.sub.' H and start executing requests, starting with the request which was written to the sync fifo. If FLUSH.sub.-- FIFO.sub.-- H is not set, the graphics engine will assume the next word in the input fifo is the start of a new request. If enabled, an interrupt will be generated on the falling edge of SYNC.sub.-- ACTIVE.sub.-- H.

Note: ERROR.sub.-- FLUSH.sub.-- H only causes a flush to occur on restart after an error. This signal is ignored when GE.sub.-- RUN.sub.-- H is asserted after a reset, or if the graphics engine was stopped by deassertion of GE.sub.-- RUN.sub.-- H.

Whenever the kernel (or server) changes context it should save the existing context, and then send an E3SetUserID request to the sync fifo with a 16 bit ID. This request performs two functions. Since it is written to the sync fifo, it can be used to resynchronize the request stream after an error occurs. Also, if an error occurs, the ID of the context being executed is displayed in the GSR, so that the kernel can identify the process which caused the error.

In the above request stream example for context switching if an error occurred at the indicated position, the graphics engine would generate an error and halt with user ID 1 in the GSR register. The kernel would kill the process, and flush the graphics engine, which would discard the request stream up to the E3SetUserID for user 2.