299 <blockquote>This creates a new gear at position x,y (measured from top left) of kind gearType (see [GearTypes Gear Types]). The initial velocities are dx and dy. All arguments are numbers. The function returns the uid of the gear created.

   299 <blockquote>This creates a new gear at position x,y (measured from top left) of kind gearType (see [GearTypes Gear Types]). The initial velocities are dx and dy. All arguments are numbers. The function returns the uid of the gear created. Gears can have multple states at once: `state` is a bitmask, the flag variables can be found in [States].

   436 <blockquote>returns the state of the gear. This is one of [States]

   436 Returns the state of the gear. The gear state is a bitmask which is built out of the variables as shown in [States].

   437 </blockquote>

   437 

   438 This function is usually used in combination with `band` to extract the truth value of a single flag. It is also used together with `SetState` and `bor` in order to activate a single flag.

   439 

   440 Examples:

   441 <code language="lua">

   442 local state = GetState(gear)

   443 --[[ Stores the full raw bitmask of gear in state. Usually

   444 useless on its own. ]]

   445 </code>

   446 

   447 <code language="lua">

   448 isDrowning = band(GetState(CurrentHedgehog),gstDrowning) ~= 0

   449 --[[ GetState(CurrentHedgehog) returns the state bitmask of

   450 CurrentHedgehog, gstDrowning is a bitmask where only the

   451 “drowning” bit is set. band does a bitwise AND on both, if

   452 it returns a non-zero value, the hedgehog is drowning.]]

   453 </code>

   454 

   455 <code language="lua">

   456 SetState(CurrentHedgehog, bor(GetState(CurrentHedgehog), gstInvisible))

   457 --[[ first the state bitmask of CurrentHedgehog is bitwise ORed with

   458 the gstInvisible flag, thus making the bit responsible for

   459 invisiblity to become 1. Then the new bitmask is applied to

   460 CurrentHedgehog, thus making it invisible.]]

   461 </code>

   462 

   463 

   655 <blockquote>Sets the state of the specified gear to one of [States].

   681 Sets the state of the specified gear to the specified `state`. This is a bitmask made out of the variables as seen in [States].

   656 </blockquote>

   682 

   683 This function is often used together with `GetState` and the bitmask utility functions `band` and `bnot` in order to manipulate a single flag.

   684 

   685 Examples:

   686 <code language="lua">

   687 SetState(CurrentHedgehog, bor(GetState(CurrentHedgehog), gstInvisible))

   688 --[[ first the state bitmask of CurrentHedgehog is bitwise ORed with

   689 the gstInvisible flag, thus making the bit responsible for

   690 invisiblity to become 1. Then the new bitmask is applied to

   691 CurrentHedgehog, thus making it invisible. ]]

   692 </code>

   693 

   694 <code language="lua">

   695 SetState(CurrentHedgehog, band(GetState(CurrentHedgehog), bnot(gstInvisible)))

   696 --[[ The reverse of the above: This function toggles CurrentHedgehog’s

   697 gstInvisible flag off, thus making it visible again. ]]

   698 </code>