WiggleTransitionEffectLib — Plan9Basic Documentation

Overview

WiggleTransitionEffectLib creates a wiggle/jiggle distortion while transitioning between images, wrapping TWiggleTransitionEffect. Produces a shaky, vibrating animation — playful and comedic.

Property	Details
Library	`WiggleTransitionEffectLib`
Prefix	`wiggletrans_`
Wraps	`TWiggleTransitionEffect`
Functions	15
Type	Transition effect

Category	Count	Description
Creation / Destruction	2	Create and free effect
Target Image	3	Set/get/load target bitmap
Progress	2	Get/set transition progress
Random Seed	2	Wiggle pattern variation
Effect Control	2	Enabled get/set
Error Handling	4	Error codes and messages

🤪 Wiggle & Jiggle: The transition shakes and distorts as images crossfade. Change RandomSeed for different wiggle patterns. Great for playful, comedic, or cartoon-style transitions.

Cross-Platform Support

Platform	Support
Windows	✅ Full support
Linux	✅ Full support
Android	✅ Full support

Creation & Destruction

wiggletrans#(parent#)

Creates a new wiggle transition effect attached to the specified visual control.

Parameter	Type	Description
`parent#`	Pointer	Target visual control
Returns	Pointer	Effect handle, or 0 on failure

wiggletrans_free(effect#)

Destroys the effect and releases associated resources.

Error Handling

Function	Signature	Description
`wiggletrans_error()`	`wiggletrans_error@`	Returns last error code (0 = none)
`wiggletrans_errormsg$()`	`wiggletrans_errormsg$@`	Returns last error message
`wiggletrans_strerror$(code)`	`wiggletrans_strerror$@n`	Converts error code to text
`wiggletrans_clearerror()`	`wiggletrans_clearerror@`	Clears the error state

Target Image

Function	Signature	Description
`wiggletrans_target#(effect#, bitmap#)`	`wiggletrans_target#@##`	Sets target from bitmap
`wiggletrans_target#(effect#)`	`wiggletrans_target#@#`	Gets target bitmap
`wiggletrans_loadtarget#(effect#, url$)`	`wiggletrans_loadtarget#@#$`	Loads target from URL or file

Progress

Function	Signature	Description
`wiggletrans_progress#(effect#, value)`	`wiggletrans_progress#@#n`	Set progress (0.0–1.0)
`wiggletrans_progress(effect#)`	`wiggletrans_progress@#`	Get current progress

Random Seed

Function	Signature	Description
`wiggletrans_randomseed#(effect#, value)`	`wiggletrans_randomseed#@#n`	Set random seed for wiggle pattern
`wiggletrans_randomseed(effect#)`	`wiggletrans_randomseed@#`	Get random seed

Different seed values produce different wiggle patterns. Try various seeds to find the most appealing distortion for your content.

Effect Control

Function	Signature	Description
`wiggletrans_enabled#(effect#, value)`	`wiggletrans_enabled#@#n`	Enable (1) or disable (0)
`wiggletrans_enabled(effect#)`	`wiggletrans_enabled@#`	Gets enabled state

Complete Examples

Animated Wiggle Transition

╯ wiggle-anim.bas─◻✕
let frm# = Pointer#(0)
let img# = Pointer#(0)
let trans# = Pointer#(0)
let tmr# = Pointer#(0)
let btn# = Pointer#(0)
let progress = 0

frm# = form#("Animated Wiggle", 400, 350)
img# = image#(frm#)
image_bounds#(img#, 100, 30, 200, 150)
image_load#(img#, "https://picsum.photos/200/150?random=1")

trans# = wiggletrans#(img#)
wiggletrans_loadtarget#(trans#, "https://picsum.photos/200/150?random=2")

tmr# = timer#()
timer_interval#(tmr#, 30)
timer_enabled#(tmr#, 0)
timer_ontimer#(tmr#, "Animate")

btn# = button#(frm#, "Wiggle!")
button_bounds#(btn#, 150, 210, 100, 30)
button_onclick#(btn#, "Start")
form_show(frm#)

function Start(sender#)
  progress = 0
  timer_enabled#(tmr#, 1)
  button_enabled#(btn#, 0)
endfunction

function Animate(sender#)
  progress = progress + 0.02
  wiggletrans_progress#(trans#, progress)
  if progress >= 1 then
    timer_enabled#(tmr#, 0)
    button_enabled#(btn#, 1)
  endif
endfunction

Quick Reference

Function	Signature	Description
CREATION & DESTRUCTION
`wiggletrans#(parent#)`	`wiggletrans#@#`	Create effect
`wiggletrans_free(effect#)`	`wiggletrans_free@#`	Destroy effect
TARGET IMAGE
`wiggletrans_target#(effect#, bitmap#)`	`wiggletrans_target#@##`	Set target
`wiggletrans_target#(effect#)`	`wiggletrans_target#@#`	Get target
`wiggletrans_loadtarget#(effect#, url$)`	`wiggletrans_loadtarget#@#$`	Load target
PROGRESS
`wiggletrans_progress#(effect#, value)`	`wiggletrans_progress#@#n`	Set progress
`wiggletrans_progress(effect#)`	`wiggletrans_progress@#`	Get progress
RANDOM SEED
`wiggletrans_randomseed#(effect#, value)`	`wiggletrans_randomseed#@#n`	Set seed
`wiggletrans_randomseed(effect#)`	`wiggletrans_randomseed@#`	Get seed
EFFECT CONTROL
`wiggletrans_enabled#(effect#, value)`	`wiggletrans_enabled#@#n`	Enable/disable
`wiggletrans_enabled(effect#)`	`wiggletrans_enabled@#`	Get enabled
ERROR HANDLING
`wiggletrans_error()`	`wiggletrans_error@`	Last error code
`wiggletrans_errormsg$()`	`wiggletrans_errormsg$@`	Last error message
`wiggletrans_strerror$(code)`	`wiggletrans_strerror$@n`	Code to text
`wiggletrans_clearerror()`	`wiggletrans_clearerror@`	Clear error

Library	Description
`RippleTransitionEffectLib`	Ripple transition
`WaveTransitionEffectLib`	Wave transition
`CrumpleTransitionEffectLib`	Crumple transition