RLVa / RLV Differences

From Catznip
Revision as of 23:56, 7 January 2014 by Trinity Dejavu (talk | contribs)
Jump to navigation Jump to search
RLVa Logo

RLVa is an alternative implementation and extension to the RLV API by Marine Kelly. RLVa interprets some things a little differently (usually in a less intrusive way) and has a number of extensions above and beyond Marine's specification. This wiki details the RLVa specification as it applies to Catznip, Firestorm and other RLVa Viewers. RLVa has been in majority use since 2009 and is what most users experience as or equate to being RLV even though that refers to a different specification and implementation.

RLVa shares no code with Marine Kelly's RLV implementation and while we're committed to the maintaining functional compatibility to the spirit of her specification we are under no obligation to implement every change or addition. In the same way she is not expected to mirror everything that appears in the RLVa Specification. That said RLVa and RLV have historically followed a very close common path with additions to one ending up in the other and vice versa.

End User Differences

RLVa Developer Differences

Positive Channel Numbers

Many commands require a channel number to be specified in order to relay information from the viewer to script. RLVa requires this to be a positive integer due to differences in LSL message size. Negative channels can only contain strings 256 bytes in length, positive channels can contain up to 1024 bytes.

This is done to prevent RLVa commands appearing to output truncated data for a non obvious reason.