Moai SDK  2.0
MOAIStream Class Reference
+ Inheritance diagram for MOAIStream:

Function List

collapse
 
compact
 
flush
 
getCursor
 
getLength
 
read
 
read8
 
read16
 
read32
 
readBoolean
 
readDouble
 
readFloat
 
readFormat
 
readU8
 
readU16
 
readU32
 
seek
 
write
 
write8
 
write16
 
write32
 
writeBoolean
 
writeColor32
 
writeDouble
 
writeFloat
 
writeFormat
 
writeStream
 
writeU8
 
writeU16
 
writeU32
 

Detailed Description

Constants
MOAIStream.SEEK_CUR
MOAIStream.SEEK_END
MOAIStream.SEEK_SET

Function Documentation

collapse

Removes a series of spans from the stream and "collapses" the remainder. Used to remove a series of regularly repeating bytes. For example, if the stream contains vertices and user wishes to remove the vertex normals.


function collapse ( MOAIStream self, number clipBase, number clipSize, number chunkSize [, number size, boolean invert ] )

Parameters
MOAIStreamself
numberclipBase Offset from the cursot to the first clip to remove.
numberclipSize Size of the clip to remove.
numberchunkSize The stride: the next clip will begin at clipBase + chunkSize.
numbersize Optional. The amount of the stream to process. Default is stream.getLength () - stream.getCursor ()
booleaninvert Optional. Inverts the clip. Default value is false.
Returns
number result
compact

If the stream is backed by an internal buffer, and the buffer may be reallocated by the stream, compact () causes the buffer to be reallocated so that it more closely matches the current length of the stream. For streams that are not buffer backer or that may not be reallocated, compact () has no effect.


function compact ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number
flush

Forces any remaining buffered data into the stream.


function flush ( MOAIStream self )

Parameters
MOAIStreamself
Returns
nil
getCursor

Returns the current cursor position in the stream.


function getCursor ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number cursor
getLength

Returns the length of the stream.


function getLength ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number length
read

Reads bytes from the stream.


function read ( MOAIStream self [, number byteCount ] )

Parameters
MOAIStreamself
numberbyteCount Optional. Number of bytes to read. Default value is the length of the stream.
Returns
string bytes, number actualByteCount
read16

Reads a signed 16-bit value from the stream.


function read16 ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
read32

Reads a signed 32-bit value from the stream.


function read32 ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
read8

Reads a signed 8-bit value from the stream.


function read8 ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
readBoolean

Reads an 8-bit boolean value from the stream.


function readBoolean ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
readDouble

Reads a 64-bit floating point value from the stream.


function readDouble ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
readFloat

Reads a 32-bit floating point value from the stream.


function readFloat ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
readFormat

Reads a series of values from the stream given a format string. Valid tokens for the format string are: u8 u16 u32 f d s8 s16 s32. Tokens may be optionally separated by spaces or commas.


function readFormat ( MOAIStream self, string format )

Parameters
MOAIStreamself
stringformat
Returns
..., number size
readU16

Reads an unsigned 16-bit value from the stream.


function readU16 ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
readU32

Reads an unsigned 32-bit value from the stream.


function readU32 ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
readU8

Reads an unsigned 8-bit value from the stream.


function readU8 ( MOAIStream self )

Parameters
MOAIStreamself
Returns
number value, number size
seek

Repositions the cursor in the stream.


function seek ( MOAIStream self [, number offset, number mode ] )

Parameters
MOAIStreamself
numberoffset Optional. Value from the stream. Default value is 0.
numbermode Optional. One of MOAIStream.SEEK_CUR, MOAIStream.SEEK_END, MOAIStream.SEEK_SET. Default value is MOAIStream.SEEK_SET.
Returns
nil
write

Write binary data to the stream.


function write ( MOAIStream self, string bytes [, number size ] )

Parameters
MOAIStreamself
stringbytes Binary data to write.
numbersize Optional. Number of bytes to write. Default value is the size of the string.
Returns
number size
write16

Writes a signed 16-bit value to the stream.


function write16 ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
write32

Writes a signed 32-bit value to the stream.


function write32 ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
write8

Writes a signed 8-bit value to the stream.


function write8 ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
writeBoolean

Writes an 8-bit boolean value to the stream.


function writeBoolean ( MOAIStream self, boolean value )

Parameters
MOAIStreamself
booleanvalue Value to write.
Returns
number size
writeColor32

Write a packed 32-bit color to the vertex buffer.


function writeColor32 ( MOAIStream self [, number r, number g, number b, number a ] )

Parameters
MOAIStreamself
numberr Optional. Default value is 1.
numberg Optional. Default value is 1.
numberb Optional. Default value is 1.
numbera Optional. Default value is 1.
Returns
nil
writeDouble

Writes a 64-bit floating point value to the stream.


function writeDouble ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
writeFloat

Writes a 32-bit floating point value to the stream.


function writeFloat ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
writeFormat

Writes a series of values to the stream given a format string. See 'readFormat' for a list of valid format tokens.


function writeFormat ( MOAIStream self, string format, ... )

Parameters
MOAIStreamself
stringformat
...values Values to be written to the stream.
Returns
number size
writeStream

Reads bytes from the given stream into the calling stream.


function writeStream ( MOAIStream self, MOAIStream stream [, number size ] )

Parameters
MOAIStreamself
MOAIStreamstream Value to write.
numbersize Optional. Number of bytes to read/write. Default value is the length of the input stream.
Returns
number size
writeU16

Writes an unsigned 16-bit value to the stream.


function writeU16 ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
writeU32

Writes an unsigned 32-bit value to the stream.


function writeU32 ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size
writeU8

Writes an unsigned 8-bit value to the stream.


function writeU8 ( MOAIStream self, number value )

Parameters
MOAIStreamself
numbervalue Value to write.
Returns
number size