# ezQuake Manual: Crosshairs

This feature and manual page has been inherited from the FuhQuake client made by A Nourai aka 'fuh' (#fuhquake on Quakenet irc).

You can customise the look of your crosshair in this client.

## Builtin Crosshairs

You can use a builtin crosshair using "crosshair x" where x is bewteeen 2 and 6. "crosshair 1" will use the + symbol from your charset.

## Custom Crosshair Symbol

"crosshair 1" uses the plus symbol from your charset. Like all characters in your charset, the plus symbol is an 8x8 image in your charset. If you change this image, "crosshair 1" will change.

This client gives you the option of changing what "crosshair 1" looks like without editing your charset. To do this create a file called "crosshair.txt" in c:\quake\ezquake\crosshairs\crosshair.txt (change c:\quake to your quake dir).

The format of "crosshair.txt" is

    XOOOOOXO
    OXXOXXOO
    OXOOOXOO
    OOOXOOOO
    OXOOOXOO
    OXXOXXOO
    XOOOOOXO
    OOOOOOOO

where

X (or x)
  draw a pixel and
O (or o)
  dont draw a pixel.

This works for both software and GL client version.

## Crosshair Colour

You change the colour of your crosshair with "crosshaircolor x" where x is 0..255.

## Crosshair Size

You can change the size of your crosshair with "crosshairsize x".

In Software client version, valid crosshairsizes are "crosshairsize x" where x is 1, 2, or 3 (1 is normal size, 2 is double size and 3 is triple size).

In GL client version you can use "crosshairsize x" where x is any number between 0.2 and 8. Even decimals work. Note however that some values will distort the crosshair in GL. This is because of conwidth and width (conheight and height) being different. Change crosshairsize slowly (by 0.05 at a time say) to find a 'sweet spot'. You get best performance when width (height) is an integral multiple of conwidth (conheight).

Crosshair size is independent of conwidth and conheight. Also if you wish to sue large crosshairs (using crosshairsize 10 etc) then its best to make a high resolution crosshair PNG image rather than using the 8x8 inbuilt crosshairs.

## Crosshair Alpha (GL Only)

In GL client version "crosshairalpha x" where x is 0..1 will determine the level of transparency of your crosshair.

## Crosshair Images (GL Only)

In GL client version you can use a PNG/TGA/PCX image as your crosshair. The image should be placed in c:\quake\ezquake\crosshairs\ (except change c:\quake as needed).

To load the crosshair use "crosshairimage image_name" where 'image_name' is the name of the crosshair image you put in the above directory.

Example, if I have c:\quake\ezquake\crosshairs\cross.png I'd use "crosshairimage cross" to load it.

To unload the crosshair use crosshairimage "" in the console, or make an alias "alias unload_crosshair crosshairimage $qt$qt" ($qt is the macro for ").

The variables crosshairsize, crosshairalpha and crosshaircolor all work for crosshair images too (although sometimes you might not want color to work).

## Making Crosshair Images

This section explains how to make PNG/TGA crosshairs.

Firstly pick a size. The image should be square and preferabely have width and height being a power of 2. 64x64 is a good example.

The problem with powers of 2 is that there is no middle pixel. For example if you have a 64x64 image with top left pixel coordinates (1,1) and bottom right coordinates (64,64), then the middle is at (32.5, 32.5) which isn't a real coordinate. (32,32) and (33,33) are the two real coordinates closest to the middle. The client centres the 64x64 crosshair so that the (32,32) pixel is centred on screen. In otherwords (32,32) is treated as the centre.

In general if you have a crosshair image of width = height = 2^n with top left coordinate (1,1) and top right coordinate (2^n, 2^n) then the centre of the crosshair should be positioned over pixel (2^(n-1), 2^(n-1)).

## Variables

crosshairsize, crosshaircolor, crosshair

## GL Variables

crosshairalpha, crosshairimage

Last update: 31.12.1969 16:00 PST, made by JohnNy_cz