mirror of
https://github.com/ddidderr/wuffs.git
synced 2026-11-17 16:32:11 +01:00
37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# C Base Code
|
|
|
|
This directory (`base`) and its sibling
|
|
([`auxiliary`](/internal/cgen/auxiliary)) contain C and C++ code respectively.
|
|
This C/C++ code combines with the transpiled-to-C/C++ form of the Wuffs code in
|
|
the top-level [`std`](/std) directory to create the "single file C/C++ library"
|
|
form of the Wuffs standard library.
|
|
|
|
- From Wuffs-the-language's point of view, this directory contains
|
|
implementations of the built-in `base` package types, such as [I/O
|
|
buffers](/doc/note/io-input-output.md), [ranges and
|
|
rects](/doc/note/ranges-and-rects.md) and [statuses](/doc/note/statuses.md).
|
|
- From application code's point of view (Wuffs is for writing libraries not
|
|
applications), this directory also contains helper functions for working with
|
|
those `base` types, such as constructing an I/O buffer from a pointer and a
|
|
length, that aren't relevant to Wuffs-the-language code.
|
|
- This directory also contains some functionality (e.g. pixel conversion and
|
|
string conversion) that, in the future, could possibly be Wuffs packages
|
|
under `std`. For optimal performance, they sometimes require programming
|
|
language features (e.g. function-pointer typed variables, SIMD acceleration)
|
|
that are not yet available in Wuffs-the-language (or were not available at
|
|
the time they were added). In the short term, it was more practical to
|
|
implement them in carefully hand-written C/C++, in this directory. In the
|
|
long term, they could migrate out of `base` to be under `std`, but any `base`
|
|
API removal would require a Wuffs version number bump.
|
|
|
|
|
|
## Making Changes
|
|
|
|
After editing source code in this directory, to see those changes when
|
|
generating the C/C++ form of Wuffs' standard library:
|
|
|
|
go install github.com/google/wuffs/cmd/wuffs-c && wuffs gen base
|
|
|
|
This should modify the
|
|
[`wuffs-unsupported-snapshot.c`](/release/c/wuffs-unsupported-snapshot.c) file.
|