The most basic graphic can be obtained by setting the "Region/Game" and "Server Pattern". All other fields are optional.

Region/Game

Joint OperationsDFXDFX2 BetaDFX2Select the game or region. When showing server details on the image the intent is to show details for a single server, hence you must specify which "collection" of servers (the region/game) the data should come from.

Server Pattern

Since we are trying to show the information from a single server you must specify the server name (or partial server name) so that we can identify which server you are intending to show the details for. The server pattern is a regular expression, or in its most simple form the complete server name. Since we match your server using a pattern you do not need to include the full name, but you do need to include enough to make sure that it is the only server matching that pattern. Since we are using regular expressions this becomes a lot simpler. Normally you can replace any non-alphabetic characters with the "." character and this is normally satisfactory. For example, if your server name was "JO Server##!" then the server pattern to match this might simply be "server". However, since there may be another server called "My Server" our pattern "server" would match both names and we would not get an image. We need to use the server pattern "my.server".

These are some general formatting controls.

Font	TinySmallMediumLargeGiantSelect the font size from the list. This sets the default font size for all other fields. Overidding this setting is possible for each individual field.
Font Colour	Enter the name of the font colour. This sets the default font colour for all other fields. Overidding this setting is possible for each individual field. Clicking the "Select Colour" link should show a popup where you can click on the name of the colour from a list. A list of available colours can also be obtained from the "Options" tab. There is a problem at the moment with Internet Explorer where the "Select Colour" link does not work. We are trying to resolve this.Select Colour
Background Colour	Enter the name of the background colour. . Clicking the "Select Colour" link should show a popup where you can click on the name of the colour from a list. A list of available colours can also be obtained from the "Options" tab. There is a problem at the moment with Internet Explorer where the "Select Colour" link does not work. We are trying to resolve this.Select Colour
Frame	DisabledEnabled     Inset pixels Set the frame inside from the edges of the image by this number of pixels.
Frame Colour	Enter the name of the frame colour. Clicking the "Select Colour" link should show a popup where you can click on the name of the colour from a list. A list of available colours can also be obtained from the "Options" tab. There is a problem at the moment with Internet Explorer where the "Select Colour" link does not work. We are trying to resolve this.Select Colour
Image Size:	Width pixels,     Height pixels Specify the size of the image (width and height) in pixels. Some other parameters may "change" this size, specifically a player list can be set to automatically "grow" the image as needed. If a background image is specified then this setting has no effect. If you do not specify a size then one is used from the "Field Display Groups".
Text Offset:	Horizontal pixels,     Vertical pixels Move all the text on the image by this many pixels in a horizontal (moves right) and/or vertical (moves down) direction. Specifying a negative value moves the text in the reverse direction.
Background Image	Specify the complete URL of an image. The URL must be of an image only or you will get an error returned. If the url does not exist we will draw the image with no background template. This may or may not work as the size of the images may differ and your text may no longer be in the correct location. You could specify the size parameter in case the URL failed so that the replacement image was the correct size. We only accept images in the PNG format. An example of a correctly formatted URL is: http://www.edcint.co.nz/jo/lobby/image_templates/img_2.png There are a couple of preconfigured samples available. To access them enter the following instead of a complete URL: 2 jotr jotr2 Note that using remote images is always slower than using predefined images since we have to go and fetch the image every time, build the data on the image and then deliver it to you. If the remote URL is slow from our perspective, then our image delivery to you will be slow from your perspective. Also note that we may cache the remote image so that we do not have to fetch it every time. This may result in changes to your image not being shown as quickly as expected. Special Note on Background Image Palettes: We can only write/change text/field/icon elements using the palette of the background image. For example, if you want to have white writing you need to make sure that white is included in the palette of the image.
Field Display Groups (Sets)	0 - horizontal1 - vertical2 - briefnoneField Groups are collections of predefined fields and icons with colour and position information. They allow you to get the most commonly required information quickly and easily. If you select the "none" group then you may manually have to specify the required information on the "Server Data Fields" and "Server Icon Fields" tabs.

Some sensible defaults are shown which suit the default image for Display Set setting "0 - horizontal".
If you wish to use this feature simply select "Enable" from the "Enable Player List".

Horizontal Location (pixels) Specify the horizontal location of the left hand side of the player list in pixels. The left hand corner of the image is horizonatal location 0 (zero) and the right hand side of the image is the same as the image width.	Vertical Location (pixels) Specify the vertical location of the top of the player list in pixels. The top of the image is vertical location 0 (zero) and the bottom of the image is the same as the image height.	Font Size	Font Colour Enter the name of the font colour for the player list. Clicking the "Select Colour" link should show a popup where you can click on the name of the colour from a list. A list of available colours can also be obtained from the "Options" tab. There is a problem at the moment with Internet Explorer where the "Select Colour" link does not work. We are trying to resolve this.	Enable Player List
		TinySmallMediumLargeGiant	Select Colour	DisabledEnabled

Player Pattern The pattern is a regular expression that players must match to be included in the list. The pattern is case insensitive. For simple searches enter part of the player name(s) you wish to match. For example, if your clan always has ABC in their name then enter ABC as the pattern. Use a . to match any character, so A.C would match ABC, ADC, AEC etc. A plaer pattern simply of . will match every player. If the player pattern is not set we assume you want to show all players. More advanced searches can be performed and are sometimes desirable. For example, if your clan name was ABC and it was always at the start of the player name, the simple search for ABC would show your clan members as well and any one else you just happened to have ABC anywhere in their name. To resolve this problem we could specify that the ABC must only match if it is at the start of the player name. This is achieved by using the pattern ^ABC. Take a look at the following examples: Matching multiple players in one search: eg AW|IWI Match players starting with some text: eg ^AW Match Players ending with some text: eg FMS$ Combinations: eg ^AW|FMS$ That should cover most uses. Experts can read up on Regular Expressions! Number Per Line The number of players to show per line. If not specified, defaults to 1. Line Height The number of pixels high each line is. If not specified, defaults to 10. This will control how close together the players are shown. Max Number of Players The maximum number of players to show. If not specified, defaults to all and is limited to the maximum number of players the server can accomodate. If you do leave this blank and you are also using the "Show Players From All Servers" mode then this could be a large list and hence a large image. We might be able to handle or perhaps we'll just give up .... Growth Pixels This is the number of pixels that we will increase the height of the image by for each line of players shown. If not specified, defaults to 0. You may like to make this the same value as LineHeight to make the image grow in direct proportion to the number of lines of players shown. If you have specified a background image using the style parameter then you will not be able to "grow" the image. Growing the image starts at the specied image size. If you wanted a fixed image size you would not set this parameter and you would make sure the image size you specify is capable of showing the number of players you want to show - test this using the "Num Dummy Players" option. Num Dummy Players The number of dummy players to add to the player list. The default is 0. Use this when testing how your image will look with certain numbers of players. For example, you might like to set it to 32 if your server can support 32 players to see how the image will look. Dummy player names are shown as 16 characters long, which is the maximum you should ever see. We never show more than the number of players that the server can accomodate. Delimiter The character to show between players. The default is to show nothing. Use the word "comma" to use a comma between players, leave it blank to show nothing. Fixed Width The number of characters to fix the length of the player name at. The default is not to fix width the player name. If you are trying to display the player names in columns then you'll probably want to set the value of this to the maximum size of the player name eg 16. By default, the names are right-aligned. You can make them left aligned by prefixing this value with a minus sign eg -16. Player List Sort Options Descending, Case InsensitiveDescending, Case SensitiveAscending, Case InsensitiveAscending, Case SensitiveSpecify sort paramters for the player list. The default is to use the order returned to us by our data source - who knows how they do that ...

Showing Players From All ServersNormally the generated image is all about showing information about a single server. This is mode designed to list players across any number of servers. There are some special considerations in using this mode of operation. When this mode is enabled, the following occurs: The serverpattern is removed, The field group is set to "none", The player list is enabled (if not already), The player pattern is set to "." to match all players. The most number of players we will show is defined by the "Max Number of Players" setting. You must always specify a "Player Pattern", leaving it blank will show no players. You will probably need to adjust the size of the image (most likely the width). You will probably want to change the Horizontal and Vertical Location of the list. Enable Tick this check box to enable this mode of operation. Player Name Formatting If you want to show the server that the player is on you can also do this. In order to do this you need to specify a formatting parameter which allows you to control whether the server name comes first or goes last, the spacing parameters and any other characters eg put the server name in brackets. This can get a little tricky and the best way to do this is to use one of the samples from the drop down box below. Read more detail on this if required in the How-to guide (See the "Options Tab") Player Name Formatting Samples Formatting the player list can be quite complex, use these options as some quick settings. These we probably cover most uses. The last one is special and is probably the one you will want for 2 main reasons - we have designed it for showing players and the servers that they are on and it sets more than jsut the player list formatting. It also: Positions the player list, Resizes the image, Puts titles on the columns (see the "Text Fields" tab), Sets the other player list options to reasonable values, Sets the maximum number of displayed players to 200. Server Player (Fixed, Left Justify)Server Player (Fixed, Right Justify)Player Server (Fixed, Left Justify)Player (Server) (Variable)Player SERVER:(Server) (Variable)Player SERVER:(Server) (Fixed, Left Justify)Server Player (Multiple Options Set)

These settings provide control over which fields are shown where. If you have selected a "Field Display Group" then some of the required fields will already be displayed on the image. This allows you to override the "Field Display Groups" or add additional fields. For a field to be displayed on the image just must specify at least a "Horizontal Location", a "Vertical Location" and a "Field Name".

Field Number	Horizontal Location (pixels) Specify the horizontal location of the left hand side of the field in pixels. The left hand corner of the image is horizonatal location 0 (zero) and the right hand side of the image is the same as the image width.	Vertical Location (pixels) Specify the vertical location of the top of the field in pixels. The top of the image is vertical location 0 (zero) and the bottom of the image is the same as the image height.	Font Size	Font Colour Enter the name of the font colour for the field. Clicking the "Select Colour" link should show a popup where you can click on the name of the colour from a list. A list of available colours can also be obtained from the "Options" tab. There is a problem at the moment with Internet Explorer where the "Select Colour" link does not work. We are trying to resolve this.	Field Name Select the field name to show at this location.
0			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
1			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
2			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
3			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
4			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
5			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
6			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
7			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
8			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
9			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers
10			TinySmallMediumLargeGiant	Select Colour	servernamegamemissionregionplayersmaxplayerstimeleftservermsgagetimeofdaytracers

These settings provide control over which icons are shown where. If you have selected a "Field Display Group" then some of the icons will already be displayed on the image. This allows you to override the "Field Display Groups" or add additional icons. For an icon to be displayed on the image just must specify at least a "Horizontal Location", a "Vertical Location" and an "Icon Name".

Icon Number	Horizontal Location (pixels) Specify the horizontal location of the left hand side of the icon in pixels. The left hand corner of the image is horizonatal location 0 (zero) and the right hand side of the image is the same as the image width.	Vertical Location (pixels) Specify the vertical location of the top of the icon in pixels. The top of the image is vertical location 0 (zero) and the bottom of the image is the same as the image height.	Icon Name Select the icon to show at this location.
0			passwordcountrypunkbustermod
1			passwordcountrypunkbustermod
2			passwordcountrypunkbustermod
3			passwordcountrypunkbustermod

These settings allow you to show arbitray text on the image.
For the text to be displayed on the image just must specify at least a "Horizontal Location", a "Vertical Location" and some "Text".

Text Element Number	Horizontal Location (pixels) Specify the horizontal location of the left hand side of the text in pixels. The left hand corner of the image is horizonatal location 0 (zero) and the right hand side of the image is the same as the image width.	Vertical Location (pixels) Specify the vertical location of the top of the text in pixels. The top of the image is vertical location 0 (zero) and the bottom of the image is the same as the image height.	Font Size	Font Colour Enter the name of the font colour for the text. Clicking the "Select Colour" link should show a popup where you can click on the name of the colour from a list. A list of available colours can also be obtained from the "Options" tab. There is a problem at the moment with Internet Explorer where the "Select Colour" link does not work. We are trying to resolve this.	Text Enter some text ....
0			TinySmallMediumLargeGiant	Select Colour
1			TinySmallMediumLargeGiant	Select Colour
2			TinySmallMediumLargeGiant	Select Colour
3			TinySmallMediumLargeGiant	Select Colour
4			TinySmallMediumLargeGiant	Select Colour
5			TinySmallMediumLargeGiant	Select Colour
6			TinySmallMediumLargeGiant	Select Colour
7			TinySmallMediumLargeGiant	Select Colour
8			TinySmallMediumLargeGiant	Select Colour
9			TinySmallMediumLargeGiant	Select Colour

Clear All OptionsClicking this will reset all options to their default values, remove all saved options and reloads the page.

Automatically show my image as the URL changes If ticked the sample image will automatically change as you change various parameters. If not, you will need to click the "Show my Image Now" link above the sample image.

There are 2 modes of operation for the automatic image reload:
Change the image as I change an option eg Server Pattern,
Change the image only when I have completely changed an option eg Image Size.


View a list of colour names/samples.

Note:
Your option settings are automatically saved for 5 days.
Due to frequent grabbing of information during this image setup process, the server/player data shown on your sample image may not be current. This is only effective during the setup process on this web page. During the setup process the information could be up to 3600 secconds old.

Refer to the full How-to for detailed information about the image setup. There may be some minor amount more of control that you can gain over the image (but not much) by manually building the URL using the How-to as a reference guide.

If required, you can contact us.

Developed by bobthebuilder.