multimedia: image api: update documentation

Signed-off-by: Harris Tzovanakis <me@drjova.com>