|▪||In a lot of cases, MADRIX Script offers both a pixel-based or a vector-based version of a function.|
|▪||When working with a matrix and pixels, the dimensions of matrix and effects, such as a vertical line, are absolute and adjusted to that particular matrix.|
- For example, you might want to draw a 20x2 horizontal line on a 50x50 matrix.
|▪||However, this can be a disadvantage since you might want to write a macro/script that can be applied to a multitude of matrixes with different sizes or someone else might want to use your script. In this case using relative values can help a lot, since effects are scalable then.|
- For example, the horizontal line should always be of 50% width and 5% height.
- Valid values for relative values range from 0.0 to 1.0.
Rules Of Calling Functions
|▪||Functions of MADRIX Script often tell you what their purpose is and which kind of values they require (absolute or relative).|
|▪||The name of a draw or render function often starts with a description of what it does, like Draw or Fill. It is followed by Pixel or Vector to describe whether the function requires pixel coordinates or relative coordinates. The final part describes the application of the function, like Rect or Line. Here are two examples: |
|▪||FillPixelRect - Draws and fills a rectangle using absolute values|
|▪||DrawVectorCircle - Draws an unfilled circle using relative values|
Using Absolute Coordinates
|▪||Functions with Pixel in their name operate on absolute pixel values. Imagine a rectangle which is drawn from x=5, y=5 with a size of 10. The object will always be rendered starting from 5, 5 to 15, 15, on every matrix. |
- On the one hand, the rectangle appears to be very small on large matrices.
- On the other hand, on small matrices it seems to be a big rectangle because it fills a larger area of the matrix.
Using Relative Coordinates
|▪||Functions with Vector in their name operate on relative values. 0, 0 stands for the upper left corner of the effects matrix. 1, 1 describes its lower right corner, or its whole length and height. |
- A rectangle which is drawn from 0.25 with a size of 0.5 will look the same on every matrix. Its size is simply the half of the matrix size.
- On a matrix with more pixels the rectangle is also drawn with more pixels compared to fewer pixels on a smaller matrix.
- In contrast, the usage of absolute coordinates dictates the utilization of the same amount of pixels.