Generally you do the following steps to configure a pipe:
Create pipe by entering its name under "Grid -> Control Pipes -> New Pipe". This will create a new status for the pipe under "Status" and a new indicator for it under "Frames".
Set input of the pipe by registering the status to filter with the pipes indicator under "Grid -> Frames -> <pipe name>"
Set the destination of the pipe by registering the pipes status with the destination indicator under "Grid -> Frames -> <destination indicator>"
Configure the pipes Guards and Filters by adding new ones under "Grid -> Status -> <pipe name> -> <Filters/Guards>"
Some example configurations
"Shadow ward pipe" - As a priest I use GridStatusMissingBuffs to display missing buffs. But since Shadow ward isn't always needed I want to be able to easily toggling showing missing shadow wards on/off. To do this I pipe its state through a pipe which uses the KeyGuard. So I can toggling showing of missing shadow wards by pressing a key.
"Remaining Health pipe" - Most times health deficite is the only value I need to know for healing. But in some cases I need to know the remaining health of a unit to decide who needs special healing (during AoE for example). For this I pipe grids health status through a pipe with a "ToTextFilter" (to convert the health value to a text), a "ThresholdGuard" (to show remaining health only on half death people) and a "KeyGuard" (to toggle this on of).
"Debuff white list pipe" - Grid doesn't come with a whitelist for the debuff type status. To add this I pipe the debuff type status through a pipe with a "AuraGuard" where I can add the debuffs of this kind i don't need to see.
"Remaining hot duration pipe" - I use the mana bar of GridManaBars to show the remaining time of my hots on a unit by piping the "Aura Status" of the hot through a pipe with a "ToBarFilter". The destination of the pipe is the Mana bar indicator.
There are a lot more things you can use it for, just play around with it .
If you need other guards or filters tell me, its pretty easy to add new ones.
The reaction of the key depends on the duration you keep the key pressed. This means, if you keep the key pressed for more than 300ms the key will react as "while key is pressed", otherwise it will react like "toggle on key press".
Please resist the urge to create loops with the pipes! I know its tempting but I didn't test what happens if you do so and I won't take responsibility if it caused the ending of the world! Seriously!
- update for 4.0
- moved pipe status configuration to own sub tree
- made "to-text" filter applicable for duration and stacks
- fixed duplicate config bug
- added hunters to class filter
- updated toc
- made aura white(/black) list work with dmgtype status