====== riot and picker ======

|x|DRAFT|

| The menu usage is mentioned to complement\\ the technique used in the forthcoming toobnix video\\ or Tea Note. |

=== From riot or rio: ===

^   New   ^ <= release the button here^
|   Resize   |	|
|   Move   |	|
|   Delete   |	|
|   Hide   |	|

|1|At the rio grey screen, press the right button of your mouse. A menu (above) should appear. Then, release the button over the “New” option.|
|2|Now, press the right button again near the upper-left corner of Drawterm, and drag the mouse to the lower-right before releasing the button, drawing a rectangle.|

^ Location and usage ^
| A location and usage is mentioned. Some\\ of these topics are discussed in the video. |

^Experimental on 9p.sdf.org^^^
|x|/amd64/bin/rio| includes 'riot' ((Previous draft: //includes 'riot' and 'riow'// was removed.)) [%%:!:%%] ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:))|
|x|/bin/riot||

|x|rio|''usage:''|''rio [ -f font ] [ -i initcmd ] [ -k kbdcmd ] [ -s ]''|
|x|riot|''usage:''|''riot [ -b ] [ -f font ] [ -i cmd ] [ -k kbdcmd ] [ -s ]''|

^contrib on 9p.sdf.org^^^
|x|/usr/sdf/bin/riot.new| user contributed |

|x|riot.new|''usage:''|''rio [ -f font ] [ -i initcmd ] [ -k kbdcmd ] [ -s ]''|

===== tutorial notes =====

| Future Tea Note events about this topic may\\ benefit from note taking. This section is intended\\ to assist with that process.|

==== Rio usage: ====

|x| Practice with mouse button 3 menu '**//New//**' |

^   New   ^ <= release the button here^
|   Resize   |	|
|   Move   |	|
|   Delete   |	|
|   Hide   |	|

|x| Practice with ''rio''. |

<code>
  % rio
</code>

|x| Practice with mouse button 3 '**//Delete//**' |

|   New   |	|
|   Resize   |	|
|   Move   |	|
^   Delete   ^ <= release the button here^
|   Hide   |	|

==== Riot and picker usage: ====

|x| Practice with mouse button 3 menu '**//New//**' |

^   New   ^ <= release the button here^
|   Resize   |	|
|   Move   |	|
|   Delete   |	|
|   Hide   |	|

|x| Practice with ''riot''.|

<code>
  % riot
</code>

|x| Practice with ''picker''.|

<code>
  % picker < /dev/theme > /dev/theme
</code>

| Paste the //picker// snarf buffer into an acme or sam editor file.\\ Sam will require an additional mouse button 2 menu\\ '<rio>' snarf buffer toggle. |

|Mouse button 3 select '//snarf all//' from the //picker// window. ||
^   snarf all   ^ <= release the button here^

|x| topng |
Three ''topng'' screen, or window, capture methods are mentioned: [[vps_-_9front#command_reminder|Command reminder]].

|x| $home/lib/profile |

^ Advanced riot usage: ^
| The 'riot' command replaces the 'rio'\\ command in the $home/lib/profile file. |

^SDF Plan9 Boot Camp Fall 2021 TEA NOTE #3^
|https://toobnix.org/w/qVFBCXxWT9qWTn2rR9UCyX|
|00:00:00 - Introduction and News|
|00:03:30 - The Challenges and ‘''com''’|
|00:10:00 - Review on accessing //vps9.sdf.org// and managing your VM|
|00:16:00 - Accessing ///usr/sdf// on 9p from your VM|
|00:18:00 - Challenge 3 and 4|
|00:19:00 - Modifying rio (‘''riot''’) to support themes and backgrounds|
|00:26:00 - using ‘''picker''’|
|00:40:30 - Your personal website on //9p.sdf.org//|

|[[toobnix|Using the SDF Video Gallery]]|<sup>toobnix.org</sup>|

====== toobnix.org notes ======

| These are notes from the video. The 1st method\\ requires the use of the delete key to escape. |

===== riot and picker – toobnix =====

^ $home/lib/profile ^
| # riot -i $home/bin/rc/riostart |

<code>
 % picker < /dev/theme > /dev/theme
</code>

|Mouse button 3 select '//snarf all//' from the //picker// window. ||
^   snarf all   ^ <= release the button here^

==== 1st method: ====

<code>
  % cat >theme1.new
</code>

^ % cat >theme1.new ^
| # paste the '//snarf all//' selected text here:\\ [append with a new line]\\ [press the delete key to escape] |

==== 2nd method: ====

<code>
  % cat /dev/theme >theme2.new
</code>

===== Example: =====

|x| When starting 'riot', redirect a “rio.theme” to 'riot'. |

^ $home/lib/profile ^
| riot -i $home/bin/rc/riostart |

^ $home/bin/rc/riostart ^
| [Replace //glenda// with your username.] |

<file config $home/bin/rc/riostart>

#!/bin/rc
window 'cat /usr/glenda/lib/theme/rio.theme > /mnt/wsys/theme;
	sleep 0.5;
	grep softscreen /dev/vgactl >> /dev/vgactl;
	echo hwblank off >> /dev/vgactl'

</file>

^ $home/lib/theme/rio.theme ^
| An example of the command and file. |

<code>
 % pwd
 $home/lib/theme
 % cat /dev/theme >rio.theme
</code>

<file config riot rio.theme example:>

rioback	777777
back	282828
high	cccccc
border	999999
text	babe94
htext	000000
title	55aaaa
ltitle	9eeeee
hold	000099
lhold	005dbb
palehold	4993dd
paletext	d5d5d5
size	ff0000
menubar	448844
menuback	eaffea
menuhigh	448844
menubord	88cc88
menutext	000000
menuhtext	eaffea

</file>

<file config riot rc/riostart example (change username):>

#!/bin/rc
window 0,0,161,117 stats -lmisce
window -scroll -miny 130
window 'cat /usr/username/lib/theme/rio.theme > /mnt/wsys/theme;
        sleep 0.5;
        grep softscreen /dev/vgactl >> /dev/vgactl;
        echo hwblank off >> /dev/vgactl'

</file>

^Experimental on 9p.sdf.org^^^
|x|/amd64/bin/rio| includes 'riot' ((Previous draft: //includes 'riot' and 'riow'// was removed.)) [%%:!:%%] ((The [%%:!:%%] is  interchangeable with a //[CAUTION]//, for the [[plan9front_-_acme_sam_abaco_mothra_and_man#abaco|abaco]], and [[plan9front_-_acme_sam_abaco_mothra_and_man#mothra|mothra]] browsers. :!:))|
|x|/bin/riot||

^contrib on 9p.sdf.org^^^
|x|/usr/sdf/bin/riot.new| user contributed |

==== riow ====

|x|''riow''|virtual desktops|http://only9fans.com/sigrid/riow/HEAD/info.html|
| | //Fall 2021 [[plan_9_boot_camp_tea_note_presentation|TEA NOTE]] #3// ((The context of the 2021 //includes 'riot' and 'riow'// note needs review.)) ((Review: `kbdtap` was introduced to 'rio', which allowed 'riow' to be implemented as an external program.)) |  //*NOTE*: riow is included in 9front since Sep 2022.//  ||
|x|/bin/riow|||

|x|riow|''usage:''|''riow [ -s label ]''|

|x| Two independent ‘''riow''’ methods.|

== By hand: ==

<code>
cpu% window -scroll riow
</code>

== With riostart: ==

<file config rio and riow rc/riostart example:>

#!/bin/rc
window 0,0,161,117 stats -lmisce
window -scroll -miny 130
window -scroll riow

</file>

===== Background =====

|x|  **Notes for preparing a background image:**  | //[blank]// |
|x|  //''jpg -9''//  |http://man.9front.org/1/jpg|
| |  //**''-9''** Like -c, but produce an uncompressed image. This saves processing time, particularly when the output is being piped to another program such as page(1), since it avoids compression and decompression.//  |"|
|x|  //''jpg -t''//  |http://man.9front.org/1/jpg|
| |  //**''-t''** Convert the image, if it is in color, to a true color RGB image.//  |"|
| |  Note: //**''-c''** Convert the image to a Plan 9 representation, as defined by image(6), and write it to standard output.//  |"|

^ Example: ^
| ''jpg -9t <coolwallpaper1920x1080.jpg >/usr/$user/lib/1920x1080.img'' |

<code>

  cpu% jpg -9t <coolwallpaper1920x1080.jpg >/usr/$user/lib/1920x1080.img
</code>

^ Example 1920x1080 output ^^
| | ''file /usr/$user/lib/1920x1080.img'' |
|x| ''//plan 9 image, depth 24, size 1920x1080//'' |

====== Tea Note – ongoing ======

| Future Tea Note discussion about this topic may\\ benefit from note taking. This section is intended\\ as a reminder. Comment on the SDF [[vps_-_9front#getting_involved|plan9-l]] list. |

^ Possible Tea Note questions sent to SDF plan9-l, or com ^^
| **1.** |Are 'riot' and 'riow' included in the 9p.sdf.org 'rio' ((Review: `kbdtap` was introduced to 'rio', which allowed 'riow' to be implemented as an external program.))?|