http://bughunters.addix.net/igbtest/IGB-commands.html
EVE Ingame Webbrowser
preliminary documentation V0.9
10. March 2005
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=”value” attribute2=”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:
*
EVE_TRUSTED
YES: if website is trusted by the pilot. All following variables are only submitted if EVE_TRUSTED is YES
NO: the website is not trusted by the pilot. The web server can send a trust request in this case.
*
EVE_CHARNAME
Character name of the pilot.
*
EVE_CHARID
Character ID of the pilot.
*
EVE_ALLIANCENAME
Name of the alliance the pilot’s corporation is in.
*
EVE_REGIONNAME
EVE universe region the pilot is in
*
EVE_CONSTELLATIONNAME
EVE universe constellation the pilot is in
*
EVE_SOLARSYSTEMNAME
EVE universe solar system the pilot is in
*
EVE_STATIONAME
The station name the player is docked or None
*
EVE_CORPNAME
Corporation the pilot is in.
*
EVE_CORPROLE
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:
*
Try to avoid tables. Currently, table rendering is quite slow
*
Do not nest tables.
<table><tr><td><table>…</table></td></tr></table>
This takes even longer to load
*
always add height and width attributes to your images. This way the browser can already layout the page before the images are loaded.
This is especially true for dynamic images because these can not be cached.
