Function
nuDebConDisp
nuDebConDispEX2
Syntax
void nuDebConDisp(u32 flag)
void nuDebConDispEX2(u32 flag)
Arguments
flag determines whether or not to swap frame buffer when the task is completed
NU_SC_SWAPBUFFER Swap frame buffer
NU_SC_NOSWAPBUFFER Do not swap frame buffer
Return Value
None
Description
Displays the console window
Displays the console output on the screen. All ASCII characters can be output.
This function internally creates a display list and starts the graphics task.
flag is the frame buffer swap flag passed to the argument of the nuGfxTaskStart function.
NuSystem can display up to four console windows. The settings that can be made for the console window include the window display position, window size, show/hide the window, and scroll on/off. The character attributes that can be set are the color and blink on/off.
All 4 console windows are supposed to be displayed in the initial state. However, CPU power is required to some extent, to display console windows. Therefore, we recommend that you use the nuDebConWindowShow function to set windows that are not used to a non-display condition.
The functions for these various settings are shown below.
Function Name | Function |
nuDebConWindowSet | Set window position and size |
nuDebConWindowPos | Set window position |
nuDebConWindowSize | Set window size |
nuDebConWindowShow | Show/hide window |
nuDebConScroll | Scroll on/off |
nuDebConTextColor | Change text color |
nuDebConTextAttr | Set text attributes |
nuDebConTextPos | Text display position |
nuDebConClear | Clear the console window |
These functions can also be used with the release-use library.
Please note that when the nuGfxInit function is not used, then the 0th microcode in the microcode structure array defined by the nuGfxSetUcode function is used. High resolution has been supported since version 1.1.
Beginning with Version 2.06, F3DEX_GBI_2 is defined by nusys.h. Therefore, nuDebConDispEX2 is usually used. If F3DEX microcode is used, define F3DEX_GBI before nusys.h.
See Also
nuGfxInit, nuGfxTaskStart, nuGfxSetUcode, nuDebConWindowSet, nuDebConWindowPos, nuDebConWindowSize, nuDebConWindowShow, nuDebConScroll, nuDebConTextColor, nuDebConTextAttr, and nuDebConClear
Revision History
6/15/99 Added text regarding a change of display setting for the console window's initial state
8/4/99 Deleted description of Ver1.2 and added description of Ver2.06