Features

Currently dlib contains the following packages:

• dlib.core - basic functionality used by other modules (manual memory management, streams, OOP for structs, etc.)
• dlib.container - generic data structures (GC-free dynamic and associative arrays and more)
• dlib.filesystem - abstract FS interface and its implementations for Windows and POSIX filesystems
• dlib.math - linear algebra and numerical analysis (vectors, matrices, quaternions, linear system solvers etc.)
• dlib.geometry - computational geometry (ray casting, primitives, intersection, etc.)
• dlib.image - image processing (8-bit, 16-bit and 32-bit floating point channels, common filters and convolution kernels, resizing, FFT, HDRI, animation, vector graphics rendering, image formats I/O: JPEG, PNG/APNG, BMP, TGA, HDR)
• dlib.audio - sound processing (8 and 16 bits per sample, synthesizers, WAV export and import)
• dlib.network - cross-platform sockets and other network functionality
• dlib.memory - allocators and memory management functions
• dlib.text - GC-free strings and text processing
• dlib.serialization - data serialization, includes JSON and XML parsers
• dlib.coding - various data compression and coding algorithms.

Getting started

Head on to releases page and get the latest source tarball. You may also use dub package instead - add the following dependency to your dub.json:

"dlib": "~>1.3.0"

A simple introductory tutorial on setting up a workspace for D projects can be found here.

Examples

Load PNG image and save its resized copy:

import dlib;

void main()
{
    loadPNG("input.png").resampleBilinear(240, 320).savePNG("output.png");
}

Drawing on an image:

SuperImage img = image(512, 512, 4);
fillColor(img, color4(0x000000ff));
Color4f drawColor = color4(0x07e5f8ff);
img[256, 256] = drawColor;
drawLine(img, drawColor, 280, 280, 511, 511);
savePNG(img, "output.png");

Transform a vector with 4x4 affine matrix:

Vector3f v1 = Vector3f(1, 0, 0);
Vector3f v2 = v1 * translationMatrix(Vector3f(0, 2, 0));

Parsing JSON string:

JSONDocument doc = New!JSONDocument(jsonString);
writeln(doc.root.asObject["name"].asString);
Delete(doc);

A simple 'Hello, world' HTTP server:

StreamSocket listener = new StreamSocket(AddressFamily.INET);
listener.bind(new InternetAddress("127.0.0.1", 8192));
listener.listen(5);
ubyte[] inputBuffer = new ubyte[1024];
while(true)
{
    ConnectedSocket connection = listener.accept();
    if (connection)
    {
        auto numBytesReceived = connection.receive(inputBuffer);
        string receivedStr = cast(string)inputBuffer[0..numBytesReceived];
        writeln(receivedStr);

        string responce = "HTTP/1.1 200 OK\r\nContent-Type: text/html; charset=UTF-8\r\n\r\nHello, world!\r\n";
        connection.send(cast(ubyte[])responce);

        connection.close();
    }
}

Working with filesystem without garbage collection:

StdFileSystem fs = New!StdFileSystem();

foreach(path, entry; fs.traverseDir("./", true))
{
    writeln(path);
    writeln(entry.isFile);
}

FileStat s;
if (fs.stat("dub.json", s)) // otherwise doesn't exist
{
    writeln(s.creationTimestamp);
    if (s.permissions & PRead)
    {
        StdInFileStream strm = fs.openForInput("dub.json");
        String text = String(strm);
        Delete(strm);
        writeln(text);
        text.free();
    }
}

Delete(fs);

Documentation

There is ddox documentation generated from source code. Be aware that it is currently incomplete, we are working towards making it more comprehensive. For support and overall discussions, use our Gitter chat room.

Articles on dlib:

• dlib: Past, Present and Future (Timur Gafarov, 2021)
• Alternative Memory Management in D (Timur Gafarov, 2018)
• Articles at LightHouse Software blog (various authors, in Russian)

Contributing

If you want to contribute code to dlib, send pull requests to the project repository. Please, read Contributing Guidelines first.

Found a bug? Please, create an issue here.

dlib was created by Timur Gafarov, Martin Cejp, Andrey Penechko, Vadim Lopatin, Nick Papanastasiou, Oleg Baharev, Roman Chistokhodov, Eugene Wissner, Roman Vlasov, Basile Burg, Valeriy Fedotov, Ferhat Kurtulmuş.

Sponsorship

If you like dlib, please support its development on Patreon and get a reward depending on your donation amount. Supporters who donate $10 and more will be listed on this page as Sponsors. You can also make donation via PayPal.

Big thanks to these awesome people for supporting dlib: Daniel Laburthe, Rafał Ziemniewski, Kumar Sookram, Aleksandr Kovalev, Robert Georges, Jan Jurzitza (WebFreak), Rais Safiullin (SARFEX), Benas Cernevicius, Koichi Takio.

Usage

Some interesting projects that use dlib:

• Dagon, 3D game engine
• Electronvolt, a game that uses dlib and Dagon
• DlangUI, native UI toolkit for D - uses dlib.image
• RIP, image processing and analysis library by LightHouse Software
• Voxelman, voxel game engine - uses dlib.image and dlib.math
• dlib-webp, WebP loader for dlib.image.