Internal change

PiperOrigin-RevId: 897182164
2 files changed
tree: eadb36d247196a10e06e57e222f78146b9816572
  1. .github/
  2. ink/
  3. skia_user_config/
  4. .bazelrc
  5. .gitignore
  6. bazel_build.sh
  7. BUILD.bazel
  8. CODE_OF_CONDUCT.md
  9. CONTRIBUTING.md
  10. fuzztest.bazelrc
  11. LICENSE
  12. MODULE.bazel
  13. ndk_build.sh
  14. README.md
  15. SECURITY.md
README.md

Ink

The Ink library is a freehand stroke generation library. It produces smoothed, modeled stroke shapes with brush effect shaders as mesh-based vector graphics.

This provides the core of the implementation of the Android Jetpack Ink library. While the implementation is well-tested, the developers of this library are not currently making hard guarantees about interface stability.

How to Build and Test

Bazel

Prerequisites:

Ink can be built and tested from the repo root:

bazel test --config=linux ink/...

Library Structure

Ink consists of a set of modules that can be used separately. You should only need to include the parts of the library that you need. The basic dependency structure is:

 ┌──────────┐ ┌───────┐
 │Rendering │ │Storage│
 └────┬─────┘ └──┬────┘
      │          │
      ▼          │
   ┌───────┐     │
   │Strokes│◄────┘
   └───┬───┘
       ▼
   ┌───────┐
   | Brush |
   └─┬────┬┘
     │    │
     │    ▼
     │ ┌────────┐
     │ │Geometry│
     │ └───┬────┘
     │     │
     ▼     ▼
 ┌─────┐ ┌─────┐
 │Color│ │Types│
 └─────┘ └─────┘
  • color: Color spaces, encoding, and format conversion.
  • types: Utility types; time, units, constants, small arrays.
  • geometry: Geometric types (point, segment, triangle, rect, quad), meshes, transforms, utility functions, and algorithms (intersection, envelope).
  • brush: Defines stroke styles and behaviors.
  • strokes: The primary Stroke data type and InProgressStroke builder.
  • rendering: Rendering utilities for strokes. Currently only has support for android.graphics.Mesh based rendering.
  • storage: Protobuf serialization utilities for Stroke and related types.

Contributing

See CONTRIBUTING.md for details on sending a PR.

Contact

Use GitHub Issues to file feedback: https://github.com/google/ink/issues