summaryrefslogtreecommitdiffstats
path: root/doc/TODO.txt
blob: 1fbb12616891f34c50a69bf30cbfe0ad89ceaa82 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
Random, somewhat old to-do list:
(See Issue Tracker on http://jogl.dev.java.net/ for current high-priority issues)

- Non-const array types must be properly released with JNI_COMMIT in
  order to see side effects if the array was copied.

- Figure out how to implement GLEventListener.displayChanged(bool,bool). 
  I believe we need additional support in J2SE before this will be possible
  to detect and implement. The basic problem is that we need to find a way 
  to determine when a GLCanvas has moved to a different
  display device, so we can re-load the GL function addresses using
  wgl/glXGetProcAddress. See comments at top of GLCanvas.java. Also need a
  way to determine with the display mode (e.g., bit depth) of the GLDrawable
  has changed. Once both of these problems are solved, we'll need to hook it
  into GLEventListener.displayChanged() and also be sure to reset the
  GLDrawable's glProcAddress table as appropriate.

- Think about e.g. protected access for Impl classes

- Fix glProgramStringARB and glGetProgramString{NV,ARB} so that they
  use Strings and/or StringBuffers insteead of GLUbyte* and void*

- figure out how to deal with WGL entry points:
    WINGDIAPI HGLRC WINAPI wglCreateLayerContext(HDC, int);
    WINGDIAPI BOOL  WINAPI wglUseFontBitmapsA(HDC, DWORD, DWORD, DWORD);
    WINGDIAPI BOOL  WINAPI wglUseFontBitmapsW(HDC, DWORD, DWORD, DWORD);
  see commented-out section in make/stub_includes/win32/wingdi.h

- Need a disciplined mechanism for converting char* argument types. For
  example, many C functions accept a "char*" argument with the semantic that
  output data will be written into the buffer pointed to by the
  argument. The type "const char*" is used when the argument's data will be
  unchanged. Our system needs a new directive, such as
  "ArgumentIsStringBuffer" to be used for type conversion in those cases
  where the native code needs to write output into the "char*" argument. Not
  sure how to handle this on the native side -- it may require hints to the
  native code generator as to how large the StringBuffer's backing buffer
  needs to be, so we can assert this condition before passing the backing
  buffer to the C function we are wrapping.

- Throw an exception if native calls to GetPrimitiveArrayCritical
  return null.

- Before emitting functions and constants, sort them first by
  extension suffix (i.e., ARB, ATI, NV, etc) and then by name. This
  will organize them in the file more logically. When writing the
  code, the sort function can check the last substring that's all caps,
  and treat this as the extension owner. Be careful though, some end
  in "3D" and that's not an extension.