Documentation?

[Gamer09]

I was wondering if there is a documentation with all the functions and their parameters available. I have the DLL but I don't know what functions to call because I don't know any functions. :?

[Phantom]

Look in the Object Browswer for either Sharp Devloper or Visual Studio.

Doubt there will be documentation in the near future

[hcker2000]

I dont think so as well seeing as suport for the sdk is slow to nill. The sdk seems to be more for the creators benifit than any one else's.

[TheOutkastDev]

it only *seems* like that since the ultima.dll is for programmers who wish to use a program that affects/is affected by a running UO client. People writing programs such as razor, an Automap ect.. would find the SDK very helpful.

SDK is for programmers not just average joes. If you know how to program then u should know how to use the SDK.

[Gamer09]

I tried to get Sharp Develop but I get a 404 error everytime I go to the page. If it isn't too big I would appreciate it if you could send it to me through AIM or MSN. I have programming experience in C++ and VB so I think I should be able to use it once I know the commands and their parameters.

Never mind . I just tried the #develop site again and it worked. Thanks.

[hcker2000]

banana?

[Phantom]

Hacker clearly your not a programer...

If you were you wouldn't have said what you said about the SDK.

Its very helpful if you know how to program applications.

[hcker2000]

I'v been programing for a good long time now (going on 5 years) but I will admit that I am new to c#. But from link to the demo map code I can't straten it out manly because things are named in none discriptive names. An example would be a line that says Map map;
Now i'm asuming that Map is a call from the sdk and that map is a var but keep in mind more things are named like this so it dosnt make figureing out what i'm doing wrong in my program any easyer.

The main thing im trying to do with my software right now is get the clients location. Load up the image with the sdk and display it in a picture box. The issues im haveing are.

1. Geting the location from the client.
2. Displaying it fast enought to be almost real time. (I i could get it to update once ever 3 seconds that would be fine)

With the information I got from the example code I know it can be done because the code example its self dose it.

[Arya]

Actually what you really need to use the SDK, besides some programming knowledge of course, is some insight into how the UO client works. Once you have an idea of what you want to do, it should be pretty easy.

You need to find the world location of the client, the best guess is the Client class. You don't really need documentation for that... also if you look in the SDK you see a class called Map with a static method called GetImage. That's all pretty easy to figure out.

Use the object browser to look at the classes. They are all named after what they represent. Hue is a hue, Client is the client, and so on...

Also if you need to display the map, try my map viewer (which is on my site, WWW button below).

[Bradley]

Originally Posted by hcker2000

An example would be a line that says Map map;

This is standard c# and has nothing to do with the SDK. That line mearly declares a variabled named "map", of the type "Map".

if you are more familiar with visual basic it is the equivilant of "Dim map as Map".

If you want some examples of how to use the SDK do a search for my gump editor, I have the full source code posted on the forums.

[hcker2000]

Dose your gump editor use any of the map part of the sdk?

[Phantom]

The map feature is very limited.

Your not going to make some amazing tool with it.

[Bradley]

Originally Posted by hcker2000

Dose your gump editor use any of the map part of the sdk?

No, it only uses gump graphics, Hues, and Item graphics.

[hcker2000]

ahh ok.

[AgentSmith]

If you dont have a nice .NET IDE to develop with, then discovering what the Ultima SDK has to offer is alot harder.

However there are a heap of decompilers that make the task rather simple.

The one I use that works like a charm is :

http://www.aisto.com/roeder/dotnet/

It even hyperlinks between functions, classes and variables and where there defined.

Cheers
Agent Smith

[Phantom]

Decompling the SDK would not be a good idea.

There are free IDE's out there, that won't get you banned.

[AgentSmith]

Not having a go or anything. But why would looking at the structure of a free library in a decompiler be banable ?

I mean its not like you would gain anything other than seeing whats on offer to be used. If you wanted to rewrite it you are just plain stupid as its free.

If Kerrios didnt want people seeing whats in it then there are simple ways to scramble it so that it cant be easily decompiled.

I didnt mean to upset any one posting about alternatives to seeing what the SDK has to offer. Sometimes knowing a function signature and the implied naming arent enough.

Eitherway I will respect the authors wishes.

Cheers
Agent Smith

[Phantom]

Because people will look at other things.

The SDK is under the same license as RunUO, Razor, and Others.

Till he gives us the source to the DLL assume its not polite to look at it.

[Bradley]

Originally Posted by Phantom

Because people will look at other things.

The SDK is under the same license as RunUO, Razor, and Others.

Till he gives us the source to the DLL assume its not polite to look at it.

I just reread the license that One must agree to before downloading RunUO or the SDK. I see NO MENTION of decompiling in this license. I've said it before, and I'll say it one more time. If you don't want people decompiling your stuff and you want a legal leg to stand you will need to put a clause like that into your license.

And on a separate note. It is never again any law to decompile an application, it's only bad if you distribute that decompiled source to others.

.NET is interesting in this regard too, in that much of a the "Interesting" stuff you can get to without even decompiling, it's all stored in MetaData, as plain text information embedded in the file.

Plus .NET application are never really compiled in the traditional until you execute the program. So is it really "decompiling" to reduce a .NET application's EXE into it's IL Code?

[psz]

They are copyrighted (Razor, RunUO, the SDK, KUOC, etc). Without the authorisation of the copyright holder, you do not have the right to decompile the code. Period.

None of the abovementioned tools are handled by the GPL. None of them are opensource.

Besides, you are WRONG anyway:

10. In addition to local, federal, and international laws
prohibiting reverse engineering, the Licensee herby agrees to at no
time make any attempts to decompile RunUO or associated libraries
or alter them in any way other without express written consent
from the author.

That is on the download page when you click the SDK link. The SDK is an "associated library"

http://www.runuo.com/downloads/get_file.php?file=9

So please, don't try to find a way around it. Just don't decompile the stuff on this site.

[Bradley]

Originally Posted by psz

They are copyrighted (Razor, RunUO, the SDK, KUOC, etc). Without the authorisation of the copyright holder, you do not have the right to decompile the code. Period.

None of the abovementioned tools are handled by the GPL. None of them are opensource.

Besides, you are WRONG anyway:

That is on the download page when you click the SDK link. The SDK is an "associated library"

http://www.runuo.com/downloads/get_file.php?file=9

So please, don't try to find a way around it. Just don't decompile the stuff on this site.

Yup, I missed that claus in the license, I was wrong about that part.

But let me make another point about decompiling an application...

Some people out there are really smart, they can write applications directly in machine language, no need for a compiler... They can look at object code (already compiled code) and understand exactly what it does. The point of decompiling code is to see source, and exactly what is going on... So if a really smart person opens RunUO or the SDK in a hex editor, or even notepad for that matter, is that wrong and against the license? In effect they have "decompiled" the code in thier head, are they in violation of the lecense?

Visula studio comes with a tool called the object browser. The object browser opens a .Net EXE and examines the meta-data inside it using reflection to show properties, methods, and constants contained in it. You can even use th eobject browser to directly examine the IL code. IS it against the license to use the object browser?

The visual studio uses auto sence as you type to fill out function names and such... it uses the same reflection methods to get this information. IS it against the licese to use visual studio?

What if i write a program that uses the same reflection to dump the IL Code (compiled code) from the EXE out to a text file for a my own reference? did i break the license? Now what if i can read IL code? I've effectly decompiled the code in my head.

Now I don't want to make this a huge argument, but there is still nothing illegal about running an application on your computer that takes an input file (a compiled EXE), does some math on it (decompiles), and spits out the results to a new file. As long as you don't distibute what you produced to anyone but yourself.

[Phantom]

Object Browser doesn't show you the source

It shows you the method, but not the code within the metho's declaration.

If you decompile it beyond that then your A) You suck B) Your breaking your agreement C) You won't understand it so why bother.

There is no reason to decompile the SDK anyhow, if you think you need to then you don't know enough about programming to even use the SDK.

[AgentSmith]

Phanton said : "If you decompile it beyond that then your A) You suck B) Your breaking your agreement C) You won't understand it so why bother."

Yep, that rates as one of the most intelligent things you have said.

Your next statement which I wont bother cutting and pasting just goes to show you really are a big fish in a small pond.

A good programmer always comments there code, I realise its a concept your are properly finding hard to grasp considering your responses to people that have asked about documentation on the SDK. Also you must be one of those coders that cant code out side of a good IDE. You would be left wanting if given note pad and told to compile the solution.

[Phantom]

You don't know me.

All I know is nobody I know that actually knows how to program, needed to have documentation for the SDK.

I stand my statment if you need the source to the SDK to use it. Then you really don't know and should not be using it.

[Bradley]

Originally Posted by Phantom

Object Browser doesn't show you the source

It shows you the method, but not the code within the metho's declaration.

If you decompile it beyond that then your A) You suck B) Your breaking your agreement C) You won't understand it so why bother.

There is no reason to decompile the SDK anyhow, if you think you need to then you don't know enough about programming to even use the SDK.

Theobject browser uses Reflection to show the methods and properties... My point was that applications decompile a .NET exe using reflection, which is the same method that the object browser uses to display information about an object...

get a visual studio.net command prompt from the tools menu under visual studio, and run the command "ildasm". then oepn RunUO using this application you just ran. ildasm will show the full IL object code of any object, it is a part of Visual Studio .net (not a very well known one though).