-
-
Notifications
You must be signed in to change notification settings - Fork 3
/
readme.txt
133 lines (85 loc) · 4.48 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
================================================================================
PascalSDK
Translation of SCS SDK into Pascal
================================================================================
Description
------------------------------
The SCS SDK, as provided by the SCS Software company, is a collection of APIs
designed to allow data exchange and communication between a running game and
a dynamic library loaded by this game. This dynamic library can use these APIs
to provide additional functionality to the game, provide extensive logging, and
more. The APIs are defined in a set of several C header files (eg. "scssdk.h"),
which are declaring number of constants, types and also a flat procedural
interface. Currently (february 2023), this mechanism is supported by Euro Truck
Simulator 2 and American Truck Simulator.
PascalSDK project provides a pascal translation of the entire SDK for use in
Delphi (version 7 or newer) and Free Pascal Compiler (FPC version 2.6.4 or
newer) - possibly running under Lazarus IDE.
Current version of PascalSDK (1.0) is based on SCS SDK version 1.14.
Important disclaimer
------------------------------
The entire development of this project was done "in the blind" - that is, with
absolutely no access to internet or other information channels and with no
access to instalations of relevant games (ETS2, ATS).
This means, among others, that the translated headers were not actively tested
beyond the fact that they can be compiled.
Also, due to mentioned lack of access to proper active testing (ie. running the
code on the actual game), it was decided to drop translation of examples that
are part of the original SDK. They may be added later, if situation allows it.
Technical details
------------------------------
The translation is provided in two main forms. First is a one-to-one
translation of the original headers, where each "*.h" file is translated into
a corresponding "*.pas" file. These files are located in folder called
"headers" within the project root.
As there are no true header files in pascal, it is not common to do agressive
separation into individual files (like in the first form), but rather to place
everything into one unit, if feasible, and use only this one in uses clause.
The second form is this combination of all translated headers into one pascal
unit, and is stored in file "headers_condensed/PascalSDK.pas".
Whatever form you decide to use is only up to you, but using the condensed unit
is recommended.
Program used to automatically condense the translated headers with a few other
supporting files is stored in folder "condenser" - note that this folder is not
present in "master" branch of the project, but is maintained in a branch called
"condenser".
Full source code of the mentioned program can be found in the following
repository:
https://github.com/TheLazyTomcat/PascalSDK_Headers_Condenser
Project files
------------------------------
List of folders with description of their content:
./
Root folder. Contains license and readme files.
./condenser
Condeser program and supporting files (only in branch "condenser").
./examples
Translated examples showing how to use the provided APIs (not implemented).
./headers
One-to-one translation of all header files.
./headers_condensed
All headers combined into one pascal unit.
./headers_original
Original sources of the SCS SDK (zip archives).
Repositories
----------------------------------------
You can get actual copy of this project on the following git repository:
https://github.com/TheLazyTomcat/PascalSDK
Licensing
----------------------------------------
Everything, with exceptions noted further, is licensed under Mozilla Public
License Version 2.0. You can find full text of this license in file license.txt
or on web page https://www.mozilla.org/MPL/2.0/.
Files (zip archives) within folder "headers_original" contain original SDK as
provided by the SCS Software, and are therefore not covered by the MPL 2.0
license that is otherwise applicable to files within this project.
See content of these archives for information about applicable license(s).
Authors, contacts, links
----------------------------------------
František Milt, frantisek.milt@gmail.com
If you find this project useful, please consider making a small donation using
the following link:
https://www.paypal.me/FMilt
Copyright
----------------------------------------
©2023 František Milt, all rights reserved