As an experienced programmer I find that the Blender API is lacking in code examples. Often I know what I want to do with the API, but I just can’t find an example of the syntax.
Generally an API function has Parameters and Returns specified, but it does not have Usage specified. Seems like this is a gaping omission by the documentors. Shouldn’t there be a requirement that documentors supply Usage as well as Parameter and Returns?
I can go to this link and see some example code. (yeah!)
But as I dig a little deeper to the function I need.
I am left high and dry on how to operate or extract my RGBA values. I know what RGBA is. I know I have chosen this routine because I want the 0-255 values. But how do I get my red value from the list that is returned? And this is only one example. Multiply that by the number of functions I am trying to use and a wall suddenly appears. I think it is this wall that leads us to the forum to ask for help.
I know this is open source software and persons at different levels of understanding are contributing. But I am asking the person that already knows a little more to put that extra piece of code into the documentation for beginers.