 N64® Functions Menu |
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 DriveNintendo® Confidential |
|
|
|
|
|
osViSetEvent
Format#include <ultra64.h>
void osViSetEvent(OSMesgQueue *mq, OSMesg msg, u32 retraceCount);
What This Function Does
It is one of the following 16 management functions for the video interface (VI):
- osViGetStatus
- osViGetCurrentMode
- osViGetCurrentLine
- osViGetCurrentField
- osViGetCurrentFramebuffer
- osViGetNextFramebuffer
- osViSetMode
- osViSetEvent
- osViSetSpecialFeatures
- osViSetXScale
- osViSetYScale
- osViSwapBuffer
- osViBlack
- osViFade
- osViRepeatLine
- osCreateViManager
For general information about the VI and its supported modes, codes, and functions, see the osVi page. The general information applies to each of the VI management functions and you should understood it before using any of the VI functions. All 16 functions are described, so you can see how they all work together to manage the VI.
After setting the display mode, the application should call osViSetEvent to register a message queue (mq) and a message (m) with the VI manager. This allows the program to receive the notification message (m) at the message queue (mq) from the VI manager when a vertical retrace occurs. Setting retraceCount to a value higher than 1 (such as 2) decreases the frequency with which the application receives the vertical retrace notification. This allows it to run at a slower speed such as 30 Hz instead of 60 Hz.
See Also
osViGetStatus
osViGetCurrentMode
osViGetCurrentLine
osViGetCurrentField
osViGetCurrentFramebuffer
osViGetNextFramebuffer
osViSetMode
osViSetSpecialFeatures
osViSetXScale
osViSetYScale
osViSwapBuffer
osViBlack
osViFade
osViRepeatLine
osCreateViManager
osSetEventMesg
osGetTime
|
|
|
|
|
|
|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|
|
Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility. Copyright © 1998 Nintendo of America Inc. All rights reserved Nintendo and N64 are registered trademarks of Nintendo Last updated January 1998 |