Annotations

[amartinz]

Annotate some methods, to help to prevent passing in invalid values, eg resource ids instead of the resolved color.

add color methods, which take resource ids as parameters.

compare color with Integer.MIN as 0 is a valid color.