Implementation

A custom Fx operator is written as a set of pre-defined user functions which define the setup and rendering of an effect. These fall into three main areas:

Process Definition and Initialization
- Process identification
- Input, output and parameter definition
- Process and parameter initialization
Process Rendering
- Pre- and post-rendering
- Defined output and required input region calculation
- Rendering
External User Interface
- Editor screen drawing
- Editor screen interaction

These user functions communicate with the main body of code via an interface library of support functions. The UFO code is compiled and linked into a Dynamic Shared Object (.so) or Dynamically Linked Library (.dll) which is loaded into Softimage at run-time.

The symbols for the pre-defined functions are searched for in the custom Fx operator and their addresses are tabulated for future calling. The final appearance when the operator is run is as if the functions were directly linked into the product.

The interface library is written with C binding for which the following header files are supplied:

ufoProcess.h: Process interface and general interface. Contains Functions the host provides to the plug-ins to get and set plug-in properties, to be called during plug-in definition and during rendering.
ufoRaster.h: Raster access interface, pixel structures, and constants.
ufoTypes.h: General interface constant definitions.
ufoEditor.h: Editor interface. Contains functions the host provides to help implement OpenGL interactive tools.
ufoFunctions.h: The complete set of user functions is declared in the header file. This should be included in the UFO source code files to enforce the correct function prototypes of the functions the UFO plug-in can implement.
ufoUnixCompat.h: Defines rint(), drand48, random, and M_PI for easy portability of plug-ins between Linux and Windows. random is garanteed to have good distribution and provide same results on both platforms, and should be used under Windows instead of the compiler-provided random number generator.

The user functions are:

Function	Description
ufoProcessDefine	process definition and initialization
ufoProcessCopyUserData	user data copy
ufoProcessDeleteUserData	user data delete
ufoProcessPreSequenceRender	pre-render sequence
ufoProcessPostSequenceRender	post-render sequence
ufoProcessCanAvoidRendering	pre-frame render function to determine if rendering can be avoided
ufoProcessPreRender	pre-render
ufoProcessPostRender	post-render
ufoProcessPreRenderPass	pre-render pass
ufoProcessPostRenderPass	post-render pass
ufoProcessRenderPixel	pixel render
ufoProcessRenderLine	line render
ufoProcessRenderRectangle	rectangle render
ufoProcessCalcDefinedRectangle	calculate rectangle which can be rendered to output(s)
ufoProcessCalcNeedRectangles	calculate rectangles which are required from inputs
ufoProcessCalcDefinedPixelType	calculate the "best" pixel type given the supplied input pixel types
ufoProcessSpecifyConvertPixelTypes	specify input and output pixel type conversions
ufoProcessParamsEdited	callback routine on parameter edits; can also set other parameters to be changed too
ufoEditorBeginViewerEditing	Called when a process is being edited in a viewer, redraw and mouse callbacks can be expected to be called.
UfoEditorEndViewerEditing	Called when a process is no longer being edited in a viewer.
ufoEditorRGBDraw	draw into RGB plane of screen
ufoEditorOverlayDraw	draw into overlay plane of screen
ufoEditorMouseDown	process mouse button down event onscreen
ufoEditorMouseUp	process mouse button up event onscreen
ufoEditorMouseDrag	process mouse drag onscreen
ufoEditorMousePosition	process mouse move (no buttons down) event onscreen
ufoEditorKeyEvent	process key event onscreen
ufoEditorSetParamGroup	set/change parameter group to be drawn or displayed in GUI

The minimum requirement is that an operator defines ufoProcessDefine, and one of the following: ufoProcessRenderPixel, ufoProcessRenderLine and ufoProcessRender-Rectangle. If this requirement is not met, then the operator process cannot be used and will not appear in Fx tree.

The minimum requirement for screen interaction is that an operator defines ufoEditorCreate, and one of the following: ufoEditorRGBDraw, ufoEditorOverlayDraw, ufoEditorMouseDown, ufoEditorMouseUp, ufoEditorMouseDrag, ufoEditorMousePosition, and ufoEditorKeyEvent.

The minimum requirement for a user-defined X Motif GUI is that anoperator defines both ufoEditorCreate and ufoEditorUpdateGui.

Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License