# Connection profiles

##

# Using Connection Profiles

You can use profiles to store settings for an individual VNC server or for a class of servers. For example, you might want to use full-color display for a server that is on your local area network, but drop down to 8-bit display for a remote machine.

You can also use profiles to specify your default encoding. VNC operates by transferring an image of the screen from the server to the client. This obviously requires lots of bandwidth. The better the encoding that you use to transfer this information, the less "lag" you'll experience while using the Chicken. Unfortunately, encodings that require less bandwidth also require more CPU utilization on both the server and client computers, so you may need to experiment to find the encoding that's right for your situation.

The different encodings are (in rough order of efficiency)

- ZRLE
- Tight
- Zlib
- ZlibHex
- Hextile
- CoRRE
- RRE
- Raw

- Profiles: A list of profiles that are available to use for your connections. Add a new profile by typing its name below the list and pressing New. Remove a profile other than the default one by selecting it and pressing the Delete button. The information in the remainder of the window belongs to the selected profile.
- Encodings: The encoding to use for the connection. Encodings are described above. You can drag encodings to change your preferred encoding - the top one is tried first, and subsequent ones are tried until one is found that is supported by your server. To disable an encoding, uncheck it. CopyRect Encoding is an optimization that's useful in some situations. If you're connecting to a very old server, you may wish to turn it off, but we haven't run across any situations where it isn't supported.

- Emulation: If you are one of those cursed with a single button mouse, you have many mouse button emulation options.

You can emulate a button click by holding down a modifier key while clicking your single button mouse using the Modifier Click emulation option. For example, you can use this to imitate the familiar control-click paradigm used on your Macintosh.

The Multi-Tap option lets you emulate a button click by tapping a particular modifier key quickly. For example, you can right-click at the current mouse position by tapping the Command key twice quickly.

The Tap and Click option lets you emulate a button click by tapping a modifier key a single time and then clicking the mouse. This is the behavior that was in previous versions of Chicken of the VNC, so you may already be accustomed to it. Once you've tapped the modifier key, the mouse cursor will change to indicate that a mouse click will be emulated. You can cancel emulation by waiting for it to timeout, or by pressing the Escape key on your keyboard.

If you don't wish to use mouse button emulation, you can set the No Emulation option.

If you are lucky enough to have a two or three button mouse, you don't need to worry about emulation as Chicken supports up to three mouse buttons, as well as scroll-wheels on compatible servers.

- Modifiers: You can use this section to map the modifier keys on your Macintosh keyboard to keys commonly used on other operating systems. This allows you to use the Alt key on a Windows server or the Meta key on a Unix server, for example. If you set the Option key to "none (local keymap)", then Option won't be sent to the server, but can be used to enter special characters using normal Mac keyboard combinations, such as Option-A for å on a US keyboard. For example, if connecting to an X11 server, to have your keyboard wokr similarly to Apple's X11.app, set Command to "Meta" and Option to "none (local keymap)".

- Color: You can use this section to select the color resolution you wish to use with your remote servers. Since VNC is a bandwidth-intensive protocol, you may obtain better responsiveness by reducing your color resolution. Let Server Decide uses the native color resolution of the server.

The Tint remote display setting will cause the remote displays to be tinted a given color. Tinting creates a visual distinction between the remote and local windows.