summaryrefslogtreecommitdiffstats
path: root/make/config/jogl/gl-if-CustomJavaCode-gl4.java
blob: 8ed25e56b8b8129d1297e964f9bd859e8c6d1249 (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

  //
  // GLBufferObjectTracker Redirects
  //

  /**
   * Returns the {@link GLBufferStorage} instance as mapped via OpenGL's native {@link GL4#glMapNamedBuffer(int, int) glMapNamedBuffer(..)} implementation.
   * <p>
   * Throws a {@link GLException} if GL-function constraints are not met.
   * </p>
   * <p>
   * Depends on <code>GL_VERSION_4_5</code>.
   * </p>
   * <p>
   * {@link GL4#glMapNamedBuffer(int, int)} wrapper calls this method and returns {@link GLBufferStorage#getMappedBuffer()}.
   * </p>
   * @param bufferName denotes the buffer
   * @param access the mapping access mode
   * @throws GLException if buffer is not tracked
   * @throws GLException if buffer is already mapped
   * @throws GLException if buffer has invalid store size, i.e. less-than zero
   */
  public GLBufferStorage mapNamedBuffer(int bufferName, int access) throws GLException;

  /**
   * Returns the {@link GLBufferStorage} instance as mapped via OpenGL's native {@link GL4#glMapNamedBufferRange(int, long, long, int) glMapNamedBufferRange(..)} implementation.
   * <p>
   * Throws a {@link GLException} if GL-function constraints are not met.
   * </p>
   * <p>
   * Depends on <code>GL_VERSION_4_5</code>.
   * </p>
   * <p>
   * {@link GL4#glMapNamedBufferRange(int, long, long, int)} wrapper calls this method and returns {@link GLBufferStorage#getMappedBuffer()}.
   * </p>
   * @param bufferName denotes the buffer
   * @param offset offset of the mapped buffer's storage
   * @param length length of the mapped buffer's storage
   * @param access the mapping access mode
   * @throws GLException if buffer is not tracked
   * @throws GLException if buffer is already mapped
   * @throws GLException if buffer has invalid store size, i.e. less-than zero
   * @throws GLException if buffer mapping range does not fit, incl. offset
   */
  public GLBufferStorage mapNamedBufferRange(final int bufferName, final long offset, final long length, final int access) throws GLException;