Document transformation

Log-in or register.

Document transformation

Document transformation is a plug-ins that takes one document and creates another one. It may for example produce an icon document from a raster image document.

Document transformation plug-ins are similar to the operation plug-ins. Instead of modifying the passed document, they create and return a new document, using information from the original one.

Document transformations may only be used within the Sequence operation. Since a new document is created by the transformation, it should never be the last step in the sequence. Something should be done with the create document, such as saving it or opening it in a new window.

Beside the actual document, the operation can also access view states, the current window and current locale identifier. Document transformation should in normal cases not interact with the user, it can return a localized error message should the need arise.

The Sequence operation can harbor multiple operations as well as transformations. It is currently the only way how to use transformations in RealWorld Designer applications. Typical use case is a sequence of transformation followed by an operation that either opens the document created by the operation in new or current window or saves the document.

Transformations by class

Common transformations

  • Display configuration transformation - show a configuration dialog before the transformation is actually executed giving the user a change to modify transformation's parameters. The dialog may contain a preview window.

Document-specific transformations

Implementing a Transformation

From technical point of view a Transformation plug-in is a COM class placed in a category CATID_DocumentTransformation and implementing an IDocumentTransformation interface.

GUID CATID_DocumentTransformation =
    {0xd6313391, 0x6375, 0x4e57, {0x9b, 0x8f, 0xbd, 0x6e, 0x83, 0xfa, 0xf5, 0x01}};

Recent comments

user icon Anonymous
Select background
Vista & Win 7 icons