ehh not really a case of RTFM, his usage is also correct. From the same section, just a little higher up:
$image->Write(filename=>'image.png', compression=>'None');

This may sound like a "duh!" but does the directory you are trying to write to exist already? IM won't create a new directory.