al - Audio Library Functions gDP - DP GBI Macros gdSP - General GBI Macros gSP - SP GBI Macros gt - Turbo Microcode RDP gu - Graphics Utilities Math - Math Functions nuSys - NuSystem os - N64 Operating System sp - Sprite Library Functions uh - Host to Target IO 64DD - N64 Disk Drive
|
gspF3DLX.Rej.fifo MicrocodeThis microcode is part of the F3DEX series that includes the following seven microcode object files:
F3DEX Microcode Series (F3DEX Package) The F3DEX microcode series includes seven tuned and updated versions of the previous Fast3D, F3DNoN, and Line3D microcodes. All the new versions are of the .fifo subtype; that is, they use fifo exclusively as the method by which commands are passed from the RSP to the RDP. In addition, the vertex cache size is increased, and the matrix stack is increased from 10 levels to 18 levels. The seven microcode versions in this series are listed below. Among them are several versions designed to improve performance by restricting function: These seven modified microcodes comprise what is known as the "F3DEX microcode series" or the "F3DEX package." These modified microcodes have been specially modified to .fifo subtypes to improve performance. The following sections describe their features. F3DEX - gspF3DEX.fifo.o or gspF3DEX.NoN.fifo.o These are extended versions of the Fast3D microcode. The vertex cache size is increased to 32, and gSP2Triangles, a GBI command for displaying two triangles at once, is supported. Not supported is the gSP1Quadrangle command, a GBI command for displaying rectangles that was supported in F3DEX Version 1.21 and earlier versions. (However, this is emulated by gSP2Triangles.) In addition, the number of DL links has been increased from 10 to 18 levels.
To improve processing speed, this version simplifies the subpixel calculation from that in the F3DEX microcode. Therefore, little wrinkles may appear when using textures. This microcode retains compatibility with F3DEX and GBI, and improves the processing capacity of the RSP. They do so by simplifying the calculation for each vertex of a polygon from subpixel precision to pixel precision. An extension unique to F3DLX allows clipping to be turned ON or OFF using a DL command. The graphics binary interface (GBI) of the F3DLX microcode is identical to that of the F3DEX microcode. However, in F3DLX, clipping can be controlled by turning it on or off. When the clipping is off, performance improves a little. For details, see the macros listed in the "See Also" section at the bottom of this page.
For this microcode, the clipping processing in the general microcode is removed. Instead, reject processing is included. In other words, this version substitutes rejection processing for clipping. This processing is lighter than the old clipping processing. The vertex cache size is 64, and the gSPTriangles commands are supported. This has been optimized using the assumption that 2Tri operation will be performed. When the vertex of a triangle falls outside the defined reject rectangle, no portion of that triangle is rendered. Consequently, this version is not suited for large triangles. Texture perspective correction is implemented. F3DLP.Rej - gspF3DLP.Rej.fifo.o This has macros equivalent to those of F3DLX.Rej. However, because texture perspective correction is not implemented, the RSP processing speed is faster. The vertex cache size is 80. L3DEX - gspL3DEX.fifo.o This is a modified version of the Line3D microcode adapted to a cache size of 32. It is the same as gspLine3D and allows polygons rendered by F3DEX to be displayed using wireframes. Loading F3DEX Series Microcode You can use the gSPLoadUcode or gSPloadUcodeL macro to load any of the seven package microcodes. gSPLoadUcode(Gfx *gdl, u64 *uc_start, u64 *uc_dstart) gsSPLoadUcode(u64 *uc_start, u64 *uc_dstart)
Note: When microcode is loaded using this GBI, the internal state of the RSP is initialized (segment address, viewport, geometry mode, matrix, link information of display). Thus, RSP-related settings must be reset immediately after microcode loading. Furthermore, the DL linking information is initialized. Caution is therefore recommended when using these commands in a DL called using the gSPDisplayList macro because control will not return to the calling DL. To enable use of the gSPLoadUcode macro, you must set t.flag, which is a member of the OSTask structure, to OS_TASK_LOADABLE as shown here: OSTask *tp; tp->t.flag = OS_TASK_LOADABLE | OS_TASK_DP_WAIT;To make this flag valid, a patch must be applied to the OS. Please see the "OS Patchs" section of the README file for information on applying the patch. Applying the patch makes the OS upward/host compatible. This patch is already contained in OSs using the N64 Software Library 2.0H or later. The gSPloadUcodeL macro makes loading microcode even easier: gSPLoadUcodeL(Gfx *gdl, ucode_name) gsSPLoadUcodeL(ucode_name)Commands (a) and (b) below are equivalent: (a) gsSPLoadUcode( OS_K0_TO_PHYSICAL(&gspF3DEX_fifoTextStart), OS_K0_TO_PHYSICAL(&gspF3DEX_fifoDataStart)) (b) gsSPLoadUcodeL(gspF3DEX_fifo)Rejection Processing In rejection processing, the only triangles drawn are those for which all three vertexes are inside a certain area of the screen. This area is slightly wider than the screen. Even if just one vertex is outside the area, the triangle is not drawn. This area is called the "reject box." The reject box varies depending on the size of the TV screen. For X and Y, when the screen size is 320 x 240, the reject box is twice as big as the screen at beginning as shown in the following drawing: -160 480 -120 +---------------------------------+ | | ___When FRUSTRATIO_2, | 0 320 |/ Reject Box | 0 +-------------------+ | | | | | | | | | | | Screen | | | | | | | | | | | 240+-------------------+ | | | | | 360 +---------------------------------+The area can be changed by calling gSPClipRatio. A value can be selected from FRUSTRATIO_2 to FRUSTRATIO_6. For the Z direction (depth of screen), a reject box can be done with the far plane, but not with the near plane. If you draw a big triangle and want part of it to appear on the screen, but one vertex of the triangle is out of the reject box, the triangle will not be drawn because of reject processing. In this case, you need to divide the big triangle into several small triangles so that an unnatural "missing polygon" can be avoided. In F3DLX.Rej and F3DLP.Rej, the processing speed of the gSP2Triangles command has been improved by using reject processing. Therefore, when creating the display list (DL), please use gSP2Triangles whenever possible. Notes for Reject Processing
GBI Compatibility Issues There is no compatibility on a binary level between the GBI (graphics binary interface) of this F3DEX microcode series and the previous Fast3D microcode. However, the differences between them can be eliminated by using gbi.h. Even though they use the same DL, a suitable GBI for each can be specified by using the compile option; that is, by defining the keyword F3DEX_GBI before including the gbi.h file. For example, when the DL is written in the static_ex.c file, please add #define F3DEX_GBI before including ultra64.h as shown here: static_ex.c: | |#define F3DEX_GBI |#include |All the microcodes F3DEX, F3DLX, F3DLX.Rej, and F3DLP.Rej are compatible at the GBI binary level. Therefore, the DL can be shared. However, even the same commands process differently because of things such as the reject processing described previously, so the same graphics may not be drawn even when using the same DL. OS Patch Installation There are patches of the OS for gSPLoadUcode in the os_patches directory. Please use the following procedure to install a patch: % cd os_patches % makeBy doing this, the patched libraries (libultra.a, libultra_rom.a, and libultra_d.a) are created in the os_patches directory. Please move them to /usr/lib before using them. See Also Introduction to N64 Microcode The following macros were added or changed when the F3DEX microcode series was added to the N64 development environment. gSPVertex gSP2Triangles gSP1Quadrangle gSPSetGeometryMode gSPCullDisplayList gSPClipRatio gSPModifyVertex gSPBranchLessZ gSPBranchLessZrg gSPLoadUcode gSPLoadUcodeL
|