King Charles III's Scottish home, Palace of Holyroodhouse, has the most spectacular room – but it's also home to a divisive painting