EVE Ingame Webbrowser

preliminary documentation V0.8

26. November 2004




Table of Contents

Supported Tags and Attributes

Tags

Document

Text Elements

Images

Forms

Tables

Styles

Fonts

Alignment

Outer Border

Inner Border

Border

Backgrounds

Position

Styles and Classes

Special Ingame Functions

Getting Pilot Information

Using Client Services

EVEMail

Show Info

EVE Map

Character Portrait

Logos

Icons

FAQ

1. Why does the IGB not show all pages?

2. How can i view the HTML source of a page?

3. My pages take forever to load






Supported Tags and Attributes

Note: attributes and parameters marked with x are not implemented yet.

Tags

General tag syntax:

<tag>

<tag attribute1=”valueattribute2=”value... attributeN=”value”>

Document

Tag

Attribute

Description

<html> ... </html>



<body> ... </body>

bgcolor=”color

background=”image

text=”color

link=”color

alink=”color

vlink=”color


<header> ... </header>



<title> ... </title>



<link> ... </link>

rel=”stylesheet”

type=”text/css”

href=”link

Includes an external document



Text Elements

Tag

Attribute

Description

<h1> ... </h1>

<h2> ... </h2>

<h3> ... </h3>

<h4> ... </h4>

<h5> ... </h5>

<h6> ... </h6>

align=”left|right|center”

Places a headline

<p> ... </p>

align=”left|right|center”

Marks a Paragraph. <p> can be also used without </p>

<br>


Inserts a newline.

<ul>

<li> ... </li>

<li> ... </li>

</ul>

type=”circle|disc|square” x

Unordered list

<ol>

<li> ... </li>

<li> ... </li>

</ol>

type=”a|A|i|I” x

type=”start value” x

Ordered list

<blockquote> ... </blockquote>



<address> ... <address>



<pre> ... </pre>



<em> ... </em>



<strong> ... </strong>



<code> ... </code>



<samp> ... </samp>



<kbd> ... </kbd>



<var> ... </var>



<cite> ... </cite>



<dfn> ... </dfn>



<b> ... </b>



<i> ... </i>



<tt> ... </tt>



<u> ... </u>



<strike> ... </strike>

<s> ... </s>



<center> ... </center>



<span> ... </span>



<hr>

size=”height

Generates a horizontal line.

<font> ... </font>

size=”size

color=”color

Sizes between 1 and 7 are mapped to real font sizes by the browser. Default size is 3. Modifiers like +1 and -2 are supported. Sizes bigger then 7 match to real font sizes.
The <FONT> tag is deprecated in HTML4 use styles instead.



Images

Tag

Attribute

Description

<img>

src=”path to image

align=”left|right|center”

hspace=”space in pixel

vspace=”space in pixel

width=”width of image in pixel

height=”height of image in pixel

border=”border width in pixel

alt=”text displayed on mouseover

usemap=”#mapname

Places an image


Dynamic images are recognized. Use Pragma: no-cache in the image header to make sure the image is not cached.

<map> ... </map>

name=”mapname


<area>

shape=”rect

coords=”x0,y0,x1,y1

href=”link




Supported image types: jpg, gif, png, tga, bmp, dds

Forms

Tag

Attribute

Description

<form> ... </form>

action=”URL to page

method=”get|post”

Form frame

<input>

type=”text|password|hidden|checkbox|radio|submit|reset

name=”element name

value=”preset value

checked

size=”width of the element

Places an input box

<select> ... </select>

name=”element name

size=”number of rows

Places an select box

<option> ... </option>

value=”value of element

selected

Adds options to a select box

<textarea> ... </textarea>

name=”element name

cols=”columns

rows=”rows

Places an multi line input



Tables



Tag

Attribute

Description

<table> ... </table>

width=”width of table in pixel

border=”width in pixel

cellspacing=”spacing in pixel

cellpadding=”padding in pixel

bgcolor=”border color

background=”background image x

Playes a table

<colgroup> ... </colgroup>


Block for predefining column widths

<col>

width=”width in pixel

span=”number of columns

Predefines column widths. This tag is placed inside a <colgroup>

<tr> ... </tr>

rowspan=”number of rows

bgcolor=”border color

Places a line inside a table

<td> ... </td>

colspan=”number of columns

bgcolor=”border color

Places a cell inside a row

<th> ... </th>

colspan=”number of columns

bgcolor=”border color

Places a cell inside a row. Text is displayed bold and centered

Styles

General style syntax:


attr1:param1;attr2:param2; ... ;attrN:paramN;



Fixed size parameter syntax:

value value in pixel
valuepx value in pixel
valuein value in inch
valuept value in punkt (1/72 inch)
valuepc value in pica (1/6 inch)
valuecm value in cm
valuemm value in mm

all values will be converted to pixel using standard factor of 100dpi.



Color parameter syntax:

colorname any color name: (red, green, blue, yellow, ... )
#rgb red, green, and blue color portion in hex
#rgba red, green, and blue color portion and alpha factor in hex
#rrggbb red, green, and blue color portion in hex
#rrggbbaa red, green, and blue color portion and alpha factor in hex
rgb(R,G,B) x red, green, and blue (0-255)
rgb(R,G,B,A) x red, green, blue, and alpha (0-255)
rgb(r%,g%,b%) x red, green, and blue in percent
rgb(r%,g%,b%,a%) x red, green, blue, and alpha in percent



Fonts

Attribute

Parameter

Description

font-style

normal

italic

oblique

Sets the font style for text.

italic and oblique refer to the same style.

font-size

8, 10, 12, 14, 20

xx-small

x-small

small

medium

large

x-large

smaller

larger

Sets the size of a font. Due to fonts limitations the font family may change.


If the specified font size is not available the nearest smaller font size is chosen.

font-weight

normal

bold

Sets the font weight.

font

A space separated list of

font-style, font-size and font-weight parameters

Sets Font

word-spacing

any fixed size

Sets the spacing between words

letter-spacing

any fixed size

Sets the spacing between letters

text-decoration

none

underline

overline

line-through

Applies decoration to a text.

color

any color parameter

Sets the font color

Alignment

Attribute

Parameter

Description

text-indent

any fixed size

Set text indent for the first line of a paragraph

line-height

any fixed size

Sets the minimum height of a text line. The line height is adjusted if a font needs more space.

vertical-align

top

middle

bottom

sub

super

Sets the vertical alignment for text and objects

text-align

left

right

center

Sets the alignment of text in paragraphs and headers

Outer Border

Attribute

Parameter

Description

margin-top

any fixed size

Set top margin of a paragraph, table or div

margin-bottom

any fixed size

Set bottom margin of a paragraph, table or div

margin-left

any fixed size

Set left margin of a paragraph, table or div

margin-right

any fixed size

Set right margin of a paragraph, table or div

margin

1 to 4 space separated fixed size parameter

Sets multiple margins

1 parameter: all 4 margins

2 parameters: top/bottom, left/right

3 parameters: top, left/right, bottom

4 parameters: top, right, bottom, left

Inner Border

Attribute

Parameter

Description

padding-top

any fixed size

Set top padding of a paragraph, table or div

padding-bottom

any fixed size

Set bottom padding of a paragraph, table or div

padding-left

any fixed size

Set left padding of a paragraph, table or div

padding-right

any fixed size

Set right padding of a paragraph, table or div

padding

any fixed size parameter

Sets all inner borders


Border



Attribute

Parameter

Description

border-top-width

any fixed size

Set top border width of a paragraph, table or div

border-bottom-width

any fixed size

Set bottom border width of a paragraph, table or div

border-left-width

any fixed size

Set left border width of a paragraph, table or div

border-right-width

any fixed size

Set right border width of a paragraph, table or div

border-width

any fixed size parameter

thin

medium

thick

Sets all border widths


border-top-color

any color parameter

Set top border color of a paragraph, table or div

border-bottom-color

any color parameter

Set bottom border color of a paragraph, table or div

border-left-color

any color parameter

Set left border color of a paragraph, table or div

border-right-color

any color parameter

Set right border color of a paragraph, table or div

border-color

any color parameter

Sets all border colors


border-top-style

none

hidden

solid

groove

ridge

inset

outset

Set top border style of a paragraph, table or div

none and hidden removes the border

solid draws the border with the given color

groove, rigde, inset, outset draw a 3d effect (same for all).

border-bottom-style

see above

Set bottom border style of a paragraph, table or div

border-left-style

see above

Set left border style of a paragraph, table or div

border-right-style

see above

Set right border style of a paragraph, table or div

border-style

see above

Sets all border styles


border-top

space separated list of border-width, border-style, and color parameters

Set top border parameters of a paragraph, table or div

border-bottom

space separated list of border-width, border-style, and color parameters

Set bottom border parameters of a paragraph, table or div

border-left

space separated list of border-width, border-style, and color parameters

Set left border parameters of a paragraph, table or div

border-right

space separated list of border-width, border-style, and color parameters

Set right border parameters of a paragraph, table or div

border

space separated list of border-width, border-style, and color parameters

Sets parameters for all borders


Backgrounds



Attribute

Parameter

Description

background-color

any color parameter

Sets background color for a page, table, paragraph, or div

background-image

url(path to image)

Sets background image

background-repeat

repeat

repeat-x

repeat-y

no-repeat

Adjusts repeating of background images

background-position

Space separated list of 2 fixed size parameter (left, top) or 4 fixed parameters (left, top, width, height)

top

center

middle

bottom

left

right

Sets the left top corner of the background image

background

any color parameter

url (path to image)

repeat

repeat-x

repeat-y

no-repeat

any fixed size parameter or

top

center

middle

bottom

left

right

Sets background attributes

Position

Attribute

Parameter

Description

position

absolute

fixed

relative

static

Defines how a div is positioned

absolute: all distances are measured from the border of the parent object

fixed: same as above but does not scroll

relative: relative to current position

static: normal flow (default)

top

any fixed size parameter


bottom

any fixed size parameter


left

any fixed size parameter


right

any fixed size parameter


width

any fixed size parameter


min-width

any fixed size parameter


max-width

any fixed size parameter


height

any fixed size parameter


min-height

any fixed size parameter


max-height

any fixed size parameter




Styles and Classes

The IGB supports a subset of CSS1 and CSS2. Style sheets can either be written inline (<STYLE> ... </STYLE> or loaded from an external resource ( <LINK REL="stylesheet" TYPE="text/css" HREF="cssfile.css"> )

General CSS Class definition:

tag { attribute1:value1; ... attributeN:valueN; }

defines the attributes for the given tag.

E.g.:

<HTML><HEAD><STYLE>
H1 {color:blue;}

</STYLE></HEAD><BODY>
<H1>H1 Headers are blue</H1>
</BODY></HTML>



Selectors:

tag
.classname
#idname
[attrname]
[attrname=”value”]
[attrname|=”value”]
[attrname~=”value”]
:
psydoclass



E.g.:

.cl (class selector)
h1.head
(tag selector with a class selector)
#place
(id selector)
p#place
(tag and id selector)
[align=”center”]
(attribute selector)
img[align=”left”]
(tag selector with attribute selector)
a:hover (link pseudo class)




depsel sel { attribute1:value1; ... attributeN:valueN; }

uses the given attributes if sel appears inside of depsel. The attributes are also applied if tag is surrounded by other tags.

E.g.:

<HTML><HEAD><STYLE>
H3 B {font:underline;}
</STYLE></HEAD><BODY>
<H3><b>bold underline</b> <i><b>bold underline too</b></i></H3>
</BODY></HTML>



deptag > tag { attribute1:value1; ... attributeN:valueN; }

uses the given attributes if tag appears inside of deptag and no other tag is surrounding tag

E.g.:

<HTML><HEAD><STYLE>
H3 > B {font:underline;}
</STYLE></HEAD><BODY>
<H3><b>bold underline</b> <i><b>bold not underline</b></i></H3>
</BODY></HTML>



deptag * tag { attribute1:value1; ... attributeN:valueN; }

uses the given attributes if tag appears inside of deptag and at least one other tag is surrounding tag

E.g.:

<HTML><HEAD><STYLE>
H3 * B {font:underline;}
</STYLE></HEAD><BODY>
<H3><b>bold not underline</b> <i><b>bold underline</b></i></H3>
</BODY></HTML>



deptag + tag { attribute1:value1; ... attributeN:valueN; }

uses the given attributes if tag appears directly after deptag

E.g.:

<HTML><HEAD><STYLE>
H3 + P {font:blue;}
</STYLE></HEAD><BODY>
<H3>Header</H3>
<P>The text in this paragraph will appear blue.</P>
</BODY></HTML>



Special Ingame Functions

The EVE ingame web browser has some special features that allow using of ingame services on web pages. You can get player information using the trusted site service or trigger game related functions like sending an ingame mail using game services.

Getting Pilot Information

Using dynamic web pages, the IGB allows to query Pilot information such as pilot name, corporation, and solar system the pilot is in. For security reasons this only works if the pilot has allowed the access.

All pilot information are transferred in the header section of the http request.
Currently the following variables are transferred:

Value

Binary

Role

1

20

Director

128

27

Personnel Manager

256

28

Accountant

512

29

Security Manager

1024

210

Factory Manager

2048

211

Station Manager

4096

212

Auditor

8192

213

Can take from division 1 hangar

16384

214

Can take from division 2 hangar

32768

215

Can take from division 3 hangar

65536

216

Can take from division 4 hangar

131072

217

Can take from division 5 hangar

262144

218

Can take from division 6 hangar

524288

219

Can take from division 7 hangar

1048576

220

Can query division 1 hangar

2097152

221

Can query division 2 hangar

4194304

222

Can query division 3 hangar

8388608

223

Can query division 4 hangar

16777216

224

Can query division 5 hangar

33554432

225

Can query division 6 hangar

67108864

226

Can query division 7 hangar

134217728

227

Can take from division 1 accounts

268435456

228

Can take from division 2 accounts

536870912

229

Can take from division 3 accounts

1073741824

230

Can take from division 4 accounts

2147483648

231

Can take from division 5 accounts

4294967296

232

Can take from division 6 accounts

8589934592

233

Can take from division 7 accounts

17179869184

234

Can query division 1 accounts

34359738368

235

Can query division 2 accounts

68719476736

236

Can query division 3 accounts

137438953472

237

Can query division 4 accounts

274877906944

238

Can query division 5 accounts

549755813888

239

Can query division 6 accounts

1099511627776

240

Can query division 7 accounts

2199023255552

241

Equipment config/Deploy space



A website needs to ask for a trusted site access in the http header.

Trusted sites example script in PHP:

<?
ini_alter("session.use_cookies","1");
ob_start();
?>
<HTML>
<HEAD>
<TITLE>Testpage</TITLE>
</HEAD>
<BODY>
<?
if (!(strpos($HTTP_USER_AGENT,"EVE-minibrowser")===false))
{
if ($HTTP_SERVER_VARS["HTTP_EVE_TRUSTED"]=="no")
{
header("
eve.trustme:http://www.mywebsite.net/::please allow me to access your pilot information.");
}
else
{
?>
<b>Pilot:</b>
<? echo
$HTTP_SERVER_VARS[“HTTP_EVE_CHARNAME”]; ?>
<b>Location:</b>
<? echo
$HTTP_SERVER_VARS[“HTTP_EVE_REGIONNAME”]; ?>/<?
echo $
HTTP_SERVER_VARS[“HTTP_EVE_CONSTELLATIONNAME”]; ?>/<?
echo
$HTTP_SERVER_VARS[“HTTP_EVE_SOLARSYSTEMNAME”]; ?><BR>
<?
if (
$HTTP_SERVER_VARS[“HTTP_EVE_STATIONNAME”] != "None")
{
?>
<b>Station:</b> <? echo
$HTTP_SERVER_VARS[“HTTP_EVE_STATIONNAME”]; ?><br>
<?
}
}
}
?>
</BODY>
</HTML>
<?
ob_end_flush();
?>



Auto-Reloading websites

An page reload can be triggered with the HTTP header refresh. You can reload a page based on a timer or on each session-change (jumping, docking).

Timer based refresh:

refresh:time;URL=linktowebpage

Session change based refresh:

refresh:sessionchange;URL=linktowebpage



Site refresh example script:

<?
header("refresh:
sessionchange;URL=mypage.php");
// header("refresh:10;URL=mypage.php");
?>
<HTML>
<HEAD><TITLE>Test</TITLE></HEAD>
<BODY>
...
</BODY>



Using Client Services

Some ingame functions are accessible through the ingame webbrowser. To allow this access some new tags have been introduced.

EVEMail

Opens a “New Message” window. The receiver field will contain the charname. In the extended version, you can also supply the subject and the message text.

<A HREF=”evemail:charname”> ... </A>
<A HREF=”evemailto:charname,... SUBJECT=”subject” message=”text”> ... </A>

Show Info

Opens the “Show Info” window for the given item type. If you also add the itemID, you will get more detailed information of the item.

Note: You should not add the itemID when it is not really needed. If the item is repackaged or destroyed, you will receive an error message. It is always safe to use the typeID.

<A HREF=”showinfo:typeID”> ... </A>
<A HREF=”showinfo:
typeID//itemID”> ... </A>

Examples:

<A HREF=”showinfo:1//3012978”>Agent: Tasara Athasho</A>
<A HREF=”showinfo:2//1000129”>Corp: Outer Ring Excavations</A>
<A HREF=”showinfo:5//30003277”>PF-346 solar system</A>
<A HREF="showinfo:657">Iteron Mark V</A>



EVE Map

Shows the route from your current position to the given solar system in the map.

<A HREF=”showrouteto:solarsystemID”> ... </A>

Shows the given solar systems in the map.

<A HREF=”showinmap:solarsystemID1//solarsystemID2//...//solarsystemIDn”> ... </A>

Draws a map into an image.

<IMG SRC=”starmap:ids=list of map objects&marks=list of markers” size=”size”>

list of map objects is a comma separated list of constellationIDs.

List of markers is a comma separated list of entries. Each entry has this format:

solarsystemID::text to display::-::-

Examples:

<IMG SRC=”starmap:ids=20000509&markers=30003489::You are here::-::-”>

Character Portrait

Generates an image of a character.

<IMG SRC=”portrait:characterID” SIZE=”size”>

Logos

Generates the logo of a corporation.

<IMG SRC=”corplogo:corporationID SIZE=”size>

Generates the logo of a faction.

<IMG SRC=”factionlogo:factionID SIZE=”size>

Icons

Generates the icon of a given typeID

<IMG SRC=”typeicon:typeID” width=”64”>





FAQ

1. Why does the IGB not show all pages?

The IGB was made to support the EVE gameplay. It is not designed to display all normal HTML pages. Currently many pages can not be displayed because they use very bad HTML syntax.

Make sure all tags are closed correctly and there is no unmatched <, > or “.

2. How can i view the HTML source of a page?

Right click on the page and chose show source. This even works if the browser displays an error for this page.

3. My pages take forever to load

Here are some speedup tips: