Differences

This shows you the differences between two versions of the page.

--- en:getslice [2016/08/12 13:07]
admin
+++ en:getslice [2016/09/08 12:08]
admin
@@ Line 3: / Line 3: @@
 getslice([[numericexpressions|x_position]], [[numericexpressions|y_position]], [[numericexpressions|width]], [[numericexpressions|height]])
-returns [[stringexpressions|string_expression]]
+returns [[arrays|array]]
 ==== Description ====
-Return a string that contains a Hexadecimal (base 16) representation of the rectangle defined by the parameters.  String is formatted as first 4 bytes - width, next 4 bytes - height, 6 bytes for each pixel (width * height).
+Return a 2 dimensional array of the pixels in the rectangle defined by the parameters.
 ==== Example ====
 <code>
-color 16-1
+clg
+color red
 plot 1,1
-color 16^2-1
+color green
 plot 1,2
-color 16^3-1
+color blue
 plot 2,1
-color 16^4-1
+color yellow
 plot 2,2
-print getslice(1, 1, 2, 2)
+vals = getslice(1, 1, 2, 3)
+for rows = 0 to 2
+  for cols = 0 to 1
+    print "("+rows+","+cols+")="+vals[rows,cols]
+  next cols
+next rows
 </code>
 displays
 <code>
-0002000200000f000fff0000ff00ffff
+(0,0)=-65536
+(0,1)=-16776961
+(1,0)=-16711936
+(1,1)=-256
+(2,0)=0
+(2,1)=0
 </code>
@@ Line 30: / Line 44: @@
 ==== New To Version ====
 .9.6b
+==== History ====
+|0.9.6b|New To Version|
+|1.99.99.65|Changed return value to a 2 dimensional array of pixel values|

DokuWiki