.. This file is auto-generated by the Sphinx pre-build hook in
   ``documentation/source/conf.py`` from
   ``documentation/source/_data/patcher_objects.json``.
   Do not edit by hand — re-run ``python yse.py dump-patcher-meta`` to
   refresh the JSON, then ``make html`` to re-render this page.

Patcher object reference
========================

Every patcher object that ``patcher::CreateObject`` knows about — 305
in all — grouped by category, one page per category. The category is the
same one a host editor reads through the C API metadata
(``yse_patcher_get_type_category`` and the ``"category"`` key of
``yse_patcher_get_metadata_json``) to build its object palette.

.. list-table::
   :header-rows: 1
   :widths: 28 10 62

   * - Category
     - Objects
     - Contents
   * - :doc:`signal_generators`
     - 4
     - Audio-rate sources: oscillators, noise and ramps.
   * - :doc:`filters`
     - 4
     - Audio-rate filters.
   * - :doc:`math`
     - 69
     - Arithmetic, comparison, conversion, scaling and analysis of numbers.
   * - :doc:`random`
     - 5
     - Random numbers, random walks and probabilistic choices.
   * - :doc:`routing`
     - 13
     - Steering messages between inlets and outlets.
   * - :doc:`control_flow`
     - 11
     - Ordering, looping, conditions and load-time messages.
   * - :doc:`lists`
     - 11
     - Building lists, taking them apart and processing them.
   * - :doc:`strings`
     - 10
     - Text, symbols and character codes.
   * - :doc:`collections`
     - 6
     - Stores that hold numbers or messages for later recall.
   * - :doc:`dictionaries`
     - 13
     - The ``.dict`` family: keyed, nested data.
   * - :doc:`arrays`
     - 57
     - The ``.array`` family: ordered data and the operations on it.
   * - :doc:`time`
     - 17
     - Clocks, delays, ramps, rate limiting and tempo.
   * - :doc:`sequencing`
     - 3
     - Recording messages and playing them back in time.
   * - :doc:`midi`
     - 45
     - Formatting, parsing and note handling for MIDI, and MIDI device I/O.
   * - :doc:`gui`
     - 25
     - User-facing controls and message boxes, driven by the GUI value protocol.
   * - :doc:`input_output`
     - 7
     - Audio in and out of the graph, named send/receive, and host-facing I/O.
   * - :doc:`subpatchers`
     - 5
     - Subpatchers and the inlets and outlets that form their boundary.

.. toctree::
   :hidden:
   :maxdepth: 1

   signal_generators
   filters
   math
   random
   routing
   control_flow
   lists
   strings
   collections
   dictionaries
   arrays
   time
   sequencing
   midi
   gui
   input_output
   subpatchers