How opencl/gegl-opencl works
GEGL is a graph-based image-processing framework: callers connect operation nodes, request an output region, and receive rendered pixels. The main runtime path runs from the CLI or API through graph evaluation and traversal to image operations, whose buffers are backed by a tiled storage and handler system. The README documents loading, filtering, transforming, compositing, saving, pixel-format conversion via BABL, and optional OpenCL execution. The excerpts show graph evaluation and tile-handler setup; several other links are based on README documentation, not sampled implementation.
Main entry points: gegl-operation.c Operation framework · gegl-buffer.c Image buffers · gegl-node.c Node graph · gegl-tile-storage.c Tile storage
Components 18
Graph execution
- Node graph
gegl/graph/gegl-node.c - Evaluation manager
gegl/process/gegl-eval-manager.c - Graph traversal
gegl/process/gegl-graph-traversal.c - Operation registry
gegl/operation/gegl-operations.c
Image operations
- Operation framework
gegl/operation/gegl-operation.c - Image I/O
operations/core/load.c - Filters and color
operations/common/brightness-contrast.c - Transforms and composites
operations/transform/transform-core.c
Pixel data
- Image buffers
gegl/buffer/gegl-buffer.c - Tile storage
gegl/buffer/gegl-tile-storage.c - Tile cache
gegl/buffer/gegl-tile-handler-cache.c - Tile backends
gegl/buffer/gegl-tile-backend.c - BABL formats
Acceleration
- OpenCL runtime
gegl/opencl/gegl-cl.c - OpenCL kernels
opencl/box-blur.cl.h
Other components
- Caller
Connections 21
- Caller → GEGL CLI: runs
- Caller → C API: requests rendering
gegl/gegl.h - GEGL CLI → Node graph: constructs graph
- C API → Node graph: builds graph
gegl/gegl.h - Node graph → Evaluation manager: requests evaluation
gegl/graph/gegl-node.c - Evaluation manager → Graph traversal: builds and processes
gegl/process/gegl-eval-manager.c - Node graph → Operation registry: resolves operations
gegl/graph/gegl-node.c - Graph traversal → Operation framework: dispatches work
- Operation registry → Operation framework: registers operations
- Operation framework → Image I/O: provides I/O
- Operation framework → Filters and color: provides filtering
- Operation framework → Transforms and composites: provides transforms
- Image I/O → Image buffers: reads and writes
- Filters and color → Image buffers: processes pixels
- Transforms and composites → Image buffers: processes pixels
- Image buffers → Tile storage: stores tiles
- Tile storage → Tile backends: uses backend
gegl/buffer/gegl-tile-storage.c - Tile storage → Tile cache: adds handler
gegl/buffer/gegl-tile-storage.c - Image buffers → BABL formats: converts formats
- Operation framework → OpenCL runtime: may use
- OpenCL runtime → OpenCL kernels: runs kernels