/ 
Graphics-Framebuffer-6.75
River stage zero No dependents
/ Primitives

NAME

Primitives Demonstration and Testing

DESCRIPTION

This script demonstrates the capabilities of the Graphics::Framebuffer module

SYNOPSIS

perl primitives.pl [options]

    Examples:

    perl primitives.pl

perl primitives.pl --dev=1 --x=640 --y=480

perl primitives.pl --x=1280 --y=720 --pixel=2

perl primitives.pl --small

OPTIONS

--help

Print brief help instructions

--man

Print the full manual page

--nosplash

Turn off the splash screen

--dev=device number

By default, it uses "/dev/fb0", but you can tell it to use any framebuffer device number. Only the number 0 - 31 is needed here.

--x=width

This tells the script to tell the Graphics::Framebuffer module to simulate a device of a specific width. It will center it on the screen.

"--x=800" would set the width to 800 pixels.
--y=height

This tells the script to tell the Graphics::Framebuffer module to simulate a device of a specific height. It will center it on the screen.

"--y=480" would set the height to 480 pixels.
--small

This is a shortcut (and diagnostic tool) to set "x" and "y" to 320x200 respectively. Use this if you are getting bus errors. See the "TROUBLESHOOTING" file for using this setting to determine if GFB is incorrectly detecting screen parameters.

--pixel=pixel size

This tells the module to draw with larger pixels (larger means slower)

--noaccel

Turns off C acceleration. Uses only the Perl routines.

--delay=seconds

Changes the amount of time given to each function

--func="function name"

Instead of running all functions, just run one or more (separated by commas)

ignore-x-windows

DANGEROUS TO USE!

This will turn off all checks for Wayland and X-Windows. It will try to initialize a framebuffer anyway.

NOTES

Place any other animated GIFs in the "examples/images/" directory and it will include it in the testing

AUTHOR

Richard Kelsch <rich@rk-internet.com>

COPYRIGHT

Copyright 2003-2025 Richard Kelsch All Rights Reserved

LICENSE

Perl Artistic License

This program must always be included as part of the Graphics::Framebuffer package.