|
JOGL v2.6.0-rc-20250712
JOGL, High-Performance Graphics Binding for Java (public API).
|
Abstract Outline shape representation define the method an OutlineShape(s) is bound and rendered. More...
Classes | |
| class | Perf |
Public Member Functions | |
| abstract void | printBufferStats (PrintStream out) |
| Print implementation buffer stats like detailed and total size and capacity in bytes etc. More... | |
| final boolean | usesI32Idx () |
Returns true if implementation uses int32_t sized indices implying at least a GLProfile#isGL2ES3() alike context. More... | |
| abstract boolean | growBuffer (int verticesCount, int indicesCount) |
| Increase the renderer buffers if necessary to add given counts of vertices- and index elements. More... | |
| abstract boolean | setBufferCapacity (int verticesCount, int indicesCount) |
| Set the renderer buffers pre-emptively for given vertices- and index counts. More... | |
| final int | getRenderModes () |
Returns bit-field of render modes, see create(..). More... | |
| final boolean | isRenderModeSet (final int mask) |
| final boolean | isVBAA () |
| Returns true if capable of two pass rendering - VBAA, otherwise false. More... | |
| final boolean | isMSAA () |
| Returns true if capable of two pass rendering - MSAA, otherwise false. More... | |
| final boolean | hasVariableWeight () |
| Returns true if capable of variable weights, otherwise false. More... | |
| final boolean | hasColorChannel () |
Returns true if getRenderModes() has a color channel, i.e. More... | |
| final boolean | hasColorTexture () |
| Returns true if render mode has a color texture, i.e. More... | |
| final Frustum | getFrustum () |
See setFrustum(Frustum). More... | |
| final void | setFrustum (final Frustum frustum) |
Set Frustum culling for addOutlineShape(OutlineShape, AffineTransform, float[]). More... | |
| PerfCounterCtrl | perfCounter () |
| final void | addOutlineShape (final OutlineShape shape, final AffineTransform t, final Vec4f rgbaColor) |
Add the given OutlineShape to this region with the given optional AffineTransform. More... | |
| final void | addOutlineShapes (final List< OutlineShape > shapes, final AffineTransform transform, final Vec4f rgbaColor) |
Add the given list of OutlineShapes to this region with the given optional AffineTransform. More... | |
| final AABBox | getBounds () |
| final void | markShapeDirty () |
| Mark this region's shape dirty, i.e. More... | |
| final boolean | isShapeDirty () |
Returns true if this region's shape are dirty, see markShapeDirty(). More... | |
| final void | markStateDirty () |
| Mark this region's render-state dirty, i.e. More... | |
| final boolean | isStateDirty () |
Returns true if this region's state is dirty, see markStateDirty(). More... | |
| String | toString () |
Static Public Member Functions | |
| static final int | clipAAQuality (final int v) |
Returns clipped AA quality value to [Region#MIN_AA_QUALITY..Region#MAX_AA_QUALITY]. More... | |
| static final int | clipAASampleCount (final int v) |
Returns clipped AA sample-count to [Region#MIN_AA_SAMPLE_COUNT..Region#MAX_AA_SAMPLE_COUNT]. More... | |
| static final boolean | isRenderModeSet (final int renderModes, final int mask) |
| static final int | setRenderMode (int renderModes, final int mask, final boolean v) |
| static boolean | isVBAA (final int renderModes) |
Returns true if given renderModes has Region#VBAA_RENDERING_BIT set. More... | |
| static boolean | isMSAA (final int renderModes) |
Returns true if given renderModes has Region#MSAA_RENDERING_BIT set. More... | |
| static boolean | isGraphAA (final int renderModes) |
Returns true if given renderModes has any of Region#AA_RENDERING_MASK set. More... | |
| static boolean | isTwoPass (final int renderModes) |
Returns true if given renderModes has any of Region#AA_RENDERING_MASK set. More... | |
| static boolean | hasVariableWeight (final int renderModes) |
| Returns true if render mode capable of variable weights, i.e. More... | |
| static boolean | hasColorChannel (final int renderModes) |
| Returns true if render mode has a color channel, i.e. More... | |
| static boolean | hasColorTexture (final int renderModes) |
| Returns true if render mode has a color texture, i.e. More... | |
| static String | getRenderModeString (final int renderModes) |
| Returns a unique technical description string for renderModes as follows: More... | |
| static String | getRenderModeString (final int renderModes, final int graphAAQuality, final int graphSampleCount, final int fsaaSampleCount) |
| Return a unique technical description string for renderModes and sample counts as follows: More... | |
| static final int[] | countOutlineShape (final OutlineShape shape, final int[] vertIndexCount) |
Count required number of vertices and indices adding to given int[2] vertIndexCount array. More... | |
| static final int[] | countOutlineShapes (final List< OutlineShape > shapes, final int[] vertIndexCount) |
Count required number of vertices and indices adding to given int[2] vertIndexCount array. More... | |
Static Public Attributes | |
| static final boolean | DEBUG_ALL_EVENT = Debug.debugExplicit("graph.curve.AllEvent") |
| static final boolean | DEBUG_INSTANCE = Debug.debugExplicit("graph.curve.Instance") |
| static final boolean | DEBUG = DEBUG_ALL_EVENT || Debug.debug("graph.curve") |
| Debug flag for [com. More... | |
| static final int | NORM_RENDERING_BIT = 0 |
Rendering-Mode bit for Region. More... | |
| static final int | MSAA_RENDERING_BIT = 1 << 0 |
Rendering-Mode bit for Region. More... | |
| static final int | VBAA_RENDERING_BIT = 1 << 1 |
Rendering-Mode bit for Region. More... | |
| static final int | AA_RENDERING_MASK = MSAA_RENDERING_BIT | VBAA_RENDERING_BIT |
2-pass rendering bit-mask including MSAA_RENDERING_BIT and VBAA_RENDERING_BIT. More... | |
| static final int | VARWEIGHT_RENDERING_BIT = 1 << 8 |
Rendering-Mode bit for Region. More... | |
| static final int | COLORCHANNEL_RENDERING_BIT = 1 << 9 |
Rendering-Mode bit for Region to optionally enable a color-channel per vertex. More... | |
| static final int | COLORTEXTURE_RENDERING_BIT = 1 << 10 |
Rendering-Mode bit for Region. More... | |
| static final int | MIN_AA_QUALITY = 0 |
Minimum pass2 AA-quality rendering {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT. More... | |
| static final int | MAX_AA_QUALITY = 1 |
Maximum pass2 AA-quality rendering {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT. More... | |
| static final int | DEFAULT_AA_QUALITY = MAX_AA_QUALITY |
Default pass2 AA-quality rendering {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT. More... | |
| static final int | MIN_AA_SAMPLE_COUNT = 1 |
Minimum pass2 AA sample count {@value} for Graph Region AA render-modes: Region#VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT. More... | |
| static final int | MAX_AA_SAMPLE_COUNT = 8 |
Maximum pass2 AA sample count {@value} for Graph Region AA render-modes: Region#VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT. More... | |
| static final int | DEFAULT_AA_SAMPLE_COUNT = 4 |
Default pass2 AA sample count {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT. More... | |
| static final int | DEFAULT_TWO_PASS_TEXTURE_UNIT = 0 |
Protected Member Functions | |
| Region (final int regionRenderModes, final boolean use_int32_idx) | |
| abstract void | pushVertex (final Vec3f coords, final Vec3f texParams, Vec4f rgba) |
| abstract void | pushVertices (final Vec3f coords1, final Vec3f coords2, final Vec3f coords3, final Vec3f texParams1, final Vec3f texParams2, final Vec3f texParams3, Vec4f rgba) |
| abstract void | pushIndex (int idx) |
| abstract void | pushIndices (int idx1, int idx2, int idx3) |
| final void | clearImpl () |
| final void | clearDirtyBits (final int v) |
See markShapeDirty() and markStateDirty(). More... | |
| final int | getDirtyBits () |
Static Protected Member Functions | |
| static void | put3i (final IntBuffer b, final int v1, final int v2, final int v3) |
| static void | put3s (final ShortBuffer b, final short v1, final short v2, final short v3) |
| static void | put3f (final FloatBuffer b, final Vec3f v) |
| static void | put4f (final FloatBuffer b, final float v1, final float v2, final float v3, final float v4) |
| static void | put4f (final FloatBuffer b, final Vec4f v) |
Protected Attributes | |
| final AABBox | box = new AABBox() |
| Frustum | frustum = null |
Static Protected Attributes | |
| static final int | DIRTY_SHAPE = 1 << 0 |
| static final int | DIRTY_STATE = 1 << 1 |
| static final int | GL_UINT16_MAX = 0xffff |
| static final int | GL_INT32_MAX = 0x7fffffff |
Abstract Outline shape representation define the method an OutlineShape(s) is bound and rendered.
Definition at line 62 of file Region.java.
|
protected |
Definition at line 288 of file Region.java.
| final void com.jogamp.graph.curve.Region.addOutlineShape | ( | final OutlineShape | shape, |
| final AffineTransform | t, | ||
| final Vec4f | rgbaColor | ||
| ) |
Add the given OutlineShape to this region with the given optional AffineTransform.
In case frustum culling is set, the OutlineShape is dropped if it's bounding-box is fully outside of the frustum. The optional AffineTransform is applied to the bounding-box beforehand.
| shape | the OutlineShape to add |
| t | the optional AffineTransform to be applied on each vertex |
| rgbaColor | if hasColorChannel() RGBA color must be passed, otherwise value is ignored. |
Definition at line 616 of file Region.java.
| final void com.jogamp.graph.curve.Region.addOutlineShapes | ( | final List< OutlineShape > | shapes, |
| final AffineTransform | transform, | ||
| final Vec4f | rgbaColor | ||
| ) |
Add the given list of OutlineShapes to this region with the given optional AffineTransform.
In case frustum culling is set, the OutlineShapes are dropped if it's bounding-box is fully outside of the frustum. The optional AffineTransform is applied to the bounding-box beforehand.
| shapes | list of OutlineShape to add |
| t | the optional AffineTransform to be applied on each vertex |
| rgbaColor | if hasColorChannel() RGBA color must be passed, otherwise value is ignored. |
Definition at line 776 of file Region.java.
|
protected |
See markShapeDirty() and markStateDirty().
Definition at line 822 of file Region.java.
|
protected |
Definition at line 346 of file Region.java.
|
static |
Returns clipped AA quality value to [Region#MIN_AA_QUALITY..Region#MAX_AA_QUALITY].
Definition at line 170 of file Region.java.
|
static |
Returns clipped AA sample-count to [Region#MIN_AA_SAMPLE_COUNT..Region#MAX_AA_SAMPLE_COUNT].
Definition at line 179 of file Region.java.
|
static |
Count required number of vertices and indices adding to given int[2] vertIndexCount array.
The region's buffer can be either set using Region#setBufferCapacity(int, int), GLRegion ctor w/ initial capacities or grown using Region#growBuffer(int, int).
Method is utilized in GLRegion ctor w/ font + text, computing the initial capacity.
| shape | the OutlineShape to count |
| vertIndexCount | the int[2] storage where the counted vertices and indices are added, vertices at [0] and indices at [1] |
Definition at line 572 of file Region.java.
|
static |
Count required number of vertices and indices adding to given int[2] vertIndexCount array.
The region's buffer can be either set using Region#setBufferCapacity(int, int), GLRegion ctor w/ initial capacities or grown using Region#growBuffer(int, int).
| shapes | list of OutlineShape to count |
| vertIndexCount | the int[2] storage where the counted vertices and indices are added, vertices at [0] and indices at [1] |
Definition at line 598 of file Region.java.
| final AABBox com.jogamp.graph.curve.Region.getBounds | ( | ) |
Definition at line 783 of file Region.java.
|
protected |
Definition at line 825 of file Region.java.
| final Frustum com.jogamp.graph.curve.Region.getFrustum | ( | ) |
See setFrustum(Frustum).
Definition at line 402 of file Region.java.
| final int com.jogamp.graph.curve.Region.getRenderModes | ( | ) |
Returns bit-field of render modes, see create(..).
Definition at line 344 of file Region.java.
|
static |
Returns a unique technical description string for renderModes as follows:
(vbaa|msaa|norm)[-curve][-cols][-ctex]
| renderModes | Graph renderModes, see create(..) |
Definition at line 251 of file Region.java.
|
static |
Return a unique technical description string for renderModes and sample counts as follows:
getRenderModeString(int)-q{AA-quality}-s{sampleCount}-fsaa{CapsNumSamples}
| renderModes | the used Graph renderModes, see create(..) |
| graphAAQuality | Graph AA quality, see DEFAULT_AA_QUALITY, set to negative value to mark undefined |
| graphSampleCount | Graph sample count for Region#VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT |
| fsaaSampleCount | full-screen AA (fsaa) sample count, retrieved e.g. via GLCapabilitiesImmutable#getNumSamples() |
Definition at line 280 of file Region.java.
|
abstract |
Increase the renderer buffers if necessary to add given counts of vertices- and index elements.
Buffers will not change if remaining free slots, capacity less position, satisfy count elements.
| verticesCount | number of vertex elements to add if necessary |
| indicesCount | number of index elements to add if necessary |
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
| final boolean com.jogamp.graph.curve.Region.hasColorChannel | ( | ) |
Returns true if getRenderModes() has a color channel, i.e.
COLORCHANNEL_RENDERING_BIT is set. Otherwise returns false.
Definition at line 386 of file Region.java.
|
static |
Returns true if render mode has a color channel, i.e.
the bit COLORCHANNEL_RENDERING_BIT is set, otherwise false.
Definition at line 231 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.hasColorTexture | ( | ) |
Returns true if render mode has a color texture, i.e.
the bit COLORTEXTURE_RENDERING_BIT is set, otherwise false.
Definition at line 397 of file Region.java.
|
static |
Returns true if render mode has a color texture, i.e.
the bit COLORTEXTURE_RENDERING_BIT is set, otherwise false.
Definition at line 240 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.hasVariableWeight | ( | ) |
Returns true if capable of variable weights, otherwise false.
Definition at line 374 of file Region.java.
|
static |
Returns true if render mode capable of variable weights, i.e.
the bit VARWEIGHT_RENDERING_BIT is set, otherwise false.
Definition at line 222 of file Region.java.
|
static |
Returns true if given renderModes has any of Region#AA_RENDERING_MASK set.
Definition at line 208 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.isMSAA | ( | ) |
Returns true if capable of two pass rendering - MSAA, otherwise false.
Definition at line 366 of file Region.java.
|
static |
Returns true if given renderModes has Region#MSAA_RENDERING_BIT set.
Definition at line 203 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.isRenderModeSet | ( | final int | mask | ) |
Definition at line 352 of file Region.java.
|
static |
Definition at line 194 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.isShapeDirty | ( | ) |
Returns true if this region's shape are dirty, see markShapeDirty().
Definition at line 801 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.isStateDirty | ( | ) |
Returns true if this region's state is dirty, see markStateDirty().
Definition at line 815 of file Region.java.
|
static |
Returns true if given renderModes has any of Region#AA_RENDERING_MASK set.
Definition at line 213 of file Region.java.
| final boolean com.jogamp.graph.curve.Region.isVBAA | ( | ) |
Returns true if capable of two pass rendering - VBAA, otherwise false.
Definition at line 358 of file Region.java.
|
static |
Returns true if given renderModes has Region#VBAA_RENDERING_BIT set.
Definition at line 198 of file Region.java.
| final void com.jogamp.graph.curve.Region.markShapeDirty | ( | ) |
Mark this region's shape dirty, i.e.
its vertices, triangles, lines and/or color-texture coordinates changed.
The data will be re-uploaded to the GPU at next draw(..).
In 2-pass mode, this implies updating the FBO itself as well.
Definition at line 797 of file Region.java.
| final void com.jogamp.graph.curve.Region.markStateDirty | ( | ) |
Mark this region's render-state dirty, i.e.
re-selecting a shader program regarding color-texture and -channel, and rendering the region into the FBO in 2-pass mode.
In 1-pass mode, re-selection of the shader-program is based on color-texture and -channel only.
Definition at line 811 of file Region.java.
| PerfCounterCtrl com.jogamp.graph.curve.Region.perfCounter | ( | ) |
|
abstract |
Print implementation buffer stats like detailed and total size and capacity in bytes etc.
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
|
abstractprotected |
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
|
abstractprotected |
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
|
abstractprotected |
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
|
abstractprotected |
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
|
staticprotected |
|
staticprotected |
|
staticprotected |
|
staticprotected |
|
staticprotected |
Definition at line 473 of file Region.java.
|
abstract |
Set the renderer buffers pre-emptively for given vertices- and index counts.
Buffers will not change if given count elements is lower or equal current capacity.
| verticesCount | number of vertices to hold |
| indicesCount | number of indices to hold |
Reimplemented in com.jogamp.graph.curve.opengl.GLRegion.
| final void com.jogamp.graph.curve.Region.setFrustum | ( | final Frustum | frustum | ) |
Set Frustum culling for addOutlineShape(OutlineShape, AffineTransform, float[]).
Definition at line 407 of file Region.java.
|
static |
Definition at line 195 of file Region.java.
| String com.jogamp.graph.curve.Region.toString | ( | ) |
| final boolean com.jogamp.graph.curve.Region.usesI32Idx | ( | ) |
Returns true if implementation uses int32_t sized indices implying at least a GLProfile#isGL2ES3() alike context.
Otherwise method returns false on GLProfile#isGLES2() using uint16_t sized indices.
Definition at line 305 of file Region.java.
|
static |
2-pass rendering bit-mask including MSAA_RENDERING_BIT and VBAA_RENDERING_BIT.
Definition at line 118 of file Region.java.
Definition at line 191 of file Region.java.
|
static |
Rendering-Mode bit for Region to optionally enable a color-channel per vertex.
If set, a color channel attribute per vertex is added to the stream via addOutlineShape(OutlineShape, AffineTransform, float[]), otherwise static color can being used for a monotonic color.
This mode-bit is a shader-key.
Definition at line 148 of file Region.java.
|
static |
Rendering-Mode bit for Region.
If set, a color texture is used to determine the color via {#link TextureSequence} passed to implementation, e.g. GLRegion.
This mode-bit is a shader-key.
Definition at line 161 of file Region.java.
|
static |
Debug flag for [com.
]jogamp.graph.curve.* incl. Region (graph.curve)
Definition at line 68 of file Region.java.
|
static |
Definition at line 64 of file Region.java.
|
static |
Definition at line 65 of file Region.java.
|
static |
Default pass2 AA-quality rendering {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT.
Definition at line 168 of file Region.java.
|
static |
Default pass2 AA sample count {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT.
Definition at line 177 of file Region.java.
|
static |
Definition at line 181 of file Region.java.
|
staticprotected |
Definition at line 183 of file Region.java.
|
staticprotected |
Definition at line 184 of file Region.java.
|
protected |
Definition at line 192 of file Region.java.
|
staticprotected |
Definition at line 480 of file Region.java.
|
staticprotected |
Definition at line 479 of file Region.java.
|
static |
Maximum pass2 AA-quality rendering {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT.
Definition at line 166 of file Region.java.
|
static |
Maximum pass2 AA sample count {@value} for Graph Region AA render-modes: Region#VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT.
Definition at line 175 of file Region.java.
|
static |
Minimum pass2 AA-quality rendering {@value} for Graph Region AA render-modes: VBAA_RENDERING_BIT.
Definition at line 164 of file Region.java.
|
static |
Minimum pass2 AA sample count {@value} for Graph Region AA render-modes: Region#VBAA_RENDERING_BIT or Region#MSAA_RENDERING_BIT.
Definition at line 173 of file Region.java.
|
static |
Rendering-Mode bit for Region.
MSAA based Anti-Aliasing, a two pass region rendering, slower and more resource hungry (FBO with sample buffer), but providing fast MSAA in case the whole scene is not rendered with MSAA.
In case sample count is 1, no FBO sample buffer is used but a simple bilinear texture filter.
This mode-bit is a shader-key.
Definition at line 95 of file Region.java.
|
static |
Rendering-Mode bit for Region.
One pass norm rendering either using no AA or underlying full-screen AA (fsaa).
This mode-bit is a shader-key.
Definition at line 79 of file Region.java.
|
static |
Rendering-Mode bit for Region.
Use non uniform weights [0.0 .. 1.9] for curve region rendering. Otherwise the default weight 1.0 for uniform curve region rendering is being applied.
This mode-bit is a shader-key.
Definition at line 131 of file Region.java.
|
static |
Rendering-Mode bit for Region.
View based Anti-Aliasing, a two pass region rendering, slower and more resource hungry (FBO), but AA is perfect. Otherwise the default fast one pass MSAA region rendering is being used.
In case sample count is 1, no FBO supersampling is performed but a simple bilinear texture filter used.
Depending on AA-quality, MAX_AA_QUALITY denotes full 4x billinear filtering per sample and 0 denotes 1x flipquad filtering per sample.
This mode-bit is a shader-key.
Definition at line 115 of file Region.java.