← Back to branch summary

~sbeattie/ubuntu/lucid/vnc4/lp556147

« back to all changes in this revision

Viewing changes to unix/xc/extras/Mesa/src/swrast/NOTES

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/extras/Mesa/src/swrast/NOTES
 
1
INTRODUCTION
 
2
 
 
3
Mesa's native software rasterizer.  This module provides the fallback
 
4
paths for rasterization operations and states that aren't accelerated
 
5
in hardware drivers, and as the full rasterization engine in software
 
6
drivers.
 
7
 
 
8
The swrast module 'stands alone', relying only on interfaces to core
 
9
mesa and it's own driver interface.  It knows nothing about the tnl or
 
10
other modules, allowing it to be used for fallback paths in future tnl
 
11
schemes without modification.
 
12
 
 
13
As well as providing triangle/line/point rasterization functionality,
 
14
the module provides implementations of the pixel operations
 
15
(ReadPixels, etc), and texture operations (CopyTexSubImage) which may
 
16
be plugged in to the core Mesa driver interface where accelerated
 
17
versions of these operations are unavailable.
 
18
 
 
19
 
 
20
STATE
 
21
 
 
22
To create and destroy the module:
 
23
 
 
24
        GLboolean _swrast_CreateContext( GLcontext *ctx );
 
25
        void _swrast_DestroyContext( GLcontext *ctx );
 
26
   
 
27
This module tracks state changes internally and maintains derived
 
28
values based on the current state.  For this to work, the driver
 
29
ensure the following funciton is called whenever the state changes and
 
30
the swsetup module is 'awake':
 
31
 
 
32
        void _swrast_InvalidateState( GLcontext *ctx, GLuint new_state );
 
33
 
 
34
There is no explicit call to put the swrast module to sleep.  
 
35
 
 
36
 
 
37
CUSTOMIZATION
 
38
 
 
39
   void (*choose_point)( GLcontext * );
 
40
   void (*choose_line)( GLcontext * );
 
41
   void (*choose_triangle)( GLcontext * );
 
42
 
 
43
Drivers may add additional triangle/line/point functions to swrast by
 
44
overriding these functions.  It is necessary for the driver to be very
 
45
careful that it doesn't return an inappropriate function, eg a
 
46
rasterization function in feedback mode.  See the X11 driver for
 
47
examples.
 
48
 
 
49
DRIVER INTERFACE
 
50
 
 
51
The swrast device driver provides swrast primarily with span- and
 
52
pixel- level interfaces to a framebuffer, with a few additional hooks
 
53
for locking and setting the read buffer.
 
54
 
 
55
See the definition of struct swrast_device_driver in swrast.h.
 
 
b'\\ No newline at end of file'