From: Antonio Ospite Date: Thu, 28 Sep 2017 12:02:34 +0000 (+0200) Subject: contrib: add a HOWTO for new users X-Git-Tag: v0.1.7~29 X-Git-Url: https://git.ao2.it/libam7xxx.git/commitdiff_plain/f4c97d762218d109201a7c8c3f712be2f489b280 contrib: add a HOWTO for new users Thanks to Étienne Morin, https://e-morin.com --- diff --git a/contrib/howto-picopix.asciidoc b/contrib/howto-picopix.asciidoc new file mode 100644 index 0000000..5ef8ef2 --- /dev/null +++ b/contrib/howto-picopix.asciidoc @@ -0,0 +1,114 @@ +HOW-TO use a PicoPix on GNU/Linux +================================= + +Philips/SagemCom pico projectors, like for instance the PicoPix 2055, usually +have a WVGA (854 x 480 pixels) native resolution, however they can be used to +project other resolutions if the software rescales the image. + +First, update your system and download the free libam7xxx library and the +related programs. + +On Debian and Ubuntu systems this can be done with the following commands: + + sudo apt-get update + sudo apt-get install libam7xxx0.1-bin + +Plug your PicoPix into one or two USB slots of your personal computer +(sometimes the second USB port is needed to ensure that the PicoPix has enough +power). + +Wait for Philips logo to appear. + +After the logo has disappeared, execute the following command in a terminal: + + am7xxx-play -f x11grab -i :0.0 + +The video projection is on. + +You can have two simple scripts to execute the program from the GUI. + +PicoPix-START.sh: + + #!/bin/sh + am7xxx-play -f x11grab -i :0.0 -p 1 -z 0 + + +PicoPix-STOP.sh: + + #!/bin/sh + killall am7xxx-play + am7xxx-play -f x11grab -i :0.0 -p 0 -z 1 & + sleep 1 + killall am7xxx-play + + +Save the shell scripts from above in files, and give the execute permissions +to the owner (or user group) via the command line or via the graphical +interface +(http://sourcedigit.com/20111-how-to-run-a-shell-file-in-ubuntu-run-sh-file-in-ubuntu/). +You will then be able to execute the file by double-clicking on it. + +If you want to specify a particular resolution you can pass it as a command +line option: + + am7xxx-play -f x11grab -i :0.0 -o video_size=1280x768 + +When doing so you may notice that your PicoPix does not fully displays the +content of your desktop screen, which can be truncated at the bottom and at +the right. This is because of the WXGA (1280 x 768 pixels) resolution may be +different from your personal computer screen resolution. It is therefore +necessary to modify —temporarily— your personal computer screen resolution to +wanted resolution. Take the following script : + + #!/bin/sh + + WIDTH=1280 + HEIGHT=768 + + OUTPUT="LVDS-1" # See 'xrandr --listmonitors' + + xrandr --newmode $(gtf ${WIDTH} ${HEIGHT} 60 | sed -ne 's/"//g;s/ Modeline //p') + xrandr --addmode ${OUTPUT} ${WIDTH}x${HEIGHT}_60.00 + xrandr --output ${OUTPUT} --mode ${WIDTH}x${HEIGHT}_60.00 + sleep 1 + am7xxx-play -f x11grab -i :0.0 -p 1 -z 0 -o video_size=${WIDTH}x${HEIGHT} + +Note: + +In the example above, the personal computer screen is identified as "LVDS-1". +Maybe your computer screen has a different identifier. In this case, you will +have to replace "LVDS-1" with the correct identifier : open your terminal, +type "xrandr" and the terminal will list and describe your different screen +devices (more about xrandr utility here: +http://pkg-xorg.alioth.debian.org/howto/use-xrandr.html). + +Also, in order to give back your computer screen its original resolution, you +should create a PicoPix-STOP.sh script like so: + + #!/bin/sh + + ORIGINAL_WIDTH=1600 + ORIGINAL_HEIGHT=900 + + OUTPUT="LVDS-1" # See 'xrandr --listmonitors' + + killall am7xxx-play + am7xxx-play -f x11grab -i :0.0 -p 0 -z 1 & + sleep 1 + killall am7xxx-play + xrandr --output ${OUTPUT} --mode ${ORIGINAL_WIDTH}x${ORIGINAL_HEIGHT} + +Note: + +In the example above, the original screen resolution is 1600x900 pixels. You +have to change this value and put your screen resolution value which you can +know via xrandr. Same for LVDS-1. + +Once your video projection is over, you can execute the PicoPix-STOP.sh script +so that your computer screen returns to its original state. + +You can then unplug the projector. + +That's all folks! + +This text is licensed under WTFPL. See http://www.wtfpl.net/ for more informations.