While obviously I would advocate the use of PDL for this sort of thing, zooming out a bit, I generally advocate "bulk" APIs, so here one could set e.g. a range of pixels to a range of colours, etc. This means that any expensive "finishing up" (or indeed input-checking) can be done only once, instead of after each sub-operation, because the module better knows what the user really wants.