Ariadne's Popup Help

In this document I will explain the following:
The different parts of the Popup Window, variables used in popups, how to create a popup, how to copy popups off the screen, how to add sound to your popups, make a one line popup, make a multi-line popup, how to nest popups and how to look at a popup and figure out what all those black lines, numbers and symbols mean. 
It would probably be a good idea to print this file, login to pirch and open the popups while you are reading this.
 
When you click on the popup button a new window will open. You will see four tabs on the top.
	Server: serverpop.irc Great place to put channel joins, etc. (.Join #Pirch:/join #Pirch )
	Channel Names List: popups.irc All of your greets, byes, etc.
	Channel Main Pane: chanpop.irc Utilities,Pil's, etc.
	Private Msg/DCC Chat: msgpops.irc Put popups for private chats here

On the bottom of the screen:
	Load: Load a new popup file
	Save: Saves the popup you pasted or created, saves a popup file you just loaded in
	Cancel: Cancels whatever operation you are doing (i.e. loading a file, etc.)

  Variables:

All of the variables below must have a space before and after them in order for them to work properly, with the exception of the first one, it does not have a space before it.
 
/me = inserts your nickname in an action and is used at the
	beginning of a line only
example: if I typed  /me loves Pirch  it would look like this Ariadne loves Pirch

$$1= inserts the hilighted nick into the popup
	example: if I had an popup that said /me loves $$1
	and I clicked on someone called Merlin it would look like this
	Ariadne loves Merlin 

$? = when you use this in an popup it will open a text box on your 
	screen for you to type in
	example: if I had a popup that looked like this:
	 /me gives $$1 a nice cold glass of $?	
	When you click on a nick then select this from the popup menu
	a text box will open for you to type in the drink
	It will look like this when it shows on the channel screen:
	Ariadne gives Merlin a nice clod glass of coke.

# : this will insert the name of whatever channel you are in into 
	the alias
	example: $snick I just love it when you are here in #
	It will look like this
	Merlin I just love it when you are here in #Pirch

$time : this will insert the time into an alias 
	example: At the beep the time will be $time

$day : this will insert the day into an alias
	example: It is $day , $time here in Georgia.

$date : this will insert the date into an alias
	example: Today's date is $date

We are going to make a simple popup to tell everyone where you are from, so you don't have to type it in every time someone asks you.

1.  Click the Popup button on the Pirch button bar.
2.  Click the Channel Names List or the Channel Main Pane button.
3.  Left click in the window that opens to place the cursor.
4.  Using the arrow keys, arrow down to find a place to put it (actions would be good, if you have that category)
5.  type in lives:/me lives in your state . Where it is $time , on $day , $date 
6.  Click save.
7.  To use this right click the mouse, if you put it in Channel Names List then right click in the channel names list.
8.  Move the mouse down until the pointer is hilighting the popup called lives, then left click.
9.  Your popup will look like this Ariadne lives in Georgia. Where it is 8:00 p.m. , on Saturday , 2-13-98 

Copying a Popup from a channel screen:

Copying in Pirch is like copying in any Windows program.

1.  Place the mouse pointer in front (one line above is even better) of the object you want to copy (i.e. a picture, a line of text, etc.). 
2.  Click and hold down the left mouse button.
3.  Drag the mouse acrossed and down until all of the object is hilited (one line below is even better).
4.  Release the mouse button. The hilite will disappear, the object is on the clip board waiting to be pasted.
5.  Click the popup button on the Pirch button bar.
6.  Click the tab you want it in (if it's a hi or goodbye you probably want it in channel names list).
7.  Type in a name for the popup and a : (example: hello: .
8.  Right click.
9.  Choose Paste from the drop down menu.
10. Click save. 
11. To play the popup, hilight a nick, right click in the names list left click on the popup.

Editing a Popup:

When you copy a popup from the channel screen you will have to edit it before playing it. It will look something like this in the alias Command Definition area.

 <Ariadne>9,12 Hg Hg Hg Hg{{ Merlin }} Hg Hg Hg Hg


The first thing to do when you are editing is to delete the nickname of the person that you copied it from. In this case you would place the cursor in front of the < and use the delete key until you had deleted my name and the > after it. Do not delete the black line(s) after the persons nickname or you will be changing the popup.

Step two is to give it a name (example: hugs: ) 

Step three is to get rid of the nickname of the person it was played to, in the above case the nick to get rid of is Merlin. 
1.  Use the arrow keys to move over to the beginning of the nick.
2.  Delete the nick.
3.  Type in $$1, make sure you have a space before and after the $$1 just like you would a word that you were typing.
4.  Click Save
5.  To play the popup, hilite a nick, right click over the names list, left click on hugs

You can make a multi line popup (one that covers 2 or more lines).Although it must be stored on one line in your popups file.
To make a multi line popup add the | (shift and the \ key) at the end of each line to force a new line.
Look at the popup below (Knowing what you are seeing) to see an example of this.

Adding Sound to an Popup:

To add sound to the beginning of an popup:
/sound # hello.wav

Change the hello to the name of the sound you wish to play with the popup, change the wav to the sound extension (i.e. mid, rmi, mod).

To add sound at the end of the popup add a space then use the following format, the | (called the pipe) is the shift and the \ key together:
|/sound # hello.wav

Knowing what you are seeing:
Below is a sample popup, after copying it and pasting it to popups it looks like this:


 4,22,2 $$1 4,21,4 : 4,4.0,0.4,4.4,26,6.8,8.2,2 nice to see ya 8,8.6,6.4,24,4:|4,22,4 $$1 4,21,4 : 4,4.0,0.4,4.4,26,6.8,8.1,4 nice to see ya 8,8.6,6.4,24,4:|4,22,2 $$1 4,21,4 : 4,4.0,0.4,4.4,26,6.8,8.2,2 nice to see ya 8,8.6,6.4,24,4:

 Kind of scary huh? You don't know what is what. So, let's go through the stuff we see.
 
  these are control codes the first one is either control s or control f, when the popup is played you will know which one by the font that appears, the second one is control k for color

 4,2 these are the colors we are going to see when it's played 4= red text or symbols 2=dark blue background

  this is the symbol that will be red when it is played

 2,2 $$1 the first control code here is turning off the font control that created the red symbol, this way the persons nick will display right when it's played
              the second control code is a control k for color, you can see with 2,2 it will be dark blue
              the $$1 will insert the hilited nick, but since we have 2,2 in front of it it will appear as a dark blue line, in the second line you can see where the colors are changed to 4,2 so that the nick will be in red

 4,2 this is turning the symbol back on and repeating the first symbol

 1,4 : this is turning the symbol off again and changing the color to balck on red with : being in black

 4,4.0,0.4,4. this is three periods, with the text and background colors the same they will appear as thin lines when the alias is played

 4,2 turning the symbol back on

 6,6.8,8. turning the symbol off and having 2 thin lines, the first line purple the second one yellow

 2,2 nice to see ya   this is changing the color to dark blue, again since the text and background color are the same the "nice to see you" will appear as a blue line.In line two of the alias the color is changed to red.

 8,8.6,6. two more thin lines, purple and yellow

 4,2 turning the symbol font back on and repeating the symbol again

 4,4: turning the font off and changing the color to red the : will appear as a line

If you copy and paste the popup into your file and play it you will see the symbol used was the heart, control s was the font that was being turned off and on to achieve that.

Nesting Popups:

It is necessary to nest your popups because once the file gets big you will not be able to see the bottom popups, they will be off the bottom of the screen and you won't be able to play them.
	Below is a sample of popup nesting.

Greets
.Hi Individual
..Multi-Color:1,148911121348911121348911121348911121313,1 Hello $$1 1,1489111213489111213489111213489111213
..--==>: 12,1--11--==13>9>8>13>4-10-12-13-9-8-4>9 -- HELLO $$1 -- 4<8-9-13-12-10-4-13<8<9<13<11==--12--|12,1--11--==13>9>8>13>4-10-12-13-9-8-4>9 -- HELLO $$1 -- 4<8-9-13-12-10-4-13<8<9<13<11==--12--|12,1--11--==13>9>8>13>4-10-12-13-9-8-4>9 -- HELLO $$1 -- 4<8-9-13-12-10-4-13<8<9<13<11==--12--
.NiceToCU
..Purrfect: 13How purrrr....fectly grand to see you! 12 *{=^;^=} {=^;^=} * {=^;^=}13 * $$1 * 12 {=^;^=} {=^;^=} {=^;^=}*
..!:13,1~16,1!13,1~13,1 $$1 13,1~16,1!13,1~ 14,14.15,15.0,0.13,11.10,10.13,13.13,13 Hello 13,1~16,1!13,1~1,1 nice to see ya 13,1~16,1!13,1~|13,1~16,1!13,1~16,1 $$1 13,1~16,1!13,1~ 14,14.15,15.0,0.13,11.10,10.13,13.0,13 Hello 13,1~16,1!13,1~13,1 nice to see ya 13,1~16,1!13,1~|13,1~16,1!13,1~13,1 $$1 13,1~16,1!13,1~ 14,14.15,15.0,0.13,11.10,10.13,13.13,13 Hello 13,1~16,1!13,1~1,1 nice to see ya 13,1~16,1!13,1~
-
Bye
.BlockBye:1,1-----1,1---1,1 B 1,1---1,1-----1,1---1,1 Y 1,1---1,1----1,1---1,1 E 1,1---1,1-----1,1---1,1 $$1 1,1---1,1-----|1,1-----4,4---4,4 B 4,4---1,1-----12,12---12,12 Y 12,12---1,1----9,9---9,9 E 9,9---1,1-----8,8---8,8 $$1 8,8---1,1-----|1,1-----4,4---1,0 B 4,4---1,1-----12,12---1,0 Y 12,12---1,1----9,9---1,0 E 9,9---1,1-----8,8---1,0 $$1 8,8---1,1-----|1,1-----4,4---4,4 B 4,4---1,1-----12,12---12,12 Y 12,12---1,1----9,9---9,9 E 9,9---1,1-----8,8---8,8 $$1 8,8---1,1-----|1,1-----1,1---1,1 B 1,1---1,1-----1,1---1,1 Y 1,1---1,1----1,1---1,1 E 1,1---1,1-----1,1---1,1 $$1 1,1---1,1-----
.SeeYou:0____4,21389121102 See You Later $$1 0111298134|0____13,2891211048 See You Later $$1 4011129813|0____8,29121104132 See You Later $$1 1340111298

	As you can see each section has a topic (Greets and Bye)
	Since there are no periods in front of them they will appear on the popup menu when you right click.
	Greets has 2 sub-topics: Hi Individual and Nice ToCU
	Notice that they both have a period in front of them.
	Hi Individual is not the name of a popup, it is a place that we are holding our Hi's to Individuals.
	The sub-topics will appear when you place the mouse pointer over Greets on the popup menu 
	The actual popups Multi-Color and --==> will appear when you put the mouse pointer over the Hi Individual category.

If you look at the popup file as a file cabinet it is easier to understand.
The whole popup file is the file cabinet.
The Hi Individual is a drawer in the file cabinet.
The Multi-Color is an actual file.

	You save your popups to categories, Topic, sub-topic, popup.
	This way you can store alot of popups in one file.

Viewing your Popups.Irc Off Line:

Use notepad, wordpad or MSWord to view your irc file. To do this open one of the word processors, click open, click all files on the bottom, then find the irc file and double click it. Or go to Windows Explorer, Pirch32, double click the irc file, when the Open With box appears choose the word processor you want to view it with and click ok. You can also make changes to your popups this way, just remember to save as All Files and type in the file extension .irc if it is not showing in the file name line.


Creating a new Popups.irc file:

Filled up your popups? Just too big to work with anymore? Why not create a new one? Open a word processor (any one will do but Word will allow you to have a larger file than notepad). Type in one letter, or word, go to File, Save As, type in popups1.irc, or any other name as long as you use the .irc extension. Make sure All Files is showing on the bottom line, click Save. You now have a new file to store your popups in.

Loading in another Popups.irc:

1.  Open the popups window.
2.  Click on the tab you want to load them into. (Channel Names List,Server, whatever)
2.  Click Load.
3.  In the Look In window that opens find the .irc file you want to load.
4.  Double click the file.
5.  After you see it load into your popups window click save.   

