add and use getConvertedValue()
update javadoc