GraphicsV (français) (changes)

Showing changes from revision #0 to #1: Added | Removed | Changed

Programmer's Reference Manuals?

» Vectors?

» Software Vector Numbers?

» GraphicsV

Graphics Vector (42)

Traduction en cours

Usage

Cet appel est utilisé par RISC OS 5 pour communiquer avec le driver video.

Les applications doivent essayer, autant que possible, de trouver l’appel SWI approprié plutôt que d’utiliser les appels GraphicsV directement. Les informations présentées ici sont principalement utiles aux responsables de systèmes d’exploitation et aux développeurs de pilotes vidéo.

R4 est utilisé par tous les appels de GraphicsV pour stocker à la fois le Paramètre et pour indiquer si l’appel a été réclamé (c’est-à-dire traité par un pilote). Lors qu’un pilote réclame un appel, R4 est mis a 0.
En vérifiant R4 apres l’appel, il est possible de savoir si le pilote prend en charge cet appel ou pas.

Reason Codes

Notes

Installation et désinstallation de pilote.

Les pilotes vidéo basés sur GraphicsV doivent effectuer la séquence d’événements suivante au démarrage:

1. Appeler OS_ScreenMode 64: Demander un numéro de pilote
2. Stocker le numéro, afin de l’utiliser ensuite lors d’appel GraphicsV
3. Appeler OS_Claim? to install their GraphicsV handler
4. Déclencher une interruption VSync? si cela est possible
5. Effectuez toute autre initialisation nécessaire pour préparer le pilote / le matériel
6. Appeler OS_ScreenMode 65: Démarrer le pilote graphique et informer ainsi le Système d’exploitation que le pilote est prêt.
   Une fois que OS_ScreenMode 65 a été réalisée, le pilote peut recevoir des appels GraphicsV de la part du systèmes d’exploitation ou des application.
   Avant cela, aucun appel ne doit être reçu. Si c’est le cas, c’est un bug dans le code de quelqu’un d’autre et pas le vôtre.

Lors de l’arrêt d’un pilote vidéo, la séquence d’événements suivante doit être effectuée:

1. Appeler OS_ScreenMode 66: Arrêter le pilote graphique.
   Une fois cet appel réalisé, le pilote ne devrait plus recevoir d’appels GraphicsV.
2. Arrêter la génération d’interruptions VSync
3. Appeler OS_Release? to release the GraphicsV handler
4. Appeler OS_ScreenMode 67: Libérer le numéro de pilote afin qu’il puisse éventuellement être réaffecté à un autre pilote.

Note that OS_ScreenMode reasons 64-67 must only be called from the foreground.

See also HAL Video API? for details on how the OS translates GraphicsV calls to HAL calls for systems which contain a video driver in their HAL.

¹ Calling contexts

GraphicsV drivers can be called under a variety of different situations. Consult the table above, and the list below, to determine the situations in which each entry point may be called and how the implementation is allowed to behave.

• FG – These calls must only made from the foreground, with interrupts enabled. Background calls may occur while a foreground call is in progress, but no other foreground calls should occur. Foreground calls are allowed to block for long periods of time, and are allowed to enable/disable interrupts at will.
• BG – These calls must only be made from the background, i.e. from within an interrupt handler. The implementation must execute quickly in a non-blocking manner. On entry, interrupt state is undefined. Drivers may disable interrupts as required, but should not enable them if they were disabled on entry. The implementation must also be fully re-entrant, as the same (or a different) background call may be made while the first is in progress.
• FG/BG – These calls may be made from the foreground or the background. The same execution rules as background calls apply – the implementation must be fast, non-blocking, must not enable interrupts if they were disabled on entry, and must be re-entrant with other driver calls.
• SVC – These calls are only made from supervisor mode.
• SVC/IRQ – The kernel may call these entries from SVC or IRQ mode. Therefore care must be taken to preserve R14_svc around any SWI calls.

² GraphicsV 2

As an addition to the above rules, drivers are free to ignore any background calls they receive while they are in the middle of processing a mode change.

³ GraphicsV 3

This call is deprecated. Interlace settings should be specified via the VIDC list and associated control list items given to GraphicsV 2/7.

Voir aussi

• Software Vector Numbers?
• OS_ScreenMode: Réalise diverses opérations concernant le changement de résolution graphique de l’écran.
• HAL Video API?

Page d’origine

English