13.07.2015 Views

SAMP — Simple Application Messag- ing Protocol Version 1.11 - IVOA

SAMP — Simple Application Messag- ing Protocol Version 1.11 - IVOA

SAMP — Simple Application Messag- ing Protocol Version 1.11 - IVOA

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

• ::= [ ] [ "e" | "E" [ ] ]A float<strong>ing</strong> point value is encoded as a mantissa with an OPTIONALpreced<strong>ing</strong> sign followed by an OPTIONAL exponent part introducedwith the character “e” or “E”. There is no guarantee about the largestor smallest values which can be represented or about the number ofdigits of precision which are significant, since these will depend on theprocess<strong>ing</strong> environment at decode time.• ::= "0" | "1"A boolean value is represented as an integer: zero represents false, andany other value represents true. 1 is the RECOMMENDED value torepresent true.The numeric types are based on the syntax of the C programm<strong>ing</strong> language,since this syntax forms the basis for typed data syntax in many otherlanguages. There may be extensions to this list in future versions of thisstandard.Particular MType definitions may use these conventions or devise theirown as required. Where the conventions in this list are used, message documentationSHOULD make it clear us<strong>ing</strong> a form of words along the lines “thisparameter contains a <strong>SAMP</strong> int”.3.5 Register<strong>ing</strong> with the HubA client registers with the hub to:1. establish communication with the hub2. advertise its presence to the hub and to other clients3. obtain registration informationThe registration information is in the form of a map contain<strong>ing</strong> data itemswhich the client may wish to use dur<strong>ing</strong> the <strong>SAMP</strong> session. The hub MUSTfill in values for the follow<strong>ing</strong> keys in the returned map:samp.hub-id — The client ID which is used by the hub when it sends messagesitself (rather than forward<strong>ing</strong> them from other senders). For instance,this ID will be used when the hub sends the samp.hub.event.shutdownmessage.samp.self-id — The client ID which identifies the register<strong>ing</strong> client.These keys form part of an extensible vocabulary as explained in Section 2.6.In most cases a client will not require either of the above IDs for normal14

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!