HelpSource/Classes/ContiguousBlockAllocator.schelp

   1 class:: ContiguousBlockAllocator
   2 summary:: for better handling of dynamic allocation
   3 related:: Classes/Server, Classes/PowerOfTwoAllocator
   4 categories:: Control
   5
   6 description::
   7
   8 A more robust replacement for the default server block allocator, link::Classes/PowerOfTwoAllocator::. May be used in the link::Classes/Server:: class to allocate audio/control bus numbers and buffer numbers.
   9
  10 To configure a server to use ContiguousBlockAllocator, execute the following:
  11 code::
  12 aServer.options.blockAllocClass = ContiguousBlockAllocator;
  13 ::
  14 Normally you will not need to address the allocators directly. However, ContiguousBlockAllocator adds one feature not present in PowerOfTwoAllocator, namely the emphasis::reserve:: method.
  15
  16 ClassMethods::
  17
  18 method::new
  19 Create a new allocator with emphasis::size:: slots. You may block off the first emphasis::pos:: slots (the server's audioBusAllocator does this to reserve the hardware input and output buses).
  20
  21 InstanceMethods::
  22
  23 private::prReserve, prSplit
  24
  25 method::alloc
  26 Return the starting index of a free block that is emphasis::n:: slots wide. The default is 1 slot.
  27
  28 method::free
  29 Free a previously allocated block starting at emphasis::address::.
  30
  31 method::reserve
  32 Mark a specific range of addresses as used so that the alloc method will not return any addresses within that range.
  33
  34