/* * Copyright (c) 2007, Second Life Reverse Engineering Team * All rights reserved. * * - Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * - Redistributions of source code must retain the above copyright notice, this * list of conditions and the following disclaimer. * - Neither the name of the Second Life Reverse Engineering Team nor the names * of its contributors may be used to endorse or promote products derived from * this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. */ using System; namespace libsecondlife { /// /// Wrapper around a byte array that allows bit to be packed and unpacked /// one at a time or by a variable amount. Useful for very tightly packed /// data like LayerData packets /// public class BitPack { /// public byte[] Data; /// public int BytePos { get { if (bytePos != 0 && bitPos == 0) return bytePos - 1; else return bytePos; } } /// public int BitPos { get { return bitPos; } } private const int MAX_BITS = 8; private int bytePos; private int bitPos; private bool weAreBigEndian = !BitConverter.IsLittleEndian; /// /// Default constructor, initialize the bit packer / bit unpacker /// with a byte array and starting position /// /// Byte array to pack bits in to or unpack from /// Starting position in the byte array public BitPack(byte[] data, int pos) { Data = data; bytePos = pos; } /// /// Pack a floating point value in to the data /// /// Floating point value to pack public void PackFloat(float data) { byte[] input = BitConverter.GetBytes(data); if (weAreBigEndian) Array.Reverse(input); PackBitArray(input, 32); } /// /// Pack part or all of an integer in to the data /// /// Integer containing the data to pack /// Number of bits of the integer to pack public void PackBits(int data, int totalCount) { byte[] input = BitConverter.GetBytes(data); if (weAreBigEndian) Array.Reverse(input); PackBitArray(input, totalCount); } /// /// Pack part or all of an unsigned integer in to the data /// /// Unsigned integer containing the data to pack /// Number of bits of the integer to pack public void PackBits(uint data, int totalCount) { byte[] input = BitConverter.GetBytes(data); if (weAreBigEndian) Array.Reverse(input); PackBitArray(input, totalCount); } /// /// /// /// /// /// /// public void PackFixed(float data, bool isSigned, int intBits, int fracBits) { int unsignedBits = intBits + fracBits; int totalBits = unsignedBits; int min, max; if (isSigned) { totalBits++; min = 1 << intBits; min *= -1; } else { min = 0; } max = 1 << intBits; float fixedVal = Helpers.Clamp(data, (float)min, (float)max); if (isSigned) fixedVal += max; fixedVal *= 1 << fracBits; if (totalBits <= 8) PackBits((uint)fixedVal, 8); else if (totalBits <= 16) PackBits((uint)fixedVal, 16); else if (totalBits <= 31) PackBits((uint)fixedVal, 32); else throw new Exception("Can't use fixed point packing for " + totalBits); } /// /// /// /// public void PackUUID(LLUUID data) { byte[] bytes = data.GetBytes(); // Not sure if our PackBitArray function can handle 128-bit byte //arrays, so using this for now for (int i = 0; i < 16; i++) PackBits(bytes[i], 8); } /// /// /// /// public void PackColor(LLColor data) { byte[] bytes = data.GetBytes(); PackBitArray(bytes, 32); } /// /// Unpacking a floating point value from the data /// /// Unpacked floating point value public float UnpackFloat() { byte[] output = UnpackBitsArray(32); if (weAreBigEndian) Array.Reverse(output); return BitConverter.ToSingle(output, 0); } /// /// Unpack a variable number of bits from the data in to integer format /// /// Number of bits to unpack /// An integer containing the unpacked bits /// This function is only useful up to 32 bits public int UnpackBits(int totalCount) { byte[] output = UnpackBitsArray(totalCount); if (weAreBigEndian) Array.Reverse(output); return BitConverter.ToInt32(output, 0); } /// /// Unpack a variable number of bits from the data in to unsigned /// integer format /// /// Number of bits to unpack /// An unsigned integer containing the unpacked bits /// This function is only useful up to 32 bits public uint UnpackUBits(int totalCount) { byte[] output = UnpackBitsArray(totalCount); if (weAreBigEndian) Array.Reverse(output); return BitConverter.ToUInt32(output, 0); } public byte UnpackByte() { byte[] output = UnpackBitsArray(8); return output[0]; } public float UnpackFixed(bool signed, int intBits, int fracBits) { int minVal; int maxVal; int unsignedBits = intBits + fracBits; int totalBits = unsignedBits; float fixedVal; if (signed) { totalBits++; minVal = 1 << intBits; minVal *= -1; } maxVal = 1 << intBits; if (totalBits <= 8) fixedVal = (float)UnpackByte(); else if (totalBits <= 16) fixedVal = (float)UnpackUBits(16); else if (totalBits <= 31) fixedVal = (float)UnpackUBits(32); else return 0.0f; fixedVal /= (float)(1 << fracBits); if (signed) fixedVal -= (float)maxVal; return fixedVal; } public LLUUID UnpackUUID() { if (bitPos != 0) return LLUUID.Zero; LLUUID val = new LLUUID(Data, bytePos); bytePos += 16; return val; } private void PackBitArray(byte[] data, int totalCount) { int count = 0; int curBytePos = 0; int curBitPos = 0; while (totalCount > 0) { if (totalCount > MAX_BITS) { count = MAX_BITS; totalCount -= MAX_BITS; } else { count = totalCount; totalCount = 0; } while (count > 0) { if ((data[curBytePos] & (0x01 << (count - 1))) != 0) Data[bytePos] |= (byte)(0x80 >> bitPos); --count; ++bitPos; ++curBitPos; if (bitPos >= MAX_BITS) { bitPos = 0; ++bytePos; } if (curBitPos >= MAX_BITS) { curBitPos = 0; ++curBytePos; } } } } private byte[] UnpackBitsArray(int totalCount) { int count = 0; byte[] output = new byte[4]; int curBytePos = 0; int curBitPos = 0; while (totalCount > 0) { if (totalCount > MAX_BITS) { count = MAX_BITS; totalCount -= MAX_BITS; } else { count = totalCount; totalCount = 0; } while (count > 0) { // Shift the previous bits output[curBytePos] <<= 1; // Grab one bit if ((Data[bytePos] & (0x80 >> bitPos++)) != 0) ++output[curBytePos]; --count; ++curBitPos; if (bitPos >= MAX_BITS) { bitPos = 0; ++bytePos; } if (curBitPos >= MAX_BITS) { curBitPos = 0; ++curBytePos; } } } return output; } } }