Browse Source

Doxygen: Remove groups from LittleFoot functions

tags/2021-05-28
tpoole 7 years ago
parent
commit
25b1390a4a
2 changed files with 10 additions and 230 deletions
  1. +1
    -1
      doxygen/Doxyfile
  2. +9
    -229
      modules/juce_blocks_basics/juce_LittleFootFunctions.dox

+ 1
- 1
doxygen/Doxyfile View File

@@ -397,7 +397,7 @@ SUBGROUPING = YES
# SEPARATE_MEMBER_PAGES. # SEPARATE_MEMBER_PAGES.
# The default value is: NO. # The default value is: NO.


INLINE_GROUPED_CLASSES = YES
INLINE_GROUPED_CLASSES = NO


# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions # When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
# with only public data fields or simple typedef fields will be shown inline in # with only public data fields or simple typedef fields will be shown inline in


+ 9
- 229
modules/juce_blocks_basics/juce_LittleFootFunctions.dox View File

@@ -1,32 +1,7 @@
/** @defgroup LittleFootFunctions LittleFoot Functions
Functions available in the LittleFoot language
@{
@defgroup LittleFootFunctions-Graphics Graphics functions
@defgroup LittleFootFunctions-MIDI MIDI functions
@defgroup LittleFootFunctions-Callbacks Callbacks from the OS
@defgroup LittleFootFunctions-Maths Math functions
@defgroup LittleFootFunctions-Memory Memory Access functions
@defgroup LittleFootFunctions-Debug Debugging functions
@defgroup LittleFootFunctions-Configs Configuration functions
@defgroup LittleFootFunctions-Messaging Messaging functions
@defgroup LittleFootFunctions-Clustering Cluster functions
@defgroup LittleFootFunctions-Topology Topology functions
@defgroup LittleFootFunctions-Touch Touch functions
@defgroup LittleFootFunctions-Lightpad Lightpad specific functions
@defgroup LittleFootFunctions-ControlBlock Control Block specific functions
@defgroup LittleFootFunctions-Seaboard Seaboard specific functions
@defgroup LittleFootFunctions-Power Power functions
@defgroup LittleFootFunctions-Utility Utility functions
@defgroup LittleFootFunctions-Internal Internal functions (not for general usage)
*/
/** Reads and returns the value of a single byte from the heap. /** Reads and returns the value of a single byte from the heap.
@param byteIndex the index (in bytes) of the byte to read @param byteIndex the index (in bytes) of the byte to read
@returns the value of the byte @returns the value of the byte
@ingroup LittleFootFunctions-Memory
*/ */
int getHeapByte (int byteIndex); int getHeapByte (int byteIndex);
@@ -34,8 +9,6 @@ int getHeapByte (int byteIndex);
@param byteIndex the index (in bytes) of the start of the 4 bytes to read @param byteIndex the index (in bytes) of the start of the 4 bytes to read
@returns the value of the 4 bytes as an integer @returns the value of the 4 bytes as an integer
@ingroup LittleFootFunctions-Memory
*/ */
int getHeapInt (int byteIndex); int getHeapInt (int byteIndex);
@@ -44,8 +17,6 @@ int getHeapInt (int byteIndex);
@param startBitIndex the index (in bits) of the start of the sequence of bits to read @param startBitIndex the index (in bits) of the start of the sequence of bits to read
@param numBits how many bits to read @param numBits how many bits to read
@returns the value of the sequence of bits as an integer @returns the value of the sequence of bits as an integer
@ingroup LittleFootFunctions-Memory
*/ */
int getHeapBits (int startBitIndex, int numBits); int getHeapBits (int startBitIndex, int numBits);
@@ -53,8 +24,6 @@ int getHeapBits (int startBitIndex, int numBits);
@param byteIndex the index (in bytes) of the byte to set @param byteIndex the index (in bytes) of the byte to set
@param newValue the new value to set this byte to @param newValue the new value to set this byte to
@ingroup LittleFootFunctions-Memory
*/ */
void setHeapByte (int byteIndex, int newValue); void setHeapByte (int byteIndex, int newValue);
@@ -62,8 +31,6 @@ void setHeapByte (int byteIndex, int newValue);
@param byteIndex the index (in bytes) of the start of the 4 bytes to set @param byteIndex the index (in bytes) of the start of the 4 bytes to set
@param newValue the new value to set the 4 bytes to @param newValue the new value to set the 4 bytes to
@ingroup LittleFootFunctions-Memory
*/ */
void setHeapInt (int byteIndex, int newValue); void setHeapInt (int byteIndex, int newValue);
@@ -72,8 +39,6 @@ void setHeapInt (int byteIndex, int newValue);
@param a The first parameter @param a The first parameter
@param b The second parameter @param b The second parameter
@retval The minimum of a and b @retval The minimum of a and b
@ingroup LittleFootFunctions-Maths
*/ */
int min (int a, int b); int min (int a, int b);
@@ -82,8 +47,6 @@ int min (int a, int b);
@param a The first parameter @param a The first parameter
@param b The second parameter @param b The second parameter
@retval The minimum of a and b @retval The minimum of a and b
@ingroup LittleFootFunctions-Maths
*/ */
float min (float a, float b); float min (float a, float b);
@@ -92,8 +55,6 @@ float min (float a, float b);
@param a The first parameter @param a The first parameter
@param b The second parameter @param b The second parameter
@retval The maximum of a and b @retval The maximum of a and b
@ingroup LittleFootFunctions-Maths
*/ */
int max (int a, int b); int max (int a, int b);
@@ -102,8 +63,6 @@ int max (int a, int b);
@param a The first parameter @param a The first parameter
@param b The second parameter @param b The second parameter
@retval The maximum of a and b @retval The maximum of a and b
@ingroup LittleFootFunctions-Maths
*/ */
float max (float a, float b); float max (float a, float b);
@@ -114,8 +73,6 @@ float max (float a, float b);
@param valueToConstrain the value to try to return @param valueToConstrain the value to try to return
@returns the closest value to valueToConstrain which lies between lowerLimit @returns the closest value to valueToConstrain which lies between lowerLimit
and upperLimit (inclusive) and upperLimit (inclusive)
@ingroup LittleFootFunctions-Maths
*/ */
int clamp (int lowerLimit, int upperLimit, int valueToConstrain); int clamp (int lowerLimit, int upperLimit, int valueToConstrain);
@@ -126,8 +83,6 @@ int clamp (int lowerLimit, int upperLimit, int valueToConstrain);
@param valueToConstrain the value to try to return @param valueToConstrain the value to try to return
@returns the closest value to valueToConstrain which lies between lowerLimit @returns the closest value to valueToConstrain which lies between lowerLimit
and upperLimit (inclusive) and upperLimit (inclusive)
@ingroup LittleFootFunctions-Maths
*/ */
float clamp (float lowerLimit, float upperLimit, float valueToConstrain); float clamp (float lowerLimit, float upperLimit, float valueToConstrain);
@@ -135,8 +90,6 @@ float clamp (float lowerLimit, float upperLimit, float valueToConstrain);
@param arg The argument to compute the absolute value of @param arg The argument to compute the absolute value of
@retval either -arg if arg is negative or arg if arg is positive @retval either -arg if arg is negative or arg if arg is positive
@ingroup LittleFootFunctions-Maths
*/ */
int abs (int arg); int abs (int arg);
@@ -144,8 +97,6 @@ int abs (int arg);
@param arg The argument to compute the absolute value of @param arg The argument to compute the absolute value of
@retval either -arg if arg is negative or arg if arg is positive @retval either -arg if arg is negative or arg if arg is positive
@ingroup LittleFootFunctions-Maths
*/ */
float abs (float arg); float abs (float arg);
@@ -157,8 +108,6 @@ float abs (float arg);
@param destMin the minumum value of the destination range @param destMin the minumum value of the destination range
@param destMax the maximum value of the destination range @param destMax the maximum value of the destination range
@returns the original value mapped to the destination range @returns the original value mapped to the destination range
@ingroup LittleFootFunctions-Maths
*/ */
float map (float value, float sourceMin, float sourceMax, float destMin, float destMax); float map (float value, float sourceMin, float sourceMax, float destMin, float destMax);
@@ -168,8 +117,6 @@ float map (float value, float sourceMin, float sourceMax, float destMin, float d
@param sourceMin the minimum value of the source range @param sourceMin the minimum value of the source range
@param sourceMax the maximum value of the source range @param sourceMax the maximum value of the source range
@returns the original value mapped to the range 0 - 1.0 @returns the original value mapped to the range 0 - 1.0
@ingroup LittleFootFunctions-Maths
*/ */
float map (float value, float sourceMin, float sourceMax); float map (float value, float sourceMin, float sourceMax);
@@ -177,24 +124,18 @@ float map (float value, float sourceMin, float sourceMax);
The divisor must be greater than zero. The divisor must be greater than zero.
@returns the result of the modulo operation @returns the result of the modulo operation
@ingroup LittleFootFunctions-Maths
*/ */
int mod (int dividend, int divisor); int mod (int dividend, int divisor);
/** Returns a random floating-point number. /** Returns a random floating-point number.
@returns a random value in the range 0 (inclusive) to 1.0 (exclusive) @returns a random value in the range 0 (inclusive) to 1.0 (exclusive)
@ingroup LittleFootFunctions-Maths
*/ */
float getRandomFloat(); float getRandomFloat();
/** Returns a random integer, limited to a given range. /** Returns a random integer, limited to a given range.
@returns a random integer between 0 (inclusive) and maxValue (exclusive). @returns a random integer between 0 (inclusive) and maxValue (exclusive).
@ingroup LittleFootFunctions-Maths
*/ */
int getRandomInt (int maxValue); int getRandomInt (int maxValue);
@@ -202,48 +143,34 @@ int getRandomInt (int maxValue);
@returns a monotonically increasing value which is unaffected by changes to the @returns a monotonically increasing value which is unaffected by changes to the
system clock. It should be accurate to within a few millisecseconds. system clock. It should be accurate to within a few millisecseconds.
@ingroup LittleFootFunctions-Maths
*/ */
int getMillisecondCounter(); int getMillisecondCounter();
/** Returns the length of time spent in the current function call in milliseconds. /** Returns the length of time spent in the current function call in milliseconds.
@returns the length of time spent in the current function call in milliseconds. @returns the length of time spent in the current function call in milliseconds.
@ingroup LittleFootFunctions-Maths
*/ */
int getTimeInCurrentFunctionCall(); int getTimeInCurrentFunctionCall();
/** Logs an integer value to the console. /** Logs an integer value to the console.
@param data The 32 bit signed integer to log to the topology as an integer @param data The 32 bit signed integer to log to the topology as an integer
@ingroup LittleFootFunctions-Debug
*/ */
void log (int data); void log (int data);
/** Logs a hexadecimal value to the console. /** Logs a hexadecimal value to the console.
@param data The 32 bit signed integer to log to the topology as a hexidecimal int @param data The 32 bit signed integer to log to the topology as a hexidecimal int
@ingroup LittleFootFunctions-Debug
*/ */
void logHex (int data); void logHex (int data);
/** Sends a 1-byte short midi message.
@ingroup LittleFootFunctions-MIDI
*/
/** Sends a 1-byte short midi message. */
void sendMIDI (int byte0); void sendMIDI (int byte0);
/** Sends a 2-byte short midi message.
@ingroup LittleFootFunctions-MIDI
*/
/** Sends a 2-byte short midi message. */
void sendMIDI (int byte0, int byte1); void sendMIDI (int byte0, int byte1);
/** Sends a 3-byte short midi message.
@ingroup LittleFootFunctions-MIDI
*/
/** Sends a 3-byte short midi message. */
void sendMIDI (int byte0, int byte1, int byte2); void sendMIDI (int byte0, int byte1, int byte2);
/** Sends a key-down message. /** Sends a key-down message.
@@ -251,8 +178,6 @@ void sendMIDI (int byte0, int byte1, int byte2);
@param channel the midi channel, in the range 0 to 15 @param channel the midi channel, in the range 0 to 15
@param noteNumber the key number, in the range 0 to 127 @param noteNumber the key number, in the range 0 to 127
@param velocity the velocity, in the range 0 to 127 @param velocity the velocity, in the range 0 to 127
@ingroup LittleFootFunctions-MIDI
*/ */
void sendNoteOn (int channel, int noteNumber, int velocity); void sendNoteOn (int channel, int noteNumber, int velocity);
@@ -261,8 +186,6 @@ void sendNoteOn (int channel, int noteNumber, int velocity);
@param channel the midi channel, in the range 0 to 15 @param channel the midi channel, in the range 0 to 15
@param noteNumber the key number, in the range 0 to 127 @param noteNumber the key number, in the range 0 to 127
@param velocity the velocity, in the range 0 to 127 @param velocity the velocity, in the range 0 to 127
@ingroup LittleFootFunctions-MIDI
*/ */
void sendNoteOff (int channel, int noteNumber, int velocity); void sendNoteOff (int channel, int noteNumber, int velocity);
@@ -271,8 +194,6 @@ void sendNoteOff (int channel, int noteNumber, int velocity);
@param channel the midi channel, in the range 0 to 15 @param channel the midi channel, in the range 0 to 15
@param noteNumber the key number, in the range 0 to 127 @param noteNumber the key number, in the range 0 to 127
@param level the amount of aftertouch, in the range 0 to 127 @param level the amount of aftertouch, in the range 0 to 127
@ingroup LittleFootFunctions-MIDI
*/ */
void sendAftertouch (int channel, int noteNumber, int level); void sendAftertouch (int channel, int noteNumber, int level);
@@ -281,8 +202,6 @@ void sendAftertouch (int channel, int noteNumber, int level);
@param channel the midi channel, in the range 0 to 15 @param channel the midi channel, in the range 0 to 15
@param controller the type of controller @param controller the type of controller
@param value the controller value @param value the controller value
@ingroup LittleFootFunctions-MIDI
*/ */
void sendCC (int channel, int controller, int value); void sendCC (int channel, int controller, int value);
@@ -290,8 +209,6 @@ void sendCC (int channel, int controller, int value);
@param channel the midi channel, in the range 0 to 15 @param channel the midi channel, in the range 0 to 15
@param position the wheel position, in the range 0 to 16383 @param position the wheel position, in the range 0 to 16383
@ingroup LittleFootFunctions-MIDI
*/ */
void sendPitchBend (int channel, int position); void sendPitchBend (int channel, int position);
@@ -299,8 +216,6 @@ void sendPitchBend (int channel, int position);
@param channel the midi channel, in the range 0 to 15 @param channel the midi channel, in the range 0 to 15
@param pressure the pressure, in the range 0 to 127 @param pressure the pressure, in the range 0 to 127
@ingroup LittleFootFunctions-MIDI
*/ */
void sendChannelPressure (int channel, int pressure); void sendChannelPressure (int channel, int pressure);
@@ -309,8 +224,6 @@ void sendChannelPressure (int channel, int pressure);
@param useMPE @param useMPE
@param lowChannel @param lowChannel
@param highChannel @param highChannel
@ingroup LittleFootFunctions-MIDI
*/ */
void setChannelRange (bool useMPE, int lowChannel, int highChannel); void setChannelRange (bool useMPE, int lowChannel, int highChannel);
@@ -318,8 +231,6 @@ void setChannelRange (bool useMPE, int lowChannel, int highChannel);
@param noteNumber the note number to assign the channel to @param noteNumber the note number to assign the channel to
@returns the MIDI channel that has been assigned @returns the MIDI channel that has been assigned
@ingroup LittleFootFunctions-MIDI
*/ */
int assignChannel (int noteNumber); int assignChannel (int noteNumber);
@@ -327,45 +238,32 @@ int assignChannel (int noteNumber);
@param noteNumber the note number to deassign @param noteNumber the note number to deassign
@param channel the MIDI channel @param channel the MIDI channel
@ingroup LittleFootFunctions-MIDI
*/ */
void deassignChannel (int noteNumber, int channel); void deassignChannel (int noteNumber, int channel);
/** Returns the channel that is being used for control messages. /** Returns the channel that is being used for control messages.
@returns the channel that is being used for control messages. (If MPE is enabled then this will be the first channel.) @returns the channel that is being used for control messages. (If MPE is enabled then this will be the first channel.)
@ingroup LittleFootFunctions-MIDI
*/ */
int getControlChannel(); int getControlChannel();
/** Sets whether duplicate notes should be filtered out when MPE is enabled.
@ingroup LittleFootFunctions-MIDI
*/
/** Sets whether duplicate notes should be filtered out when MPE is enabled. */
void useMPEDuplicateFilter (bool active); void useMPEDuplicateFilter (bool active);
/** Use this method to draw the display. /** Use this method to draw the display.
The block will call this approximately 25 times per second. The block will call this approximately 25 times per second.
@ingroup LittleFootFunctions-Callbacks
*/ */
void repaint(); void repaint();
/** Called when a button is pushed. /** Called when a button is pushed.
@param index the index of the button that was pushed @param index the index of the button that was pushed
@ingroup LittleFootFunctions-Callbacks
*/ */
void handleButtonDown (int index); void handleButtonDown (int index);
/** Called when a button is released. /** Called when a button is released.
@param index the index of the button that was released @param index the index of the button that was released
@ingroup LittleFootFunctions-Callbacks
*/ */
void handleButtonUp (int index); void handleButtonUp (int index);
@@ -373,8 +271,6 @@ void handleButtonUp (int index);
@param buttonIndex the index of the button @param buttonIndex the index of the button
@ingroup LittleFootFunctions-Callbacks
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
@note Only valid with a control block @note Only valid with a control block
*/ */
@@ -384,8 +280,6 @@ void onControlPress (int buttonIndex);
@param buttonIndex the index of the button @param buttonIndex the index of the button
@ingroup LittleFootFunctions-Callbacks
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
@note Only valid with a control block @note Only valid with a control block
*/ */
@@ -398,8 +292,6 @@ void onControlRelease (int buttonIndex);
@param y the Y position of this touch on the device, in block units starting from 0 (top) @param y the Y position of this touch on the device, in block units starting from 0 (top)
@param z the current pressure of this touch, in the range 0.0 (no pressure) to 1.0 (very hard) @param z the current pressure of this touch, in the range 0.0 (no pressure) to 1.0 (very hard)
@param vz the rate at which pressure is currently changing, measured in units/second @param vz the rate at which pressure is currently changing, measured in units/second
@ingroup LittleFootFunctions-Touch
*/ */
void touchStart (int index, float x, float y, float z, float vz); void touchStart (int index, float x, float y, float z, float vz);
@@ -410,8 +302,6 @@ void touchStart (int index, float x, float y, float z, float vz);
@param y the Y position of this touch on the device, in block units starting from 0 (top) @param y the Y position of this touch on the device, in block units starting from 0 (top)
@param z the current pressure of this touch, in the range 0.0 (no pressure) to 1.0 (very hard) @param z the current pressure of this touch, in the range 0.0 (no pressure) to 1.0 (very hard)
@param vz the rate at which pressure is currently changing, measured in units/second @param vz the rate at which pressure is currently changing, measured in units/second
@ingroup LittleFootFunctions-Touch
*/ */
void touchMove (int index, float x, float y, float z, float vz); void touchMove (int index, float x, float y, float z, float vz);
@@ -422,27 +312,18 @@ void touchMove (int index, float x, float y, float z, float vz);
@param y the Y position of this touch on the device, in block units starting from 0 (top) @param y the Y position of this touch on the device, in block units starting from 0 (top)
@param z the current pressure of this touch, in the range 0.0 (no pressure) to 1.0 (very hard) @param z the current pressure of this touch, in the range 0.0 (no pressure) to 1.0 (very hard)
@param vz the rate at which pressure is currently changing, measured in units/second @param vz the rate at which pressure is currently changing, measured in units/second
@ingroup LittleFootFunctions-Touch
*/ */
void touchEnd (int index, float x, float y, float z, float vz); void touchEnd (int index, float x, float y, float z, float vz);
/** Called when a program is loaded onto the block and is about to start. Do any setup here.
@ingroup LittleFootFunctions-Callbacks
*/
/** Called when a program is loaded onto the block and is about to start. Do any setup here. */
void initialise(); void initialise();
/** Called when a block receives a MIDI message.
@ingroup LittleFootFunctions-MIDI
*/
/** Called when a block receives a MIDI message. */
void handleMIDI (int byte0, int byte1, int byte2); void handleMIDI (int byte0, int byte1, int byte2);
/** Called when a block receives a message. /** Called when a block receives a message.
@see sendMessageToBlock @see sendMessageToBlock
@ingroup LittleFootFunctions-Messaging
*/ */
void handleMessage (int param1, int param2, int param3); void handleMessage (int param1, int param2, int param3);
@@ -453,8 +334,6 @@ void handleMessage (int param1, int param2, int param3);
@param red The red in range 0 - 255 inclusive @param red The red in range 0 - 255 inclusive
@param green The green in range 0 - 255 inclusive @param green The green in range 0 - 255 inclusive
@param blue The blue in range 0 - 255 inclusive @param blue The blue in range 0 - 255 inclusive
@ingroup LittleFootFunctions-Graphics
*/ */
int makeARGB (int alpha, int red, int green, int blue); int makeARGB (int alpha, int red, int green, int blue);
@@ -463,8 +342,6 @@ int makeARGB (int alpha, int red, int green, int blue);
@param baseColour the colour to blend on to @param baseColour the colour to blend on to
@param overlaidColour The colour to blend in to the baseColour @param overlaidColour The colour to blend in to the baseColour
@returns The blended colour @returns The blended colour
@ingroup LittleFootFunctions-Graphics
*/ */
int blendARGB (int baseColour, int overlaidColour); int blendARGB (int baseColour, int overlaidColour);
@@ -472,23 +349,16 @@ int blendARGB (int baseColour, int overlaidColour);
A control block will light up its top LEDs indicating battery level and a lightpad A control block will light up its top LEDs indicating battery level and a lightpad
block will draw the battery level on the display. block will draw the battery level on the display.
@ingroup LittleFootFunctions-Graphics
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void displayBatteryLevel(); void displayBatteryLevel();
/** Clears the display and sets all the LEDs to black.
@ingroup LittleFootFunctions-Graphics
*/
/** Clears the display and sets all the LEDs to black. */
void clearDisplay(); void clearDisplay();
/** Clears the display and sets all the LEDs to a specified colour. /** Clears the display and sets all the LEDs to a specified colour.
@param rgb the colour to use (0xff...) @param rgb the colour to use (0xff...)
@ingroup LittleFootFunctions-Graphics
*/ */
void clearDisplay (int rgb); void clearDisplay (int rgb);
@@ -497,8 +367,6 @@ void clearDisplay (int rgb);
@param rgb the colour to use (0xff...) @param rgb the colour to use (0xff...)
@param x the x coordinate of the pixel to fill @param x the x coordinate of the pixel to fill
@param y the y coordinate of the pixel to fill @param y the y coordinate of the pixel to fill
@ingroup LittleFootFunctions-Graphics
*/ */
void fillPixel (int rgb, int x, int y); void fillPixel (int rgb, int x, int y);
@@ -507,8 +375,6 @@ void fillPixel (int rgb, int x, int y);
@param argb the colour to use @param argb the colour to use
@param x the x coordinate of the pixel to blend @param x the x coordinate of the pixel to blend
@param y the y coordinate of the pixel to blend @param y the y coordinate of the pixel to blend
@ingroup LittleFootFunctions-Graphics
*/ */
void blendPixel (int argb, int x, int y); void blendPixel (int argb, int x, int y);
@@ -519,8 +385,6 @@ void blendPixel (int argb, int x, int y);
@param y the y coordinate of the rectangle to draw @param y the y coordinate of the rectangle to draw
@param width the width of the rectangle to draw @param width the width of the rectangle to draw
@param height the height of the rectangle to draw @param height the height of the rectangle to draw
@ingroup LittleFootFunctions-Graphics
*/ */
void fillRect (int rgb, int x, int y, int width, int height); void fillRect (int rgb, int x, int y, int width, int height);
@@ -531,8 +395,6 @@ void fillRect (int rgb, int x, int y, int width, int height);
@param y the y coordinate of the rectangle to blend @param y the y coordinate of the rectangle to blend
@param width the width of the rectangle to blend @param width the width of the rectangle to blend
@param height the height of the rectangle to blend @param height the height of the rectangle to blend
@ingroup LittleFootFunctions-Graphics
*/ */
void blendRect (int argb, int x, int y, int width, int height); void blendRect (int argb, int x, int y, int width, int height);
@@ -546,8 +408,6 @@ void blendRect (int argb, int x, int y, int width, int height);
@param y the y coordinate of the rectangle @param y the y coordinate of the rectangle
@param width the width of the rectangle @param width the width of the rectangle
@param height the height of the rectangle @param height the height of the rectangle
@ingroup LittleFootFunctions-Graphics
*/ */
void blendGradientRect (int colourNW, int colourNE, int colourSE, int colourSW, int x, int y, int width, int height); void blendGradientRect (int colourNW, int colourNE, int colourSE, int colourSW, int x, int y, int width, int height);
@@ -559,8 +419,6 @@ void blendGradientRect (int colourNW, int colourNE, int colourSE, int colourSW,
@param radius the radius of the circle in block units @param radius the radius of the circle in block units
@param fill if true then the circle will be filled, if false the circle will be an outline @param fill if true then the circle will be filled, if false the circle will be an outline
@ingroup LittleFootFunctions-Graphics
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void blendCircle (int argb, float xCentre, float yCentre, float radius, bool fill); void blendCircle (int argb, float xCentre, float yCentre, float radius, bool fill);
@@ -571,8 +429,6 @@ void blendCircle (int argb, float xCentre, float yCentre, float radius, bool fil
@param colour the colour to use @param colour the colour to use
@param x the x coordinate to use @param x the x coordinate to use
@param y the y coordinate to use @param y the y coordinate to use
@ingroup LittleFootFunctions-Graphics
*/ */
void drawNumber (int value, int colour, int x, int y); void drawNumber (int value, int colour, int x, int y);
@@ -580,8 +436,6 @@ void drawNumber (int value, int colour, int x, int y);
@returns The firmware version of the form 0xMJMIRV (where MJ = Major, MI = Minor, RV = Revision) @returns The firmware version of the form 0xMJMIRV (where MJ = Major, MI = Minor, RV = Revision)
@ingroup LittleFootFunctions-Utility
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getFirmwareVersion(); int getFirmwareVersion();
@@ -590,8 +444,6 @@ int getFirmwareVersion();
@returns the battery level of this block, between 0 and 1.0. @returns the battery level of this block, between 0 and 1.0.
@ingroup LittleFootFunctions-Power
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
float getBatteryLevel(); float getBatteryLevel();
@@ -600,24 +452,18 @@ float getBatteryLevel();
@returns true if this block's battery is charging @returns true if this block's battery is charging
@ingroup LittleFootFunctions-Power
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
bool isBatteryCharging(); bool isBatteryCharging();
/** Sets whether status overlays should be displayed on this block. /** Sets whether status overlays should be displayed on this block.
@ingroup LittleFootFunctions-Utility
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setStatusOverlayActive (bool active); void setStatusOverlayActive (bool active);
/** Sets whether power saving mode should be enabled on this block. /** Sets whether power saving mode should be enabled on this block.
@ingroup LittleFootFunctions-Power
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setPowerSavingEnabled (bool enabled); void setPowerSavingEnabled (bool enabled);
@@ -626,8 +472,6 @@ void setPowerSavingEnabled (bool enabled);
@returns an enum indicating the type of block @see Block::Type @returns an enum indicating the type of block @see Block::Type
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getBlockTypeForID (int blockID); int getBlockTypeForID (int blockID);
@@ -639,8 +483,6 @@ int getBlockTypeForID (int blockID);
@param param1 the first chunk of data to send @param param1 the first chunk of data to send
@param param2 the second chunk of data to send @param param2 the second chunk of data to send
@param param3 the third chunk of data to send @param param3 the third chunk of data to send
@ingroup LittleFootFunctions-Messaging
*/ */
void sendMessageToBlock (int blockID, int param1, int param2, int param3); void sendMessageToBlock (int blockID, int param1, int param2, int param3);
@@ -650,8 +492,6 @@ void sendMessageToBlock (int blockID, int param1, int param2, int param3);
@param param1 the first chunk of data to send @param param1 the first chunk of data to send
@param param2 the second chunk of data to send @param param2 the second chunk of data to send
@param param3 the third chunk of data to send @param param3 the third chunk of data to send
@ingroup LittleFootFunctions-Messaging
*/ */
void sendMessageToHost (int param1, int param2, int param3); void sendMessageToHost (int param1, int param2, int param3);
@@ -661,27 +501,19 @@ void sendMessageToHost (int param1, int param2, int param3);
@param touchX the x position of the touch in block units @param touchX the x position of the touch in block units
@param touchY the y position of the touch in block units @param touchY the y position of the touch in block units
@param touchZ the pressure value of the touch @param touchZ the pressure value of the touch
@ingroup LittleFootFunctions-Lightpad
*/ */
void addPressurePoint (int argb, float touchX, float touchY, float touchZ); void addPressurePoint (int argb, float touchX, float touchY, float touchZ);
/** Draws the pressure map on the display.
@ingroup LittleFootFunctions-Lightpad
*/
/** Draws the pressure map on the display. */
void drawPressureMap(); void drawPressureMap();
/** Fades the pressure map on the display.
@ingroup LittleFootFunctions-Lightpad
*/
/** Fades the pressure map on the display. */
void fadePressureMap(); void fadePressureMap();
/** Links a another block to this control block. /** Links a another block to this control block.
@param blockID the ID of the block to link @param blockID the ID of the block to link
@ingroup LittleFootFunctions-ControlBlock
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
@note Only valid with a control block @note Only valid with a control block
*/ */
@@ -689,8 +521,6 @@ void linkBlockIDtoController (int blockID);
/** Repaints the control block display. /** Repaints the control block display.
@ingroup LittleFootFunctions-ControlBlock
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
@note Only valid with a control block @note Only valid with a control block
*/ */
@@ -708,8 +538,6 @@ void repaintControl();
@param onColourToUse the colour to use when this button is on @param onColourToUse the colour to use when this button is on
@param offColourToUse the colour to use when this button is off @param offColourToUse the colour to use when this button is off
@ingroup LittleFootFunctions-ControlBlock
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
@note Only valid with a control block @note Only valid with a control block
*/ */
@@ -719,8 +547,6 @@ void initControl (int buttonIndex, int modeToUse, int outputType, int val, int m
/** Control type for use with initControl /** Control type for use with initControl
@see initControl @see initControl
@ingroup LittleFootFunctions-ControlBlock
*/ */
enum ControlType enum ControlType
{ {
@@ -732,8 +558,6 @@ enum ControlType
/** Control mode for use with initControl /** Control mode for use with initControl
@see initControl @see initControl
@ingroup LittleFootFunctions-ControlBlock
*/ */
enum ControlMode enum ControlMode
{ {
@@ -750,15 +574,12 @@ enum ControlMode
@param touchIndex the index of the touch event @param touchIndex the index of the touch event
@ingroup LittleFootFunctions-Seaboard
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
@note Only valid on a Seaboard @note Only valid on a Seaboard
*/ */
void handleTouchAsSeaboard (int touchIndex); void handleTouchAsSeaboard (int touchIndex);
/** Returns the number of blocks in the current topology. /** Returns the number of blocks in the current topology.
@ingroup LittleFootFunctions-Topology
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
@@ -769,8 +590,6 @@ int getNumBlocksInTopology();
@param index The index of the block to find in the topology @param index The index of the block to find in the topology
@returns int The id of the block @returns int The id of the block
@ingroup LittleFootFunctions-Topology
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getBlockIDForIndex (int index); int getBlockIDForIndex (int index);
@@ -778,8 +597,6 @@ int getBlockIDForIndex (int index);
/** Returns true if this block is directly connected to the host, /** Returns true if this block is directly connected to the host,
as opposed to only being connected to a different block via a connection port. as opposed to only being connected to a different block via a connection port.
@ingroup LittleFootFunctions-Topology
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
bool isMasterBlock(); bool isMasterBlock();
@@ -787,14 +604,11 @@ bool isMasterBlock();
/** Returns true if this block is connected to the host computer, this can be /** Returns true if this block is connected to the host computer, this can be
directly or through connections to other blocks. directly or through connections to other blocks.
@ingroup LittleFootFunctions-Topology
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
bool isConnectedToHost(); bool isConnectedToHost();
/** Returns the ID of a block connected to a specified port on this block. /** Returns the ID of a block connected to a specified port on this block.
@ingroup LittleFootFunctions-Topology
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
@@ -806,42 +620,35 @@ int getBlockIDOnPort (int port);
@returns the port number that is connected to the master block. Returns 0xFF if there is @returns the port number that is connected to the master block. Returns 0xFF if there is
no port connected to master. no port connected to master.
@ingroup LittleFootFunctions-Topology
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getPortToMaster(); int getPortToMaster();
/** Returns the horizontal distance between this block and the master block in block units. /** Returns the horizontal distance between this block and the master block in block units.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getHorizontalDistFromMaster(); int getHorizontalDistFromMaster();
/** Returns the vertical distance between this block and the master block in block units. /** Returns the vertical distance between this block and the master block in block units.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getVerticalDistFromMaster(); int getVerticalDistFromMaster();
/** Returns the angle of this block relative to the master block in degrees. /** Returns the angle of this block relative to the master block in degrees.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getAngleFromMaster(); int getAngleFromMaster();
/** Sets whether this block should auto-rotate when its angle relative to the master block changes. /** Sets whether this block should auto-rotate when its angle relative to the master block changes.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setAutoRotate (bool enabled); void setAutoRotate (bool enabled);
/** Returns the index of this block in the current cluster. /** Returns the index of this block in the current cluster.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
@@ -851,8 +658,6 @@ int getClusterIndex();
@returns the width of the cluster (note that a single block will return 1 here) @returns the width of the cluster (note that a single block will return 1 here)
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getClusterWidth(); int getClusterWidth();
@@ -861,8 +666,6 @@ int getClusterWidth();
@returns the height of the cluster (note that a single block will return 1 here) @returns the height of the cluster (note that a single block will return 1 here)
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getClusterHeight(); int getClusterHeight();
@@ -871,8 +674,6 @@ int getClusterHeight();
@returns int The cluster x position. (0, 0) is considered to be the top left block @returns int The cluster x position. (0, 0) is considered to be the top left block
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getClusterXpos(); int getClusterXpos();
@@ -881,8 +682,6 @@ int getClusterXpos();
@returns int The cluster x position. (0, 0) is considered to be the top left block @returns int The cluster x position. (0, 0) is considered to be the top left block
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getClusterYpos(); int getClusterYpos();
@@ -891,8 +690,6 @@ int getClusterYpos();
@returns the number of blocks in the current cluster. @returns the number of blocks in the current cluster.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getNumBlocksInCurrentCluster(); int getNumBlocksInCurrentCluster();
@@ -901,14 +698,11 @@ int getNumBlocksInCurrentCluster();
@param index the cluster index of the block to get the ID of @param index the cluster index of the block to get the ID of
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getBlockIdForBlockInCluster (int index); int getBlockIdForBlockInCluster (int index);
/** Returns true if the master block is in the current cluster. /** Returns true if the master block is in the current cluster.
@ingroup LittleFootFunctions-Clustering
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
@@ -918,8 +712,6 @@ bool isMasterInCurrentCluster();
@param item the config item to get (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h) @param item the config item to get (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h)
@ingroup LittleFootFunctions-Configs
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
int getLocalConfig (int item); int getLocalConfig (int item);
@@ -929,8 +721,6 @@ int getLocalConfig (int item);
@param item the config item to set the value of (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h) @param item the config item to set the value of (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h)
@param value the value to set the config to @param value the value to set the config to
@ingroup LittleFootFunctions-Configs
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setLocalConfig (int item, int value); void setLocalConfig (int item, int value);
@@ -940,8 +730,6 @@ void setLocalConfig (int item, int value);
@param longAddress the address of the remote block @param longAddress the address of the remote block
@param item the config item (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h) @param item the config item (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h)
@ingroup LittleFootFunctions-Configs
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void requestRemoteConfig (int longAddress, int item); void requestRemoteConfig (int longAddress, int item);
@@ -952,8 +740,6 @@ void requestRemoteConfig (int longAddress, int item);
@param item the config item (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h) @param item the config item (see ConfigItemId enum in juce_BlocksProtocolDefinitions.h)
@param value the value to set the config to @param value the value to set the config to
@ingroup LittleFootFunctions-Configs
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setRemoteConfig (int longAddress, int item, int value); void setRemoteConfig (int longAddress, int item, int value);
@@ -964,8 +750,6 @@ void setRemoteConfig (int longAddress, int item, int value);
@param min the minimum value this config item should use @param min the minimum value this config item should use
@param max the maximum value this config item should use @param max the maximum value this config item should use
@ingroup LittleFootFunctions-Configs
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setLocalConfigItemRange (int item, int min, int max); void setLocalConfigItemRange (int item, int min, int max);
@@ -976,10 +760,6 @@ void setLocalConfigItemRange (int item, int min, int max);
@param isActive sets whether the config should be active or not @param isActive sets whether the config should be active or not
@param saveToFlash if true then this config item will be saved to the flash memory of the block @param saveToFlash if true then this config item will be saved to the flash memory of the block
@ingroup LittleFootFunctions-Configs
@note Requires >= 0.2.5 firmware @note Requires >= 0.2.5 firmware
*/ */
void setLocalConfigActiveState (int item, bool isActive, bool saveToFlash); void setLocalConfigActiveState (int item, bool isActive, bool saveToFlash);
/** @} */

Loading…
Cancel
Save