Defines a type for use with the put function using a table describing the type's properties. The sim uses the properties.name field to identify and create objects of the defined type so this field is required and must be unique. Puts an object of type in the sim at x,y and returns a handle which can be used to retrieve an interface to the object. Position 0,0 is located at the upper left hand corder of the sim and default view. Retrieves an object using handle which can use the ':' operator to call its methods. Loads a .png image at path with optional flags and returns a numeric texture id which can be used anywhere a texture is expected. Images of even sizes generally work better for textures. Only RGB and RGBA formats are currently supported. Receives an array of textures starting at element [1], and links them together in an animation. Returns the first texture in the array which can be used anywhere a texture is expected. Animate works by linking textures. To create a looping texture, set the last texture in the array to the first (or any previous) texture. Also note that a texture has only 1 link. Returns the system uptime in msecs (.001 secs). Executes a function in msecs. Function should take a data table and return no values. Executes a function when event is generated by input. Event will be ON_UP, ON_DOWN, ON_MOVE or ON_DRAG. Input is the id of the input. For a standard mouse/keyboard platform the primary mouse button will be zero, keyboard buttons will correspond to their ascii equivalent. System keys may vary between platform but KEY_UP, KEY_LEFT, KEY_RIGHT, and KEY_DOWN variables are provided for consistent access to arrow keys across platforms. The string.byte function will provide the input number for keys in many cases. On move may not be available on some platforms (e.g. touch screen devices). Loads a .wav sound at path and returns the mixer channel it was loaded to which can be used in mixer functions. If optional second argument loop is set to true the sound will be looped. Only uncompressed 8 and 16 bit wav files are currently supported. The name of and primary means of identifying a type. This field is required and must be unique. The name of the type's parent. If extends is set, any fields left unset will default to the value of the parent's field. The physics model of the type 'active', 'static', or 'passive'. Active objects are affected by all of the sim's forces, static objects generate collisions but are not affected by gravity. Passive objects do not generate collisions and are not effected by gravity but can still respond to contact, touch, etc. This field is required. The shape of the type 'circle', 'rectangle', 'polygon' or 'line'. This field is required and rectangles must define width and height fields, circles must define a radius field, polygons and lines must define a verts field. Objects of shape 'line' default to a static model and do not generate collisions with other lines. X, Y offset to place a shape on its rigid body (defaults to 0,0). The radius of a circle type. The width of a rectangle type. The height of a rectangle type. In the case of polygons verts is an array of numbers which define a convex hull with a counterclockwise winding. In the case of lines verts defines an arrangement of sequential line segments. A numeric texture Id retrieved from an image loader function. This texture will be an object's default texture when it is created. X, Y offset to draw textures to a view (defaults to 0,0). X, Y offset to draw textures based on a view's focus (defaults to 1,1). This is only available for passive objects and is used to give the illusion of depth for background textures. The mass of the type. Mass is only relevant to objects using an active model. Static and passive objects always have infinite mass. The elasticity of the type in the range of 0.0 - 1.0 A value of 0 will produce no bounce and a value of 1 will produce a perfect bounce. The friction coefficient of the type in the range of 0.0 - 1.0. A value of 0.0 is frictionless The maximum x and y speed the type can move. This defaults to a number high enough to be non-restrictive in most cases. Fixed objects do not rotate. This defaults to false. A lua table containing key/value pairs for user variables. If defined, this function will determine if the object self will produce a collision with the other object when they contact each other. If the contact should produce a collision this function should return true, otherwise it should return false. This function will be called VERY OFTEN so it should be optimized or used sparingly. An event handler function triggered when an object is created with put(). An event handler function triggered when an object leaves the area defined by space.setsize(). An event handler function triggered when an object arrives at a point set by movesto(). An event handler function triggered when an object is no longer in contact with other objects. An event handler function triggered when an object has contacted another object. An event handler function triggered when an object has been touched by a user. An event handler function triggered when an object is no longer touched by a user. An event handler function triggered when an object is destroyed. Use with caution. Returns the object's type. Returns the object's shape. Returns a table describing object's model. The model field of the table contains the name of the model. If the model is 'active', mass, inertia, elastic and friction will be returned. If the model is 'static', elastic and friction will be returned. Returns the coordinates of an object. Sets the coordinates of an object to x,y. Returns the texture ID of an object or zero for none. Sets the texture of an object to tex. Returns the rotation of an object. Sets the rotation of an object. Returns the speed of a moving object. Returns the direction of a moving object. Returns the distance between an object's center and a point. Returns the angle between an object's center and a point. Move the object at speed towards angle. Moves the object at speed towards angle until stop or the moves function is called. If a target has been set with movesto it will be removed. Moves the object at speed towards x,y until stop or moves is called, another target is set, or the object arrives at the target. If an event handler for onarrive is set for the object, that handler will be called when the object reaches point x,y. Stops a moving object and clears any target set with movesto. Set a user defined instance variable which was declared in type.vars. Get a user defined instance variable which was declared in type.vars. Returns an array of handles for objects which are currently in contact with the self object. Deletes an object. Sets the sim's horizontal and vertical gravity to x,y. Returns the sim's gravity. Sets the sim's contact persistance to cp. Returns the sim's contact persistance. Sets the sim's viscous damping. Expects a floating point in the range of 0.0 - 1.0 Returns the sim's viscous damping. Sets the size of the sim's hash cells. Setting dim to the average objects size is likely to give the best performance. Returns the size of the sim's hash cells. Sets size and number of steps the sim will take per cycle. A higher step size will result in more accurate simulation but slower processing. Returns size and number of steps the sim will take per cycle. Sets the size of the sim to width and height. This function is closely related to the onleave event handler which is triggered when an object leaves the sims boundaries. Returns the size of the sim. Passing true to degrees will cause the sim to take and return all angles in degrees. Radians are used by default and used if false is passed to degrees. Degrees can be converted to radians using Lua's math.rad function and radians can be converted to degrees using the math.deg function. The Lua's trigonometry functions (math.sin, math.cos, etc.) take and return radians. Connects two objects with a pin joint. The joint is described in a data table which must contain handle1 and handle2 fields to the respective objects. The table may also contain offx1, offy1, offx2, offy2 fields which define the offset of the joint. The defaults of these fields is zero. The join and unjoin functions may be depreciated as the underlying physics engine moves towards a more flexible concept of constraints. Removes a joint. Queries the sim and returns a table of resulting object handles. Arguments may be x and y which returns handles to any object containing that point or a type name which returns handles for any object of that type. If no arguments are passed query will return a handle to every object in the sim. If the optional type argument is used, count returns the number of objects of that type in the sim. Otherwise, count returns the total number of objects in the sim. Pauses or un-pauses the sim. Returns true if the sim is paused or false if not. Frees all of the objects in the sim. If types is true, also removes all declared types. Returns the size of the view. Sets view's pan to x, y. Also removes objects from focus. Returns the current pan of the view. Returns the object in focus or nil if no object has focus. Sets the view's focus to object following any of the object's movement. Returns the view's background color. Color values range from 0 to 255 Sets the view's background color. Color values range from 0 to 255 Takes a table containing the properties of a GUI control and returns a control object defined by those properties. The text displayed by the control. The font the control uses to display text. This is an ASCII bitmap font texture which contians all 128 characters in eight rows equally spaced from each other and aligned to the center of the cell. If set to true font characters will be drawn in monospace. The default is false. The x position of the control. The y position of the control. The background texture for the control. The width of the control. Must be wider than the width of the text. The height of the control. Must be wider than the width of the text. Resizes the control if text width exceeds current width. The default is true. Left margin of text. Top margin of text. Right margin of text. Bottom margin of text. A function which is called when the control is touched. A function which is called when a touch is released while over the control. A function which is called when a touch leaves the area of a control while the control is touched. Returns the control's text. Sets the control's text. Returns the color of the control's text. Color values range from 0 to 255 Sets the color of the control's text. Color values range from 0 to 255 Returns the texture used for the control's background. Sets the texture used for the control's background. Returns the margins in a table with keys 'right', 'left', 'top', and 'bottom'. Sets the margins in a table with keys 'right', 'left', 'top', and 'bottom'. Returns true if the control is hidden and false if it is not hidden. Hides the control. If a control is hidden it will not respond to touches. Shows a hidden control. Returns true if the sound loaded to channel is playing. Plays the sound loaded to channel. If the optional oncomplete is passed this function will be called when the sound completes playing. oncomplete can not be used with looped sounds. Stops the sound loaded to channel. Returns the gain (loudness) of channel. Sets the gain (loudness) of channel. Returns the length of the sound loaded to channel. Receives any number of arguments, and prints their values to stdout. The print implementation in Physle also pipes stdout to the view buffer so it displays in the Physle view. As of version 3.2._ arguments must be of type string or number. Tables and functions will not have tostring() called on them by default. Loads and executes a Lua file at path. Receives an argument of any type and converts it to a string in a reasonable format. Tries to convert value to a number with an optional base defaulting to 10. In bases above 10 letters are used to represent number above 9. Returns the type of value as a string. The possible results of this function are 'nil', 'number', 'string', 'boolean', 'table', 'function', 'userdata'. Iterates over all key-value pairs of table using for..in. E.g. for k,v in pairs(t) do ... end. Iterates over all index-value pairs of table using for..in. E.g. for i,v in ipairs(t) do ... end. Given an array where all elements are strings or numbers, concat returns all values in a single string seperated by sep. Optionally concat will take the index i to start and the index j on which to stop. The default for i is 1 and the defualt for j is the length of the array Inserts value at optional position pos in table, shifting up other elements to open space, if necessary. The default value for pos is n+1, where n is the length of the table. This function is unusual in that the optional argument pos is not at the end of the argument list. Returns the largest positive numerical index of the given table, or zero if the table has no positive numerical indices. Removes from table the element at position pos, shifting down other elements to close the space, if necessary. Returns the value of the removed element. Sorts table elements using the compare function. The compare function must be a function that receives two table elements, and returns true when the first is less than the second. A number larger than or equal to any other numerical value. Pi. Returns the absolute value of signed number. Returns the arc cosine of number (in radians). Returns the arc sine of number (in radians). Returns the arc tangent of number (in radians). Returns the arc tangent of y/x (in radians), but uses the signs of both parameters to find the quadrant of the result. (It also handles correctly the case of x being zero.) Returns the smallest integer larger than or equal to the floating point number float. Returns the cosine of number (in radians). Returns the hyperbolic cosine of number (in radians). Returns the angle given in radians, in degrees. Returns the exp of number. Returns the largest integer smaller than or equal to the floating point number float. Returns the remainder of the division of x by y that rounds the quotient towards zero. Returns the frexp of number. Returns the ldexp of number. Returns the natural logarithm of number. Returns the base-10 logarithm of number. Returns the maximum value among its arguments. Returns the minimum value among its arguments. Returns the integral and the fractional part of number. Returns number^power. Returns the angle given in degrees, in radians. When called without arguments, returns a uniform pseudo-random real number in the range [0,1). When called with an integer number m, math.random returns a uniform pseudo-random integer in the range [1, m]. When called with two integer numbers m and n, math.random returns a uniform pseudo-random integer in the range [m, n]. Sets the "seed" for the pseudo-random generator: equal seeds produce equal sequences of numbers Returns the sine of number (in radians). Returns the hyperbolic sine of number (in radians). Returns the square root of number. Returns the tangent of number (assumed to be in radians). Returns the hyperbolic tangent of number (assumed to be in radians). Returns the internal numerical codes of the character. Numerical codes are not necessarily portable across platforms. Receives zero or more integers. Returns a string with length equal to the number of arguments, in which each character has the internal numerical code equal to its corresponding argument. Numerical codes are not necessarily portable across platforms. Looks for the first match of pattern in the string. If it finds a match, then find returns the indices where this occurrence starts and ends; otherwise, it returns nil. A third, optional numerical argument init specifies where to start the search; its default value is 1 and can be negative. A value of true as a fourth, optional argument plain turns off the pattern matching facilities, so the function does a plain "find substring" operation, with no characters in pattern being considered "magic". If plain is given, then init must be given as well. If the pattern has captures, then in a successful match the captured values are also returned, after the two indices. Returns a formatted version of its variable number of arguments following the description given in its first argument (which must be a string). The format string follows the same rules as the printf family of standard C functions. Returns an iterator function that, each time it is called, returns the next captures from pattern over string. e.g. for w in string.gmatch("hello world", "%a+") do... Returns a copy of string in which occurrences of the pattern have been replaced by a replacement string specified by repl, which can be a string, a table, or a function. gsub also returns, as its second value, the total number of matches that occurred. If the optional one argument is set to true, only the first match will be replaced. Returns the length of string. Receives a string and returns a copy of this string with all uppercase letters changed to lowercase. Looks for the first match of pattern in the string. If it finds one, then match returns the captures from the pattern; otherwise it returns nil. If pattern specifies no captures, then the whole match is returned. A third, optional numerical argument init specifies where to start the search; its default value is 1 and can be negative. Returns a string that is the concatenation of count copies of the string. Returns string reversed. Returns the substring of string that starts at i and continues until j; i and j can be negative. If j is absent, then it is assumed to be equal to -1 (which is the same as the string length). Receives a string and returns a copy of this string with all lowercase letters changed to uppercase