Internal Effects

OpenTZT comes with a quite large set of internal effects. It's no use to describe them all in detail, you just should simply try them out. Sometimes it depends on the content of the clip you applying the effect to if it produces a noticable result. For example, if you try to use the monotone effect an already black 'n white clip, you will get nothing different.

There are two different ways to apply effects to a player. The first and main way is to hold down one of the Ctrl keys (left Ctrl for the left effect and the right Ctrl ... you know) and use the keys Q W E R T Y   A S D F G H   Z X C V B N An Effect that are applied this way will remain in the effect slot until it's replaced by another effect. To remove an effect, just replace it with the "No FX" effect which will be mapped to Q in every effects page.
The second way is to use the numerical keys to apply effects. These effects replace the left effect temporarily as long as the numer key is pressed, if you release the key the previous effect will be restored.

Some of the effects use a second input stream from the previous player for rendering. These effects are called "non threadable" (NT) because they limit openTZT's multithreading abilities (only as long as they're applied). If you apply such an effect to a player, openTZT can no longer render this player in parallel to the other players. In other words, this player has to wait until the previous player has finished rendering. OpenTZT always tries to do as much work as possible at the same time, so it's also dependent on where (left or right; which player) you apply a NT effect or how you combine it with other effects.

If you don't tell openTZT how to map it's internal effects to your keyboard it will just start with Bank0/Page1(F1)/W (Q will be skipped) and distribute it's complete list of effects. You can override this with a keymap.ini file in each \F*\ folder.

Below is a sample keymap.ini for the mapping to the main effect keys.

		[ Setting ]
		Mapping=1
		
		# q is skipped
		
		w=Monotone(IN)
		e=Scanline(IN)
		r=Divide N(IN)
		t=Solarize(IN)
		y=Tunnel(IN)
		
		a=RotoZoom(IN)
		s=KaleidoScope(IN)
		d=RotoPattern(IN)
		f=LandScape(IN)
		g=CyclicWave(IN)
		h=Wave(IN)
		
		z=Zoom(IN)
		x=CrossZoom(IN)
		c=Time Divide N(IN)
		v=Hunsync(IN)
		b=Vunsync(IN)
		n=Hi Contrast(IN)
	

Since the numpad uses number keys the keymap.ini slightly differs for the \Bank9\F*\ folders:

		[setting]
		mapping=1
		
		1=Solarize(IN)
		2=ColorBeat(IN)
		3=CrossZoom(IN)
		4=Change Color2(IN)
		5=Vunsync(IN)
		6=Reverse Flash(IN)
		7=Position Wiggle(IN)
		8=Divide Delay(IN)
		9=Flash(IN)
	

Here's a list off all the effects openTZT includes, the fourth colum holds the name of the effect you have to use for the keymap.ini files.
Effects that don't support multithreading are marked with a different background color.

Icon Effect Description Parameters Internal Name
No fx This is actually no real effect, it just passes the incoming image right to the output. no parameters none
Monotone Desaturates the image (makes it black and white). no parameters Monotone(IN)
Scanline Draws only every second line of the image. no parameters Scanline(IN)
Divide N . . Divide N(IN)
Time Divide N . . Time Divide N(IN)
Tunnel . . Tunnel(IN)
Tunnel Extended . . Tunnel Ex(IN)
Roto Zoom . . RotoZoom(IN)
Landscape . . LandScape(IN)
Landscape Extended . . LandScape Ex(IN)
Kaleidoscope . . KaleidoScope(IN)
Roto Pattern . . RotoPattern(IN)
Cyclic Wave . . CyclicWave(IN)
Wave . . Wave(IN)
Zoom . . Zoom(IN)
Cross Zoom . . CrossZoom(IN)
Vertical Unsync . . Vunsync(IN)
Horizontal Unsync . . Hunsync(IN)
Water Surface . . WaterSurface(IN)
Ghost . . Ghost(IN)
Alpha Blur . . AlphaBlur(IN)
Zoom Blur . . ZoomBlur(IN)
Diffuse . . Diffuse(IN)
Smooth . . Smooth(IN)
Glow . . Glow(IN)
Flash . . Flash(IN)
Divide Delay . . Divide Delay(IN)
Spiral . . Spiral(IN)
Divide Str . . Divide Str(IN)
Feedback . . FeedBack(IN)
Jitter . . Jitter(IN)
3D Rot . . 3DRot(IN)
3D Bounce . . 3DBounce(IN)
3D Flying . . 3DFlying(IN)
3D Flying 2 . . 3DFlying2(IN)
Change Color . . Change Color(IN)
Position Wiggle . . Position Wiggle(IN)
3D Flying 3 . . 3DFlying3(IN)
3D Wave . . 3DWave(IN)
3D Cylinder . . 3DCylinder(IN)
3D Sphere . . 3DSphere(IN)
3D ZWave . . 3DZWave(IN)
Brightness . . Bright(IN)
Change Color Beat Canges clip color with BPM sync P1=beats between change Change Color2(IN)
High Contrast . . Hi Contrast(IN)
Reverse Inverts the image no parameters Reverse(IN)
Reverse Flash . . Reverse Flash(IN)
Layout . . Layout(IN)
Smear . . Smear(IN)
Time Jitter . . Time Jitter(IN)
Mozaic . . Mozaic(IN)
2D Rotation . . 2DRotation(IN)
Motion Edge . . MotionEdge(IN)
Horizontal Wipe . . HWipe(IN)
Vertical Wipe . . VWipe(IN)
Color Beat . . ColorBeat(IN)
Reverse Beat . . ReverseBeat(IN)
Solarize . . Solarize(IN)
Feedback 2 . . FeedBack2(IN)
Multi Vertical Wipe . . MultiVWipe(IN)
Crome . . Crome(IN)

Effect Plugins

OpenTZT can load two types of effect plugins. An openTZT specific DLL which takes advantage of all the features openTZT provides, and it's is also able to load FreeFrame plugins. Esotic has written a lot of openTZT specific plugins. His plugins are provided along with the openTZT distribution. There's also a long list of FreeFrame plugins available on their website.

Currently all plugin effects are non threadable. Read more about multithreading and effects in the Internal Effects section.

There's a catch on the effect plugins. While the openTZT plugins provide at least an icon, the FreeFrame plugins are completely indistinguishable from another in an effect page. Every plugin has the same icon and the plugin name isn't shown. This may be improved in the future. (if it's already improved, we forgot to remove this line from the documentation ;)

to be continued