You can use this effect to remove any bitplanes of an image. This may not seem to be very useful at the first sight, but you can for example check for the amount of noise in your images by displaying the low pixel bits only.
Bits are numbered so that zero (0) is the least significant bit and seven (7) is the highest significant.
If you didn't understand all this explanation, you probably should read some books about computer graphics in general, as well as about binary numbers.
SYNTAX:
newImg& = ExtractBitfields& (shan&, fields%, scale%, channels$, minX%, minY%, maxX%, maxY%, mask&)
INPUTS:
fields% (INTEGER)
- Any 8-bit mask specifying the bitplanes you wish to keep in the image. For any set bit, the information of the respective bitplane is kept in the image, for any cleared bit the information will be discarded. You may specify this as a binary bit mask directly (eg. &B10110001) or convert it into hex or decimal.
scale% (INTEGER)
- If this flag is set true (<> 0), then the kept information is moved up to the highest possible intensity level (using the discarded bits on the highest significant end of fields% (if any), so basically a left shift of the kept information), which is useful if you extract the low bits only, which would otherwise result in a very dark image.
channels$ (STRING)
- Further specify the component channels to keep. This may be none, one or more of the letters "A", "R", "G" and "B", which specify the channels you wanna keep in the image, the case and order of the letters doesn't matter.
shan&, mask& (LONGs)
minX%, minY%, maxX%, maxY% (INTEGERs)
- See page Common Info.
RESULT:
newImg& (LONG)
- See page Common Info.