Originally, I thought this function would be similar to the Posterize function, or at least, any one of the Imagick class functions that produces an artistic effect (like the oilPaintImage function). This function can be used for those purposes, but it is mostly geared toward print production. The OrderedPosterize is simply a highly flexible dithering tool. The intention essentially is to produce high-resolution imagery by means of using constant dots across a medium that vary in size according to the detail of the imagery. Everyone has seen a dithered photograph inside of a newspaper, but the wiki page provides better examples: http://www.php.net/manual/en/imagick.constants.php#imagick.constants.channel .
Finally, don't forget you can use bitwise operators on the second parameter. That means you can use & to AND them, | to OR them, & to XOR them, and ~ to NEGATE them. A valid parameter for the second parameter would be: "((~imagick::CHANNEL_GREEN) ^ imagick::CHANNEL_YELLOW) | imagick::CHANNEL_MAGENTA)". You can get extremely creative in this particular parameter. And if you want to define your own brushes using simple XML, then that's also true of the first parameter, too.
Note: You can use this function artistically. How? Use the orderedPosterizeImage to give the image some texture (a photo of a vase, for instance), and then use your OilPoint, Sketch, or Standard Posterize to give the image a cool effect. Alone, though, seems pretty boring.
And now, a very simple demonstration :
<?php
/ Author: [email protected]
/ Filename
/ ---------------------------------------------
$file_to_grab_with_location = "graphics_engine/image_workshop_directory/ordered_posterize_source.bmp"
$imagick_type = new Imagick();
/ Open File
/ ---------------------------------------------
$file_handle_for_viewing_image_file = fopen($file_to_grab_with_location, 'a+');
$imagick_type->readImageFile($file_handle_for_viewing_image_file);
/ Perform Function
/ ---------------------------------------------
$imagick_type->orderedPosterizeImage("o2x2", imagick::CHANNEL_GREEN);
/ Save File
/ ---------------------------------------------
$file_to_save_with_location = "graphics_engine/image_workshop_directory/ordered_posterize_result.bmp"
$file_handle_for_saving_image_file = fopen($file_to_save_with_location, 'a+');
$imagick_type->writeImageFile($file_handle_for_saving_image_file);
?>