Live data from Hacker News

OpenGL API Documentation

docs.gl

11–20 of 44 posts

Re: OpenGL API Documentation

#11
post #4

Earlier quoted context omitted.

What else would be there? ("Method" as the column name is actually incorrect... they're just bare C functions.)

https://github.com/BSVino/docs.gl/pull/24 :D

I find term "function" rather confusing and improper for programming language construct, because we use the same term in natural languages that is not necessarily 1:1 mapping. Consider commit message: "Implemented function `sort()` implementing sort(ing) function(ality)".

Re: OpenGL API Documentation

#12
Cool! But some ideas to make it even better:

* Support distinction between compatibility and core profiles. As is, it looks like GL3 is compatibility and GL4 is core.

* For GL4, show the version which introduced the feature (e.g., GL4.2). For GL3 and earlier I don't care.

* Allow compatibility functions to be filtered out entirely. I don't want glLightModel() or other old fixed-function stuff cluttering up the screen.

* GLSL 3.

* Minor cheat sheet showing differences between, say, GLSL 120, 330, and 4x0. For example, 120 has "attribute" and "varying", while 330 has "in" and "out".

I recommend that everyone use the compiler to help avoid functions and constants from later versions of OpenGL, if you are targeting old versions. For example, if you are targeting 3.3, then you can either use a header file that only defines 3.3, or you can use a header file that puts functions and constants in a namespace (e.g. "using namespace gl_3_3;").

Re: OpenGL API Documentation

#14
post #4

Earlier quoted context omitted.

What else would be there? ("Method" as the column name is actually incorrect... they're just bare C functions.)

https://github.com/BSVino/docs.gl/pull/24 :D

I think they are typically called "entry points", at least in the spec. The term "function" is used for GLSL functions and for things like blending functions.

Re: OpenGL API Documentation

#15

Earlier quoted context omitted.

https://github.com/BSVino/docs.gl/pull/24 :D

I find term "function" rather confusing and improper for programming language construct, because we use the same term in natural languages that is not necessarily 1:1 mapping. Consider commit message: "Implemented function `sort()` implementing sort(ing) function(ality)".

In that case you can omit the left side: "Implemented sorting functionality" or the right side: "Implemented function: sort".

Re: OpenGL API Documentation

#16
As a complete newcomer to OpenGL, my first thought was "where's the WebGL column?"

Now, that makes probably no sense; can someone clarify what these versions mean (apart from API availability described by this table, obviously), and if there's a relationship to the WebGL subset (it is a subset, right?).

Re: OpenGL API Documentation

#17

As a complete newcomer to OpenGL, my first thought was "where's the WebGL column?" Now, that makes probably no sense; can someone clarify what these versions mean (apart from API availability described by this table, obviously), and if there's a relationship to the WebGL subset (it is a subset, right?).

https://www.khronos.org/webgl/

"WebGL: OpenGL ES 2.0 for the Web"

Re: OpenGL API Documentation

#18

As a complete newcomer to OpenGL, my first thought was "where's the WebGL column?" Now, that makes probably no sense; can someone clarify what these versions mean (apart from API availability described by this table, obviously), and if there's a relationship to the WebGL subset (it is a subset, right?).

WebGL is based on OpenGL ES, so look at the es2 column.

Re: OpenGL API Documentation

#19

Earlier quoted context omitted.

https://github.com/BSVino/docs.gl/pull/24 :D

I find term "function" rather confusing and improper for programming language construct, because we use the same term in natural languages that is not necessarily 1:1 mapping. Consider commit message: "Implemented function `sort()` implementing sort(ing) function(ality)".

If we want to get really picky, they are procedures.

I think we should start to transition to using the word function only in the connotation provided in functional programming languages, where functions are first class citizens and can be treated as values. Also, should probably prefer to imply a lack of side effects from the word function.

Method is clearly a certain function or procedure that is scoped to a class. So that leaves procedure as a name left over for the type of bare function that isn't a value, that is a statement rather than an expression.

I think subroutine and subprogram are just archaic sounding, and don't really imply anything that the others don't. Method, functions, procedures, I think that's all we need.

Re: OpenGL API Documentation

#20
post #17

As a complete newcomer to OpenGL, my first thought was "where's the WebGL column?" Now, that makes probably no sense; can someone clarify what these versions mean (apart from API availability described by this table, obviously), and if there's a relationship to the WebGL subset (it is a subset, right?).

https://www.khronos.org/webgl/ "WebGL: OpenGL ES 2.0 for the Web"

Simple. Was expected something more complicated, I could have looked further before asking ^^.

Anyway, thanks!

Post reply on HN