I have 2 remarks on this function:
- parameter is required, why not optional and if NULL => Current album (as for most other functions)
- counts also images that are set invisible :-(

Sorry, forget the second remark (count is correct)