Native Libraries

This page documents the native functions that are used by the Abstraction Layers of the Tinman 3D SDK.

Platforms

The following identifiers are used to refer to native platforms.

Windows / LowLevel.IsWindows: Running on a system with Windows 7 or newer.
POSIX / LowLevel.IsPosix: Running on a POSIX.1-2008 compliant system.

The LowLevel.PlatformForce method can be used to override automatic platform detection.

Static Linkage

The native functions listed in this section are required by the Tinman 3D SDK. If not available, errors will occur:

C#: DllNotFoundException or EntryPointNotFoundException will be thrown when the native function is used for the first time. If neither Windows nor POSIX is available at runtime, only .NET Standard 2.0 is used.
C++: Executables will fail to start and dynamic link libraries will fail to load. Either the Windows or the POSIX platform must be available, otherwise compilation will fail.

The separate AddOn library components wrap 3rd-party libraries (for example Direct3D or SQLite). Their respective native function / library dependencies are not documented here.

CodeX.System

This section shows the native functions that are used by the SDK component CodeX.System via static linkage.

Table 1. Native function dependencies of CodeX.System
Native Dependency	Platform	SDK	Used By
EnterCriticalSection	Windows	C++	`CodeX::SimpleMutex`
EnumWindows	Windows	C++	`CodeX::GetMainWindowHandle`
GdiplusShutdown	Windows	C++	`CodeX::GDIP_End`
GdiplusStartup	Windows	C++	`CodeX::GDIP_Begin`
GetCurrentProcessId	Windows	C++	`CodeX::GetMainWindowHandle`
GetModuleHandle	Windows	C++	`CodeX::GetNativeModuleHandleFor`
GetWindow	Windows	C++	`CodeX::GetMainWindowHandle`
GetWindowThreadProcessId	Windows	C++	`CodeX::GetMainWindowHandle`
InitializeCriticalSectionEx	Windows	C++	`CodeX::SimpleMutex`
IsWindowVisible	Windows	C++	`CodeX::GetMainWindowHandle`
LeaveCriticalSection	Windows	C++	`CodeX::SimpleMutex`
OutputDebugString	Windows	C++	`Codex::MemoryPlumber`
SetErrorMode	Windows	C++	`Codex::SimpleMutex`
WSACleanup	Windows	C++	`CodeX::WSA_End`
WSAGetLastError	Windows	C++	`CodeX::WSA_Begin`
WSAStartup	Windows	C++	`CodeX::WSA_Begin`
_CrtSetDbgFlag	Windows	C++	`CodeX::MemoryPlumber`

Tinman.Licence

This section shows the native functions that are used by the SDK component Tinman.Licence via static linkage.

Table 2. Native function dependencies of Tinman.Licence
Native Dependency	Platform	SDK	Used By
GetFileVersionInfo	Windows	C++	Metadata
GetFileVersionInfoSize	Windows	C++	Metadata
GetModuleFileName	Windows	C++	Metadata
GetSystemTime	Windows	C++	LicenceUtil.SystemTime
GetUserName	Windows	C++	Metadata
GetUserNameEx	Windows	C++	Metadata
SystemTimeToFileTime	Windows	C++	LicenceUtil.SystemTime
VerQueryValue	Windows	C++	Metadata

Tinman.Core

This section shows the native functions that are used by the SDK component Tinman.Core via static linkage.

Table 3. Native function dependencies of Tinman.Core
Native Dependency	Platform	SDK	Used By
AllocConsole	Windows	C# C++	Terminal.Window
CloseHandle	Windows	C# C++	LocalFileSystem → IFile → IDisposable.Dispose Thread → IDisposable.Dispose
CreateDirectory	Windows	C++	LocalFileSystem → IFileSystem.DirectoryCreate
CreateFile	Windows	C# C++	LocalFileSystem → IFileSystem.FileNew
CreateThread	Windows	C++	Thread.Start
DeleteCriticalSection	Windows	C++	Monitor → IDisposable.Dispose
DeleteFile	Windows	C++	LocalFileSystem → IFileSystem.FileDelete
EnterCriticalSection	Windows	C++	Monitor → IBeginEnd.Begin
FindClose	Windows	C++	LocalFileSystem → IFileSystem.ListDirectories, IFileSystem.ListFiles
FindFirstFile	Windows	C++	LocalFileSystem → IFileSystem.ListDirectories, IFileSystem.ListFiles
FindNextFile	Windows	C++	LocalFileSystem → IFileSystem.ListDirectories, IFileSystem.ListFiles
FindResource	Windows	C++	TinmanModule.RegisterResource
FlushFileBuffers	Windows	C# C++	LocalFileSystem → IFile → IFlushable.Flush
FreeAddrInfo	Windows	C++	SocketEndPoint → IEndPoint.OpenConnection
FreeLibrary	Windows	C# C++	NativeLibrary → IDisposable.Dispose
GetAddrInfo	Windows	C++	SocketEndPoint → IEndPoint.OpenConnection
GetConsoleOutputCP	Windows	C++	Terminal.Write, Terminal.WriteLine
GetConsoleScreenBufferInfo	Windows	C++	Terminal.Columns
GetConsoleWindow	Windows	C++	Terminal
GetCurrentDirectory	Windows	C++	LocalFileSystem → IFileSystem.Directory
GetCurrentProcess	Windows	C# C++	LowLevel.CpuTotal, LowLevel.CpuUsed
GetDiskFreeSpaceEx	Windows	C# C++	LocalFileSystem → IFileSystem.DirectoryFreeSpace
GetDriveType	Windows	C++	LocalFileSystem → IFileSystem.Roots
GetEnvironmentVariable	Windows	C++	LowLevel.GetVariable NativeLibrary.AddSearchPath
GetFileAttributes	Windows	C++	LocalFileSystem → IFileSystem.DirectoryExists, IFileSystem.FileExists
GetFileAttributesEx	Windows	C++	LocalFileSystem → IFile.GetTimestamp
GetFileSizeEx	Windows	C++	LocalFileSystem → IFile.GetLength
GetLastError	Windows	C++	LocalFileSystem → IFile.Read LocalFileSystem → IFileSystem.Directory LocalFileSystem → IFileSystem.DirectoryCreate LocalFileSystem → IFileSystem.ListDirectories, IFileSystem.ListFiles LocalFileSystem → IFileSystem.Roots NativeLibrary.Initialize Path.Temp SimpleHttp TinmanException.FetchLastError
GetLogicalDrives	Windows	C++	LocalFileSystem → IFileSystem.Roots
GetModuleHandle	Windows	C++	Terminal.Window TinmanModule.RegisterResource
GetProcAddress	Windows	C# C++	NativeLibrary.LookupFunctionPointer
GetProcessMemoryInfo	Windows	C++	LowLevel.MemoryUsed
GetProcessTimes	Windows	C# C++	LowLevel.CpuUsed
GetStdHandle	Windows	C++	Terminal.Columns
GetSystemInfo	Windows	C++	LowLevel.ProcessorCount
GetSystemTime	Windows	C++	LowLevel.SystemTimeString
GetSystemTimes	Windows	C# C++	LowLevel.CpuTotal
GetTempPath	Windows	C++	Path.Temp
GetTickCount	Windows	C++	LowLevel.CpuTotal, LowLevel.CpuUsed LowLevel.MemoryTotal, LowLevel.MemoryUsed LowLevel.TickCount, TickCountPrecise.TickCount
GlobalFree	Windows	C++	SimpleHttp
GlobalMemoryStatusEx	Windows	C# C++	LowLevel.MemoryTotal
InitializeConditionVariable	Windows	C++	Monitor.Monitor
InitializeCriticalSectionEx	Windows	C++	Monitor.Monitor
LeaveCriticalSection	Windows	C++	Monitor → IBeginEnd.End
LoadIcon	Windows	C++	Terminal.Window
LoadLibrary	Windows	C# C++	NativeLibrary.Initialize
LockResource	Windows	C++	TinmanModule.RegisterResource
MoveFile	Windows	C++	LocalFileSystem → IFileSystem.Rename
QueryPerformanceCounter	Windows	C# C++	LowLevel.TickCount, LowLevel.TickCountPrecise
QueryPerformanceFrequency	Windows	C# C++	LowLevel.TickCount, LowLevel.TickCountPrecise
RaiseException	Windows	C++	Thread.Name → Thread.Start (`DEBUG` only)
ReadFile	Windows	C# C++	LocalFileSystem → IFile.Read
RegCloseKey	Windows	C++	LowLevel.GetVariable
RegOpenKeyEx	Windows	C++	LowLevel.GetVariable
RegQueryValueEx	Windows	C++	LowLevel.GetVariable
RemoveDirectory	Windows	C++	LocalFileSystem → IFileSystem.DirectoryDelete
ResumeThread	Windows	C++	Thread.Start
SHGetFolderPath	Windows	C++	Path.Home TinmanModule.Settings
SendMessage	Windows	C++	Terminal.Window
SetConsoleCtrlHandler	Windows	C++	Terminal
SetConsoleTitle	Windows	C++	Terminal.Window
SetCurrentDirectory	Windows	C++	LocalFileSystem → IFileSystem.Directory
SetEndOfFile	Windows	C# C++	LocalFileSystem → IFile.SetLength
SetEnvironmentVariable	Windows	C++	NativeLibrary.AddSearchPath
SetFilePointerEx	Windows	C# C++	LocalFileSystem → IFile.SetLength
SetFileTime	Windows	C++	LocalFileSystem → IFile.SetTimestamp
SetThreadPriority	Windows	C++	Thread.Priority
SizeofResource	Windows	C++	TinmanModule.RegisterResource
SleepConditionVariableCS	Windows	C++	Monitor → IBeginEndSync.WaitForNotify
SleepEx	Windows	C++	Thread.Sleep
SystemTimeToFileTime	Windows	C++	LocalFileSystem → IFile.GetTimestamp, IFile.SetTimestamp
WSAGetLastError	Windows	C++	SocketEndPoint → IConnection, IServer
WakeAllConditionVariable	Windows	C++	Monitor → IBeginEndSync.NotifyWaiting
WideCharToMultiByte	Windows	C++	Terminal.Write, Terminal.WriteLine
WinHttpAddRequestHeaders	Windows	C++	SimpleHttp
WinHttpCloseHandle	Windows	C++	SimpleHttp
WinHttpConnect	Windows	C++	SimpleHttp
WinHttpCrackUrl	Windows	C++	SimpleHttp
WinHttpGetIEProxyConfigForCurrentUser	Windows	C++	SimpleHttp
WinHttpOpen	Windows	C++	SimpleHttp
WinHttpOpenRequest	Windows	C++	SimpleHttp
WinHttpQueryHeaders	Windows	C++	SimpleHttp
WinHttpReadData	Windows	C++	SimpleHttp
WinHttpReceiveResponse	Windows	C++	SimpleHttp
WinHttpSendRequest	Windows	C++	SimpleHttp
WinHttpSetTimeouts	Windows	C++	SimpleHttp
WriteFile	Windows	C# C++	LocalFileSystem → IFile.Write
accept	all	C++	SocketEndPoint → IEndPoint.CreateServer → IServer.Accept
bind	all	C++	SocketEndPoint → IEndPoint.CreateServer
closesocket	Windows	C++	SocketEndPoint → IConnection, IServer → IDisposable.Dispose
connect	Windows	C++	SocketEndPoint → IEndPoint.OpenConnection
fflush	all	C++	Terminal.Flush
freopen	Windows	C++	Terminal.Window
gethostbyname	Windows	C++	SocketEndPoint → IEndPoint.CreateServer
getsockname	Windows	C++	SocketEndPoint → IServer.Accept
htonl	Windows	C++	SocketEndPoint → IEndPoint.CreateServer
htons	Windows	C++	SocketEndPoint → IEndPoint.CreateServer
inet_ntoa	Windows	C++	SocketEndPoint → IEndPoint.CreateServer, IEndPoint.OpenConnection
listen	all	C++	SocketEndPoint → IEndPoint.CreateServer
memcpy	all	C++	ArrayUtil.Copy ByteBuffer.Copy, ByteBuffer.GetBytes, ByteBuffer.PutBytes LowLevel.Copy
memset	all	C++	ArrayUtil.Clear ByteBuffer.Zero
mono_get_runtime_build_info	all	C#	LowLevel.PlatformName
printf	all	C++	Terminal.Write, Terminal.WriteLine
recv	Windows	C++	SocketEndPoint → IConnection.Receive
send	Windows	C++	SocketEndPoint → IConnection.Send
shutdown	Windows	C++	SocketEndPoint → IConnection → IDisposable.Dispose
socket	Windows	C++	SocketEndPoint → IEndPoint.CreateServer, IEndPoint.OpenConnection

Tinman.Engine

This section shows the native functions that are used by the SDK component Tinman.Engine via static linkage.

Table 4. Native function dependencies of Tinman.Engine
Native Dependency	Platform	SDK	Used By
AdjustWindowRect	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Resize
ChoosePixelFormat	Windows	C# C++	WGLContext.WGLContext
ClientToScreen	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.ClientRect
ClipCursor	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseClip
CloseClipboard	Windows	C# C++	ApplicationUtil.Clipboard
CreateWindowEx	Windows	C# C++	ApplicationWindow.Create → INativeWindowRecreate.RecreateNativeWindowIfNecessary, WGLContext.WGLContext
DefWindowProc	Windows	C# C++	ApplicationWindow.Create, WGLContext.WGLContext
DestroyWindow	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow → INativeWindowRecreate.RecreateNativeWindowIfNecessary, IDisposable.Dispose, WGLContext → IDisposable.Dispose
DispatchMessage	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.ProcessSystemMessages
EmptyClipboard	Windows	C# C++	ApplicationUtil.Clipboard
FreeLibrary	Windows	C++	ApplicationWindow.Create
GetClientRect	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.ClientRect
GetClipCursor	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseClip
GetClipboardData	Windows	C# C++	ApplicationUtil.Clipboard
GetCursorPos	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MousePosition
GetDC	Windows	C# C++	WGLContext
GetDpiForWindow	Windows	C# C++	ApplicationWindow.ApplicationWindow
GetFocus	Windows	C# C++	ApplicationWindow → IApplicationWindow.Focus
GetKeyState	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseButtons
GetModuleHandle	Windows	C# C++	ApplicationWindow.Create → INativeWindowRecreate.RecreateNativeWindowIfNecessary, IDisposable.Dispose, WGLContext.WGLContext
GetPixelFormat	Windows	C# C++	RenderContext.Current WGLContext.WGLContext
GetProcAddress	Windows	C++	ApplicationWindow.ApplicationWindow
GetStockObject	Windows	C# C++	ApplicationWindow.Create
GetSystemDpiForProcess	Windows	C# C++	ApplicationWindow.ApplicationWindow
GetSystemMetrics	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseVisible
GetWindowInfo	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.State, INativeWindowRecreate.RecreateNativeWindowIfNecessary
GetWindowText	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Title
GetWindowTextLength	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Title
GlobalAlloc	Windows	C++	ApplicationUtil.Clipboard
GlobalFree	Windows	C++	ApplicationUtil.Clipboard
GlobalLock	Windows	C# C++	ApplicationUtil.Clipboard
GlobalUnlock	Windows	C# C++	ApplicationUtil.Clipboard
IsWindow	Windows	C# C++	ApplicationWindow.ApplicationWindow
LoadCursor	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseCursorSet
LoadIcon	Windows	C# C++	ApplicationWindow.Create
LoadLibrary	Windows	C++	ApplicationWindow.ApplicationWindow
OpenClipboard	Windows	C# C++	ApplicationUtil.Clipboard
PeekMessage	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.ProcessSystemMessages
RegisterClass	Windows	C# C++	ApplicationWindow.Create, WGLContext.WGLContext
ReleaseDC	Windows	C# C++	WGLContext
SetClipboardData	Windows	C# C++	ApplicationUtil.Clipboard
SetCursor	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseCursorSet
SetCursorPos	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MousePosition
SetFocus	Windows	C# C++	ApplicationWindow → IApplicationWindow.Focus
SetPixelFormat	Windows	C# C++	WGLContext
SetWindowLongPtr	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Resize
SetWindowPos	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Resize
SetWindowText	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Title
ShowCursor	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseVisible
ShowWindow	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.Resize
SwapBuffers	Windows	C# C++	WGLContext → RenderContext.Present
SystemParametersInfo	Windows	C# C++	ApplicationWindow.Create
TrackMouseEvent	Windows	C# C++	ApplicationWindow → ApplicationWindowBase.MouseTrack
TranslateMessage	Windows	C# C++	ApplicationWindow.Create → IApplicationWindow.ProcessSystemMessages
UnregisterClass	Windows	C# C++	ApplicationWindow.Create → IDisposable.Dispose, WGLContext → IDisposable.Dispose

Tinman.AddOns.DirectX12

This section shows the native functions that are used by the SDK component Tinman.AddOns.DirectX12 via static linkage.

Table 5. Native function dependencies of Tinman.AddOns.DirectX12
Native Dependency	Platform	SDK	Used By
CloseHandle	Windows	C++	RenderPipeline → IDisposable.Dispose

Tinman.AddOns.WinForms

This section shows the native functions that are used by the SDK component Tinman.AddOns.WinForms via static linkage.

Table 6. Native function dependencies of Tinman.AddOns.WinForms
Native Dependency	Platform	SDK	Used By
GetFontUnicodeRanges	Windows	C#	`Tinman.AddOns.WinForms.SystemFontGlyphs`
SelectObject	Windows	C#	`Tinman.AddOns.WinForms.SystemFontGlyphs`

Dynamic Linkage

The native functions listed in this section are accessed through the NativeLibrary class. They are not required by the Tinman 3D SDK, but their availability will enable add-on features.

The source code of all NativeLibrary subclasses (including non-public ones) is included in the SDK. Please refer to the LibraryNames and InitializeFunctionPointers members for details on which native library files are loaded and which entry points are queried.

Table 7. Native library dependencies with dynamic linkage
SDK Feature	Native Library Wrapper
File Formats
AssimpModelFormat	AssimpLibrary (non-public class)
GdalImageFormat	GdalLibrary (non-public class)
OpenFlightModelFormat	MG
OpenFlightSceneDataFormat	MG
OpenGL
OpenGLBufferFactory, OpenGLContextFactory, OpenGLMeshDispatcher, OpenGLPrimitiveRenderer, OpenGLTextureFactory, OpenGLWorkDispatcher	GL, EGL, GLX, WGL
OpenGLES
OpenGLESBufferFactory, OpenGLESContextFactory, OpenGLESMeshDispatcher, OpenGLESPrimitiveRenderer, OpenGLESTextureFactory,	GLES, EGL, GLX, WGL
Miscellaneous
ProjCoordinateTransform	ProjLibrary (non-public class)

.NET Fallback

The C# version of the Tinman 3D SDK will fallback to plain .NET Standard 2.0 if both LowLevel.IsWindows and LowLevel.IsPosix return false. In fallback mode, some functionality will be limited or unavailable, as described below.

Tinman.Core

LocalFileSystem → IFile.Read

LocalFileSystem → IFile.Write

Concurrent accesses are synchronized per file and thus become sequential.

LocalFileSystem → IFileSystem.DirectoryFreeSpace

Not available, the method will return 0.

LocalFileSystem → IFileSystem.MaximumDirectoryPathLength

LocalFileSystem → IFileSystem.MaximumFilePathLength

LocalFileSystem → IFileSystem.MaximumPathElementLength

Not available, the properties will return Maths.MaxInt.

LowLevel.CpuTotal

LowLevel.CpuUsed

LowLevel.MemoryTotal

LowLevel.MemoryUsed

Not available, the properties will return 0.

LowLevel.TickCount

LowLevel.TickCountPrecise

Instead of the high-resolution timer, the default system timer is used, which might be less accurate.

NativeLibrary.IsLibraryLoaded

NativeLibrary.LookupFunctionPointer

Not available, native libraries cannot be loaded.

In consequence, the following will also not be available: AssimpModelFormat, GdalImageFormat, ProjCoordinateTransform, MG, GL, GLES, WGL, GLX, EGL.

Terminal.Window

Not available, the method will return silently.

Tinman.Engine

ApplicationUtil.Clipboard

Not available, using this property has no effect.

ApplicationWindow.Create

Not available, the method will return null.

RenderContext.Create

RenderContext.Current

Not available, the methods will return null.

In consequence, OpenGL and OpenGLES will also not be available.