CD - Canvas Draw Library

A platform-independent 2D graphics library implemented for multiple platforms using native graphics libraries.

CD (Canvas Draw) provides a unified interface for 2D graphics across multiple platforms and output formats. The library abstracts the underlying graphics systems, allowing applications to draw vector graphics, render text, and manipulate images using a consistent API regardless of the target platform or output device.

This fork modernizes the original Tecgraf CD library with significant improvements for contemporary development:

• CMake build system - Replaced legacy "tecmake" build system with modern CMake (3.16+)
• Dependency management - Uses pre-built IM library artifacts instead of complex source builds
• Cross-platform builds - Unified build process with comprehensive CI/CD across Linux, macOS, and Windows

• Apple Silicon macOS - Native support for M1/M2 Macs with proper Homebrew integration
• Modern Linux distributions - Updated dependencies for Ubuntu 24.04+ and contemporary package names
• Windows improvements - Enhanced Visual Studio and vcpkg integration with proper DLL exports

• GitHub Actions CI - Comprehensive continuous integration with matrix builds across platforms and configurations
• Automated testing - Build verification, platform-specific compilation testing, and integration validation
• Dependency optimization - Streamlined external library management and caching strategies

• Cairo integration - Enhanced Cairo backend with proper GTK/GDK conditional compilation
• OpenGL modernization - Updated OpenGL support with FTGL text rendering capabilities
• Cross-platform rendering - Improved platform-specific backend selection and compilation
• PDF/Vector output - Enhanced PostScript, PDF, and SVG generation capabilities

• Robust compilation - Fixed numerous platform-specific compilation issues and header dependencies
• Runtime stability - Improved library loading and cross-platform compatibility
• Modern compilers - Support for contemporary C99/C11 compilers and toolchains
• System integration - Better integration with system package managers and dependency resolution

• Optimized CI/CD pipeline - Enhanced build timeouts, improved caching, and parallel execution
• Cairo compilation fixes - Resolved platform-specific compilation issues for Linux/macOS
• Dependency resolution - Streamlined FTGL, GTK, and system library dependencies
• Cross-platform consistency - Unified behavior across different operating systems and graphics backends

• Vector Graphics: Complete 2D vector drawing capabilities
• Multiple Backends: Native implementations for Windows (GDI/GDI+/Direct2D), X11, Cairo, OpenGL
• File Formats: Support for PostScript, PDF, SVG, CGM, DGN, WMF/EMF, and more
• Image Integration: Seamless integration with the IM (Image Processing) library
• Cross-Platform: Builds on Windows, macOS, and Linux
• Language Bindings: Lua bindings included

• Windows: GDI, GDI+, Direct2D backends
• Linux: X11, Cairo, XRender backends
• macOS: X11, Core Graphics backends
• All Platforms: OpenGL, PDF, PostScript, SVG output

• CMake 3.16 or later
• C99-compatible compiler
• Platform-specific libraries (see below)

sudo apt-get install -y \
  build-essential \
  cmake \
  pkg-config \
  libx11-dev \
  libxext-dev \
  libxrender-dev \
  libxft-dev \
  libcairo2-dev \
  libpango1.0-dev \
  libfreetype6-dev \
  libgl1-mesa-dev \
  libglu1-mesa-dev \
  liblua5.3-dev

brew install cmake pkg-config cairo pango freetype lua

• Visual Studio 2019 or later
• Windows SDK

# Clone with IM dependency
git clone https://github.com/lispnik/tecgraf-cd.git
cd tecgraf-cd

# Also clone the IM library dependency
git clone https://github.com/lispnik/tecgraf-im.git im-git

# Build IM first
cd im-git
mkdir build && cd build
cmake .. -DCMAKE_INSTALL_PREFIX=../install
make -j$(nproc)
make install
cd ../..

# Build CD
mkdir build && cd build
cmake .. \
  -DCMAKE_BUILD_TYPE=Release \
  -DIM_INCLUDE_DIR=../im-git/install/include \
  -DIM_LIBRARY=../im-git/install/lib/libim.so \
  -DCD_ENABLE_CAIRO=ON \
  -DCD_ENABLE_GL=ON \
  -DCD_ENABLE_PDF=ON \
  -DCD_ENABLE_IM=ON \
  -DCD_ENABLE_LUA=ON

make -j$(nproc)
make install

#include <cd.h>

int main() {
    // Create a canvas (native window on each platform)
    cdCanvas* canvas = cdCreateCanvas(cdContextNativeWindow(), NULL);
    
    // Set foreground color to red
    cdCanvasForeground(canvas, CD_RED);
    
    // Draw a line
    cdCanvasLine(canvas, 0, 0, 100, 100);
    
    // Draw a filled rectangle
    cdCanvasBox(canvas, 10, 10, 50, 50);
    
    // Clean up
    cdKillCanvas(canvas);
    
    return 0;
}

CD seamlessly integrates with the IM (Image Processing) library modernized fork:

#include <cd.h>
#include <im.h>

// Load an image with IM
imImage* image = imFileLoadImage("photo.jpg", 0, NULL);

// Create CD canvas from IM image
cdCanvas* canvas = cdCreateCanvas(cdContextImage(), image);

// Draw on the image using CD
cdCanvasForeground(canvas, CD_BLUE);
cdCanvasText(canvas, 10, 10, "Hello World!");

// Save the modified image
imFileSaveImage("output.jpg", "JPEG", image);

cdKillCanvas(canvas);
imImageDestroy(image);

Both CD and IM have been modernized with CMake builds, GitHub Actions CI, and enhanced cross-platform support as part of the lispnik organization's effort to maintain these essential graphics libraries for contemporary development environments.

• Original Documentation: Tecgraf CD Documentation
• API Reference: Available in the html/ directory
• Programming Guide: See html/ directory for comprehensive guides
• Examples: See test/ directory for usage examples
• Build Instructions: See build section above and platform-specific notes

• Tecgraf/PUC-Rio - Computer Graphics Technology Group, Pontifical Catholic University of Rio de Janeiro
• Website: http://www.tecgraf.puc-rio.br/cd
• Contact: [email protected]

This modernized fork is maintained as part of the lispnik GitHub organization, focusing on contemporary cross-platform support, enhanced CI/CD, and improved integration with modern development workflows.

See COPYRIGHT file for license information.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests if applicable
5. Ensure all CI checks pass
6. Submit a pull request

This fork welcomes contributions that maintain compatibility with the original Tecgraf CD API while enhancing cross-platform support, build system improvements, and modern development practices.

This library processes potentially untrusted input. Security-related issues should be reported to the maintainers.

• Required: Platform graphics libraries (GDI/X11/etc.)
• Optional: Cairo, FreeType, OpenGL, Lua
• IM Integration: tecgraf-im library