summaryrefslogtreecommitdiff
path: root/grc/data/platforms/python/blocks/options.xml
blob: 82f3090279fa37de97987d7e0b749656503ca4cc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<?xml version="1.0"?>
<!--
###################################################
##Options Block:
## options for window size,
## and flow graph building.
###################################################
 -->
<block>
	<name>Options</name>
	<key>options</key>
	<import>from gnuradio import gr
#if $generate_options() == 'wx_gui'
from grc_gnuradio import wxgui as grc_wxgui
import wx
#end if
#if $generate_options() != 'hb'
from optparse import OptionParser
from gnuradio.eng_option import eng_option
#end if
</import>
	<make></make>
	<param>
		<name>Title</name>
		<key>title</key>
		<value>untitled</value>
		<type>string</type>
	</param>
	<param>
		<name>Author</name>
		<key>author</key>
		<value>unknown</value>
		<type>string</type>
	</param>
	<param>
		<name>Description</name>
		<key>description</key>
		<value>gnuradio flow graph</value>
		<type>string</type>
	</param>
	<param>
		<name>Window Size</name>
		<key>window_size</key>
		<value>1280, 1024</value>
		<type>int_vector</type>
		<hide>part</hide>
	</param>
	<param>
		<name>Generate Options</name>
		<key>generate_options</key>
		<value>wx_gui</value>
		<type>enum</type>
		<option>
			<name>WX GUI</name>
			<key>wx_gui</key>
		</option>
		<option>
			<name>No GUI</name>
			<key>no_gui</key>
		</option>
		<option>
			<name>Hier Block</name>
			<key>hb</key>
		</option>
	</param>
	<param>
		<name>Category</name>
		<key>category</key>
		<value>Custom</value>
		<type>string</type>
		<hide>#if $generate_options() == 'hb' then 'none' else 'all'#</hide>
	</param>
	<param>
		<name>Realtime Scheduling</name>
		<key>realtime_scheduling</key>
		<value></value>
		<type>enum</type>
		<hide>#if $generate_options() == 'hb'
all#slurp
#elif $realtime_scheduling()
none#slurp
#else
part#slurp
#end if</hide>
		<option>
			<name>Off</name>
			<key></key>
		</option>
		<option>
			<name>On</name>
			<key>1</key>
		</option>
	</param>
	<check>len($window_size) == 2</check>
	<check>300 &lt;= $(window_size)[0] &lt;= 4096</check>
	<check>300 &lt;= $(window_size)[1] &lt;= 4096</check>
	<doc>
The options block sets special parameters for the flow graph. \
Only one option block is allowed per flow graph.

Title, author, and description parameters are for identification purposes.

The window size controls the dimensions of the flow graph editor. \
The window size (width, height) must be between (300, 300) and (4096, 4096).

The generate options controls the type of code generated. \
Non-graphical flow graphs should avoid using graphical sinks or graphical variable controls.

The id of this block determines the name of the generated file and the name of the class. \
For example, an id of my_block will generate the file my_block.py and class my_block(gr....

The category parameter determines the placement of the block in the block selection window. \
The category only applies when creating hier blocks. \
To put hier blocks into the root category, enter / for the category.
	</doc>
</block>