Update glGenTextures.xhtml

[cuppajoeman]

Add a description from a functional point of view.

[BSVino]

Hello! Thanks for contributing a PR.

Technically you are correct, OpenGL Names/Handles are usually numbers (or sometimes a pointer) but that's not their point - you're not supposed to do anything with the exact number contained in the handle. You're supposed to consider it as opaque and hand it back to OpenGL exactly how you got it.

I don't mind a note saying that it's backed by a signed 32 bit integer or whatever as long as it's clear that you're not supposed to do any operations on it.

Also you have a few spelling errors I'd like to see fixed.

Thanks again :)

[cuppajoeman]

Hello! Thanks for contributing a PR.

Technically you are correct, OpenGL Names/Handles are usually numbers (or sometimes a pointer) but that's not their point - you're not supposed to do anything with the exact number contained in the handle. You're supposed to consider it as opaque and hand it back to OpenGL exactly how you got it.

I don't mind a note saying that it's backed by a signed 32 bit integer or whatever as long as it's clear that you're not supposed to do any operations on it.

Also you have a few spelling errors I'd like to see fixed.

Thanks again :)

Hey there,

I appreciate the feedback you've given me. When I wrote this edit I had just started to understand the processes involved with operating opengl, and this edit was written from that point of view, that is:

someone who doesn't really know what the purpose of what these returned numbers were and what they are used for.

After reading your notes here I would say I fully understand what the point is of these texture "names", but I would say the beginner me wouldn't have understood.

What are your thoughts on adding the following text instead of my original change:

The generated texture names act as opaque handles that you can use to query the opengl context for further  operations on the generated texture

I also know that docs.gl simply acts as structured documentation for opengl, and not as a tutorial on how opengl works and things like that so let me know if that would be out of place.

[BSVino]

I'm fine with a bit of tutorialization. Also fine with that new sentence so long as the spelling error is fixed.