Clone Source Document Switching Scripts
It may sometimes be desirable to clone imagery from multiple source documents to a single destination image. Examples of this may be in the creation of a collage, cloning specific elements to augment your artwork, or cloning back specific areas of imagery from a previous iterative save document (reiterative restoration to coin a phrase).

The following script libraries have been developed to facilitate fast switching between multiple clone source documents in Corel Painter. The standard method is to select the clone source document from the File menu (defaults to Current Pattern when no other clone source is selected). By sequentially renaming the source documents, individual scripts can now switch between these via a custom palette(s)without the need to continually select from the File menu.

Below are screen shots of the associated custom palette arrangements created for the PC platform (Painter IX.5 in this example);

The above custom palettes allow (among other features), switching between up to eight rif, psd and/or jpg source documents of the same size as the destination image. It is perfectly acceptable to mix the source file types (although jpg images have the disadvantage of being a lossy file format if image detail is a concern).

The limiting factors with this system are that in order to switch between the documents and subsequently clone from them, the respective source files must be open in Painter (but can be in a minimised window). It is also necessary that each source file is precisely named to match the respective switching script.

In order to minimise the drain on system resources when multiple documents are simultaneously open, it would be prudent to first clone a multi-layered document and Save As using the appropriate name to use as a source image. Doing so will flatten the image and significantly reduce the file size, whilst leaving the original documents untouched. However, leaving a clone source document in a layered state has the advantage of clone-ability from only visible imagery in the clone source. This is achieved by first bringing the respective clone source document window to the front and clicking the individual eye icons in the Layers palette to hide or show imagery on the respective layer(s) or canvas.

When multiple images are being used as clone sources, (depending on their file size and individual system resources), it may be necessary to have only three or four open at any one time. Remember that the source image windows can also be minimised and maximised as desired.

Naming Convention (PC).

In the PC version of the script library, in order for source files saved in Painter's native RIFF format to be switched by custom palette icons 1 to 8 (see key image above), the image files must be named s1.rif to associate with the first icon, through to s8.rif (lower case).

For images saved in the Photoshop PSD format, to be associated with icons 9 to 16, they must be named s1.psd through to s8.psd

To associate source images with the upper eight icons in the custom palette above right, they must be named s1.jpg through to s8.jpg (used for images saved in the JPG format).

Mac Platform Version.

The Mac version scripts differ by the fact that as Windows file extensions are not currently required in order for the image files to be recognised in Painter. Simply by naming any applicable file (of a format which Painter can open and clone from) as s1 through to s8, life becomes simpler still. The image below left demonstrates the equivalent Mac version custom palette (in this case docked with the default Cloning palette);

Mac OSX Tips

As the custom palette icons do not show the thumbnails (if available) for the associated images, place all the clone source files you wish to use for the project in a single folder and arrange the Finder view to display the file icons (see screen shot on right). See also Thumbnailer.

As an added bonus, if the file Creator codes are assigned ART9 then double clicking the respective icon in the Finder window will automatically open the document in Painter IX (use FSX3 as the Creator code for earlier versions of Painter).

Other Features (applicable to both platforms).

Immediately below the clone source selection icons in the above custom palettes is a row of four 'stamp' icons. The first and second of these facilitate switching the Clone Color option on and off respectively. These are used to toggle applicable, Clone Color and normally non-cloning variants to a cloning or non-cloning state.

The two 'stamp' icons to the right of these were created by selecting first the Soft Cloner variant from the default Cloners brush category, and dragging the associated Brush Variant icon from the Brush Selector Bar (Brushes palette in earlier versions) to the custom palette window. This was repeated for the Straight Cloner variant. These allow rapid switching between the Soft and Straight Cloner variants as well as auto-loading/selection of the default Cloners Brush Category. As you can see from the screen-shot, the Soft Cloner icon has been modified before dragging(as outlined in the tutorial here).

There are several different clone method types in Painter. The default for the Soft and Straight Cloner variants is Normal(0), and the (0) icon button in the above palettes is used to quickly restore a variant to the Normal cloning type. This is particularly useful when switching from Point-to-Point (offset cloning) to Normal cloning. Jeremy Sutton demonstrates wonderfully the associated problem in his Resetting the Clone Source article. You can deduce in relation to this issue, that using the above custom palettes allows the clone source to be quickly re-established (Jeremy's step 5), whilst subsequently clicking on the (0) icon in the custom palette replaces the need to Restore the Default variant (Jeremy's step 6). As clicking the (0) icon only resets the clone method to Normal, no other brush setting changes are lost, as would be the case after Restore Default Variant.

Last but not least, the command buttons for Quick Clone (introduced in Painter IX), Clone and Save As have been added to the custom palettes via Window menu> Custom Palette> Add Command.

Downloading and Installing the Resources. (523 kb) for Painter 7 through IX.5 PC.

scripts_mac_dl2_folder.dmg (563 kb) for Painter 7 through IX.5 Mac.

Note: The download folder also contains a folder of four RIFF clone source images for you to experiment with in conjunction with the scripts. The Mac versions are named for use with the S1 to S4 switching scripts, while the PC versions are named for use with the S1 rif to S4 rif scripts in the respective custom palettes.

How to Load;

In Painter 7 and 8, first place the enclosed script library at the top level of your Painter application folder.

For the script library to auto-load via a linked custom palette in Painter IX/ IX.5, the script library must be placed at the top level of your users Painter IX /IX.5 folder which can be found at the following locations;

Users > [username] > Library > Application Support > Corel > Painter IX

Documents and Settings > [username] > Application Data > Corel > Corel Painter IX

Once in the correct location, use the 'Load Library' option from the Scripts palette> Script Selector window> menu.

If individual scripts are to be run via a custom palette, due to a Painter bug, first drag the script icons onto the desktop/ custom palette, re-arrange the palette icons if desired, then quit Painter without clicking any of the icons in the newly created custom palette. Failure to do this may result in Painter crashing. Re-launch Painter and try out the scripts via the respective custom palette.

In Painter 7 and 8.1, the respective script library must first be loaded for the scripts to run from the custom palette. In Painter IX/ IX.5, the script library will auto-load when the relevant custom palette icon is clicked.


Prior to Painter IX, the method used to create and prepare a new document for cloning from a clone source image is to first Clone the source image File menu> Clone which creates a clone source/destination relationship between the two documents, then to Select All in the destination document before pressing the Delete/Backspace key to clear the canvas. By clicking the Tracing Paper icon (top right of the document window), the clone source image may be viewed at 50% opacity in the destination document. Clicking the icon a second time turns the feature off.

Painter IX saw the addition of a Quick Clone option to automatically perform the above tasks (customisable in the Preferences> General> Quick Clone section). In addition, by pressing and holding the Tracing Paper icon in the document window, there is now a flyout menu to set the tracing paper opacity.

In order to use Tracing Paper in conjunction with the clone source switching scripts, both source and destination documents must be the same size. To refresh the tracing paper source image after switching to a different source document, simply click the Tracing Paper icon twice.