RhinoCommon API
PostEffectPipeline Class |
This object provides a way for post effects to access the frame buffer channels from a rendering and create
new channels containing post-processed information which can be passed to the next post effect in the chain.
Consider a simple post effect that just modifies the red component of a rendering.It will call GetChannel()
to get the red channel as its input, and it will call NewChannel() to get a new red channel for its output.
It will then read the input channel, do calculations and write to the output channel.When finished, it will
call Commit() passing the new channel.Because both channels have the same identifier, this will replace the
old channel with the new one so that subsequent post effects in the chain will use the new channel instead of the
original.Note that this will only replace the channel used by the pipeline.The original channel will still
exist in the frame buffer.This system allows any post effect to access any number of channels for reading and
create any number of new channels which may or may not replace existing channels depending on the channel
id.The final stage (convert to 8-bit) operates on the channels left in the pipeline by the post effect chain to
produce the final 32-bit RGBA image in a dib.
It is also possible for a post effect to create and use any number of 'scratch' channels.If a post effect needs a
temporary pixel buffer for some intermediate results, it can call NewChannel() with a custom (random) id.
Once it is finished with this scratch channel, it can call Discard() on it.
Namespace: Rhino.Render.PostEffects
Assembly: RhinoCommon (in RhinoCommon.dll)
The PostEffectPipeline type exposes the following members.
| Name | Description | |
|---|---|---|
| GPUAllowed |
Post effect authors should check that GPU use is allowed before using the GPU in a post effect.
| |
| IsRendering |
IsRendering
| |
| RenderingId |
Return a UUID that uniquely identifies the rendering being processed.
|
| Name | Description | |
|---|---|---|
| Dimensions |
Get the dimensions of the frame buffer. All channels in the frame buffer have the same dimensions.
| |
| Dispose | Releases all resources used by the PostEffectPipeline | |
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) | |
| Execute |
Execute the pipeline. This executes all the post effects in order.
Only this rectangle need be modified by the post effects.
| |
| ExecutionOrder |
Returns a list of the post effects to be executed by this pipeline in order.
| |
| Finalize | (Overrides ObjectFinalize.) | |
| GetChannelForRead |
Get a channel for reading. A post effect will use this to get channel data as input to
its process. Output will be written to new channel(s). \see GetChannelForWrite()
This method returns the current state of the channel at this stage in the pipeline.
If the first post effect calls this, it will get the actual frame buffer channel.
Subsequent post effects will get the data left behind by the previous post effect.
A post effect calls GetChannelForRead() to get its input and GetChannelForWrite()
to get the object to which it will write its output. Even when the same channel id
is specified, these are separate, unconnected objects.
| |
| GetChannelForWrite |
Get a channel for writing. A post effect will use this to get channel(s) to write the output of its
processing to. Input will usually come from existing channels, although a post effect is free to read
its own output channels if needed. See GetChannelForRead()
You are allowed to create one new channel with the same identifier as an existing channel,
in which case IChannel::Commit() will replace the existing channel with the new one in the pipeline.
| |
| GetEndTimeInMilliseconds |
Get the end time of the rendering expressed in milliseconds since some unspecified epoch.
Do not make assumptions about what the epoch is; it might be different on different platforms.
| |
| GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
| GetMaxLuminance |
Get the max luminance in the rendering.
| |
| GetStartTimeInMilliseconds |
Get the start time of the rendering expressed in milliseconds since some unspecified epoch.
Do not make assumptions about what the epoch is; it might be different on different platforms.
| |
| GetType | Gets the Type of the current instance. (Inherited from Object.) | |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
| SetStartTimeInMilliseconds |
Set the start time of the rendering in milliseconds since some unspecified epoch.
| |
| ThreadEngine |
Get the post effect thread engine.
| |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |