Sound.SC3.Server.Status

Request and display status information from the synthesis server.

/status messages receive /status.reply messages.

/g_queryTree messages recieve /g_queryTree.reply messages.

Status

extractStatusField :: Floating n => Int -> [Datum] -> n

Get nth field of /status.reply message as Floating.

statusFields :: [String]

Names of status.reply fields sent in reply to status request.

statusFormat :: [Datum] -> [String]

Status pretty printer.

status_format_concise :: [Datum] -> String

Concise pretty printer, one line, omits PEAK-CPU and NOMINAL-SR.

Query Group

type Query_Ctl = (Either String Int, Either Double Int)

Name or index and value or bus mapping.

data Query_Node

Nodes are either groups of synths.

Constructors

Query_Group Group_Id [Query_Node]

Query_Synth Synth_Id String (Maybe [Query_Ctl])

Instances

Eq Query_Node

Defined in Sound.SC3.Server.Status

Methods

(==) :: Query_Node -> Query_Node -> Bool

(/=) :: Query_Node -> Query_Node -> Bool

Show Query_Node

Defined in Sound.SC3.Server.Status

Methods

showsPrec :: Int -> Query_Node -> ShowS

show :: Query_Node -> String

showList :: [Query_Node] -> ShowS

query_ctl_pp :: Query_Ctl -> String

Pretty-print Query_Ctl

query_node_pp :: Query_Node -> String

Pretty-print Query_Node

queryTree_ctl :: (Datum, Datum) -> Query_Ctl

Control (parameter) data may be given as names or indices and as values or bus mappings.

queryTree_ctl (string "freq",float 440) == (Left "freq",Left 440.0)
queryTree_ctl (int32 1,string "c0") == (Right 1,Right 0)

queryTree_synth :: Bool -> Synth_Id -> String -> [Datum] -> (Query_Node, [Datum])

If rc is True then Query_Ctl data is expected (ie. flag was set at /g_queryTree). k is the synth-id, and nm the name.

let d = [int32 1,string "freq",float 440]
in queryTree_synth True 1000 "saw" d

queryTree_group :: Bool -> Group_Id -> Int -> [Datum] -> (Query_Node, [Datum])

Generate Query_Node for indicated Group_Id.

queryTree_child :: Bool -> [Datum] -> (Query_Node, [Datum])

Either queryTree_synth or queryTree_group.

queryTree :: [Datum] -> Query_Node

Parse result of ' g_queryTree '.

queryNode_to_group_seq :: Query_Node -> [Group_Id]

Extact sequence of Group_Ids from Query_Node.

queryTree_rt :: Query_Node -> Tree Query_Node

Transform Query_Node to Tree.