ufoProcessReleaseRasterInAtFram e

Related Functions: ufoProcessGetRasterInAtFrame

    ufoRaster ufoProcessGetRasterInAtFrame(

    ufoProcess process_instance,

    int input_index,
    int frame,
    int field);

    ufoProcessReleaseRasterInAtFrame(

    ufoProcess process_instance,

    int input_index,
    int frame,
    int field);

ufoProcessGetRasterInAtFrame returns a handle to a ufoRaster instance for a specified frame and field.

The field argument is only relevant during field rendering in which case it should be set to 1 or 2. ufoProcessGetRasterInAtFrame returns the raster for an input at the specified frame (and field). The function includes a field argument which is used when field rendering (see ufoProcessFieldRendering).

Each call to ufoProcessGetRasterInAtFrame with a unique frame (and field) will lock a raster in memory by the application memory manager until ufoProcessReleaseRasterInAtFrame is subsequently called with that frame (and field). It is very important to use this function to unlock memory from the memory manager and not keep many frames locked in memory simultaneously. If you don't call ufoProcessReleaseRasterInAtFrame then all accessed frame rasters will remain locked until after the UFO process has finished rendering at that frame.

Temporal access only works if the input is connected directly to a clip. ufoProcessIsRasterInTemporal can be used to test this.

The raster handle returned by can be passed in calls to raster functions that take a ufoRaster handle as their first argument. These are functions to set and get pixel values, to inquire raster attributes and buffer pointers, and for raster copying.

ufoProcessGetRasterInAtFrame and ufoProcessReleaseRasterInAtFrame may be called within ufoProcessRenderPixel, ufoProcessRenderLine, ufoProcessRenderRectangle, ufoProcessPreRender, ufoProcessPostRender, ufoProcessPreRenderPass, and ufoProcessPostRenderPass.

Autodesk Softimage v7.5