CamTwist.QCInstructions

From Allocinit

Adding effects with Quartz Composer

Quartz Composer is part of the Apple developer tools package (http://developer.apple.com/tools/xcode/). Quartz Composer compositions can be used with CamTwist as long as they meet the follows conditions:

• At least 1 published input image.
• A renderer with 2x2 dimensions.

If an effect publishes more than 1 input image, the one called "inputImage" is used as the incoming frame and the others will present an image picker in the settings view.

As of the current version of CamTwist, only the following other input types are supported:

• Strings
• Numbers
• Colors
• Fonts
• Images
• Booleans

NOTE that numbers pose a minor complication. For the same of simplicity for the end user, Number inputs that have a min and max are shown as sliders. Numbers called "X_Position" or "Y_Position" are assumed to be vec2 positions and are bounded at [-1, 1]. Other numbers are shown as text fields unless you publish an input splitter, CamTwist will honor the min and max values.

NOTE that anything called "Font_Name" is assumed to be a font and presents a font picker.

If you create any cool effects, please send them to me so I can include them in the next release. Please don't send me copy-written work such as the effects from chatfx. I can't use them.

Installation of effects

Effects can be placed in the Effects folder that comes with CamTwist, or Library/Application Support/CamTwist/Effects.