git.gag.com Git - debian/gnuradio/blob - grc/blocks/parameter.xml

   1 <?xml version="1.0"?>
   2 <!--
   3 ###################################################
   4 ##Parameter block: a grc variable with key, value
   5 ###################################################
   6  -->
   7 <block>
   8         <name>Parameter</name>
   9         <key>parameter</key>
  10         <var_make>self.$(id) = $(id)</var_make>
  11         <make>$value</make>
  12         <param>
  13                 <name>Label</name>
  14                 <key>label</key>
  15                 <value></value>
  16                 <type>string</type>
  17                 <hide>#if $label() then 'none' else 'part'#</hide>
  18         </param>
  19         <param>
  20                 <name>Value</name>
  21                 <key>value</key>
  22                 <value>0</value>
  23                 <type>$type.type</type>
  24         </param>
  25         <param>
  26                 <name>Type</name>
  27                 <key>type</key>
  28                 <value></value>
  29                 <type>enum</type>
  30                 <hide>#if $type() then 'none' else 'part'#</hide>
  31                 <option>
  32                         <name>None</name>
  33                         <key></key>
  34                         <opt>type:raw</opt>
  35                 </option>
  36                 <option>
  37                         <name>Complex</name>
  38                         <key>complex</key>
  39                         <opt>type:complex</opt>
  40                 </option>
  41                 <option>
  42                         <name>Float</name>
  43                         <key>eng_float</key>
  44                         <opt>type:real</opt>
  45                 </option>
  46                 <option>
  47                         <name>Int</name>
  48                         <key>intx</key>
  49                         <opt>type:int</opt>
  50                 </option>
  51                 <option>
  52                         <name>Long</name>
  53                         <key>long</key>
  54                         <opt>type:int</opt>
  55                 </option>
  56                 <option>
  57                         <name>String</name>
  58                         <key>string</key>
  59                         <opt>type:string</opt>
  60                 </option>
  61                 <!-- not supported yet in tmpl
  62                 <option>
  63                         <name>Boolean</name>
  64                         <key>bool</key>
  65                         <opt>type:bool</opt>
  66                 </option>
  67                 -->
  68         </param>
  69         <param>
  70                 <name>Short ID</name>
  71                 <key>short_id</key>
  72                 <value></value>
  73                 <type>string</type>
  74                 <hide>#if not $type()
  75 all#slurp
  76 #elif $short_id()
  77 none#slurp
  78 #else
  79 part#slurp
  80 #end if</hide>
  81         </param>
  82         <check>len($short_id) in (0, 1)</check>
  83         <check>$short_id == '' or $(short_id).isalpha()</check>
  84         <doc>
  85 This block represents a parameter to the flow graph. \
  86 A parameter can be used to pass command line arguments into a top block. \
  87 Or, parameters can pass arguments into an instantiated hierarchical block.
  88
  89 The paramater value cannot depend on any variables.
  90
  91 Leave the label blank to use the parameter id as the label.
  92
  93 When type is not None, this parameter also becomes a command line option of the form:
  94
  95 -[short_id] --[id] [value]
  96
  97 The Short ID field may be left blank.
  98         </doc>
  99 </block>