Infocard XML coding

**Not a clue how it works. I do know that each of the ID_Info’s define a different section of what you see, some are for what you see in the ship dealer and one of them is for the what other players see when they scan your ship.

You might want to go through the following information in the link below for the MSXML format

http://msdn.microsoft.com/en-us/library/ms256177(VS.85).aspx**

I would have thought there’d be more info on XML/RDL, but a search for “underline” (since “tra” and “rdl” are too small) only seemed to yield this topic. Since I’ve just gone through it again for my patch, here’s a complete description of the TRA tag.

<tra <br=“”>data=“0xBGRA|<number>”
mask=“0xBGRA|<number>”
def=“0xBGRA|<number>”
color=“default|gray|blue|green|aqua|red|fuchsia|yellow|white|#RGB|<number>|0x<hexnumber>”
font=“default|<number>”
bold=“default|true|false”
italic=“default|true|false”
underline=“default|true|false”
/>

RGB is, of course, the red/green/blue component of the color, as a two-digit hex number. A is the attribute, storing the font and bold/italic/underline settings: 1 = bold, 2 = italic, 4 = underline, remaining bits are the font number (see DATA\FONTS\rich_fonts.ini; the number used by FONT is one more than this). DATA contains the new value; MASK contains the bits that should be set from DATA; DEF contains the bits that should be made default. So if we take your “bold/red” example:

data=“65281” (0x0000FF01) -> red + bold
mask=“-31” (0xFFFFFFE1) -> all color bits and the bold bit are relevant, don’t change anything else
def=“30” (0x0000001E) -> use default font/italic/underline

For my patch, I’ve replaced all these with the smaller strings: <tra color=“#FF0000” bold=“true”>… <tra color=“default” bold=“false”>The RGBs for the color names:

gray = #808080
blue = #4848E0
green = #3BBF1D
aqua = #87C3E0
red = #BF1D1D
fuchsia = #8800C2
yellow = #F5EA52
white = #FFFFFF

If you choose to use a number for the color, one is subtracted from it, for some reason.

BTW, the complete text of all the resource files (687k; .rc files; before I made use of COLOR and FONT) can be found on my site.</tra></tra></number></hexnumber></number></number></number></number></tra>

Very nice description, and makes almost complete sense to me.

I do have two questions regarding the color specification:

When you say <number>, is that the numeric equivalent of the hex value used in #RGB, or is it the number that would be the color component of the data=“0xBGRA” field? (I’m assuming the second, but want to verify)

Similarly, when it is ‘0x<hexnumber>’, I’m assuming that’s the same thing that would be in the data field, except ignoring the last (attribute) pair?

Also,

If you choose to use a number for the color, one is subtracted from it, for some reason.

You mean from each color individually, or from the whole number?

I ask this instead of trying it myself because I’m working on an XML to HTML converter that verifies the syntax and shows what it would look like ingame in the browser, and those two are the only remaining unknowns in the script.</hexnumber></number>

When you say <number>, is that the numeric equivalent of the hex value used in #RGB, or is it the number that would be the color component of the data=“0xBGRA” field? (I’m assuming the second, but want to verify)

Similarly, when it is ‘0x<hexnumber>’, I’m assuming that’s the same thing that would be in the data field, except ignoring the last (attribute) pair?</hexnumber></number>

In both cases, <number>is just a straight decimal number, equivalent to the 0x number, so it does include the attribute. e.g. #010203 == 0x03020100 == 50462976. (I think, anyway.)

If you choose to use a number for the color, one is subtracted from it, for some reason.

You mean from each color individually, or from the whole number?

The number as a whole. e.g. 50462976 -> 50462975 == 0x030200FF. (Again, I think. It’s just as easy for you to experiment, as for me.)</number>

After a week or two of work on a web-based infocard development ‘application’ for the Discovery dev team, I have a part of that code that I want to release to the dev community at large, and I hope that it is useful to someone.

A php class that facilitates working with XML infocards:
http://cshake.homeip.net/disco/class.FreelancerXML.phps

Features:

• Input and output XML card strings, user-specified encoding

• Input and output bbcode-style format

• Validates input XML infocards, giving details on any errors

• Outputs valid XHTML that shows exactly what the infocards will look like in-game (when given the blue background)

• Input and output HTML for use in, and generated by, browser-based rich-text editors (compatibility issues with adding new paragraphs or linebreaks in IE8, no support for text justification in IE or Opera, everything else works fine in those, everything works in Firefox 3.6)

• Fully usable in both 32- and 64-bit environments

The BBCode translator works for all possible XML tags, and will produce functionally identical infocard markup when converted back and forth an unlimited number of times.
The supported ‘bbcode’ tags are:```
[b] [i] [u] [align] [font] [color]

The XML writer will use the ‘pretty’ human-readable color=“red”, bold=“true” style TRA tags by default, but will also output the ‘raw’ data/mask/def style tags if desired. In the case of reading in a ‘pretty’ style infocard, the output will be identical (even if converted to bbcode and back). When reading in a ‘raw’ style infocard, the output will be identical if not converted to bbcode, but if it is converted the mask and default values may be slightly different, but will function identically in-game. This comes from me always masking all the color bits when a color is specified, and always masking 0xF8 when a font is specified, while 0x38 (font numbers 0-7) is usually used in the vanilla cards.

The code is (I believe) fully commented and readable. Except for the use of variable-type arrays it should be easy enough to port to C/C++ if the FLDev people want to improve their ‘bbcode’ editor.

Thank you very much to adoxa for the <tra> explanation here!

[edit]6/10/10 - did some fixes, changed the link to the latest version instead of a specific one.[/edit][/color][/font][/align][/u][/i][/b]</tra>

No worries. I did miss one thing, though: TRA is Text Render Attributes, not transform (and RDL is Render Display List).

Here’s a question, how can you change info cards? Can someone explain how to change them from A to Z?

Use Freelancer Developer or FLEd-ids, both are self-explaining I think…

Or Freelancer Resource Compiler.

Tried FRC, I can’t get my head around it and yes I have ran it from command line since you used that programming method.

Having a go at FLEd.

Thanks for the info guys

I was so pleased with FRC, yet no one seems to use it. I thought it was so simple, but perhaps not.

E:\contrib\games\Freelancer\frc>type test.frc
S 1 name
H 2 infocard

E:\contrib\games\Freelancer\frc>frc test

E:\contrib\games\Freelancer\frc>..\res2rc test.dll

E:\contrib\games\Freelancer\frc>type test.rc
STRINGTABLE
{
1,      "name"
}

2 23
{
L"<rdl><push>\
<text>infocard</text><para>\</para></push></rdl> "
}

```What's so hard about that?

I love your FRC adoxa its a lot easier to edit/add text then using old FLEdids.

adoxa, could you submit your various tools to our download section? I think they fit there better than in forum posts as attachments.

aren’t they all stored on adoxa’s homepage?

@Sethernis: Thank you.

@wodk4: Yeah, I should, just too lazy. Plus I only do minimal testing, so I’d like a bit of feedback before committing. Plugins I won’t, though, just too many of 'em. Hm, could probably zip 'em all together as a collection.

@Gisteron: Yes, all my tools are on my site. Only a few plugins are, but I’ll eventually get around to putting them all on.

adoxa, FRC looks neat, I’m sure it will be useful for devs.

For people who don’t deal with the dlls themselves, lets say people who are just the content generation part of a dev team and all just submit resources to the final person who puts them into a dll, I’ve got some things that might make life a bit easier. Because even though many of us can look at raw code and visualize what it will look like, it’s sometimes nice to not have to deal with the low level stuff, and a real preview is always nice.

Here is a set of 3 related functions, all using the XML translator class I posted above, that are an extremely simple copy/paste/click interface for editing cards on the fly and generating valid xml for them. These are by no means intended to be used for major batch jobs, that’s a whole different kettle of fish, but for quick validation I’ve already found them useful myself.

#1 - XML Preview - given raw XML, will validate the syntax and display it in HTML how it will look ingame
#2 - BBCode Editor - using bbcode, will generate XML from the bbcode and show the in-game preview
#3 - Rich-Text Editor - edit rich-text cards, generate XML, and preview. I’ve tested it to work for copy/pasting formatting from a MS Word 2007 document in the current version of Firefox with Windows XP and 7, and it handles paragraphs, color, and sometimes alignment too. Other combinations of OS/Browser/Text Editor may or may not work for importing directly, but it will correctly handle any formatting you give it on the page itself. (IE8/FF/Opera/Safari, Chrome doesn’t have the API last I tested)

I’m not trying to step over your feet here adoxa, but when working with infocard people in the Disco team, they seemed to like these for the ease of use. If someone finds bugs that aren’t already listed, feel free to send me a PM here.

adoxa wrote:

[…]
data=“65281” (0x0000FF01) -> red + bold

Does anyone know how to make cyan + bold?

Or, even better, an overview of how to make colors + attributes? I had a vague memory of a fairly complete description of all the various options and/or an editor rendering text strings that could be pasted into FLED-Ids, but all I could find is this thread. And, maybe the info might is here - if so, I’m just not smart enough to deduce it.

http://www.asciizeichen.de/RGB.html for the first 6 numbers after 0x, guess the last are used for bold, normal and italic but dont know the code