New scripts:
[blender.git] / release / scripts / hotkeys.py
1 #!BPY
2
3 """ Registration info for Blender menus:
4 Name: 'HotKeys'
5 Blender: 232
6 Group: 'Help'
7 Tip: 'All the hotkeys.'
8 """ 
9 # $Id$
10 #------------------------
11 #  Hotkeys script
12 #         jm soler (2003)
13 # -----------------------
14 # Page officielle :
15 #   http://jmsoler.free.fr/didacticiel/blender/tutor/cpl_hotkeyscript.htm
16 # Communiquer les problemes et les erreurs sur:
17 #   http://www.zoo-logique.org/3D.Blender/newsportal/thread.php?group=3D.Blender
18 #--------------------------------------------- 
19 # ce script est proposé sous licence GPL pour etre associe
20 # a la distribution de Blender 2.33 et suivant
21 # --------------------------------------------------------------------------
22 # ***** BEGIN GPL LICENSE BLOCK *****
23 #
24 # Copyright (C) 2003, 2004: Jean-Michel Soler
25 #
26 # This program is free software; you can redistribute it and/or
27 # modify it under the terms of the GNU General Public License
28 # as published by the Free Software Foundation; either version 2
29 # of the License, or (at your option) any later version.
30 #
31 # This program is distributed in the hope that it will be useful,
32 # but WITHOUT ANY WARRANTY; without even the implied warranty of
33 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
34 # GNU General Public License for more details.
35 #
36 # You should have received a copy of the GNU General Public License
37 # along with this program; if not, write to the Free Software Foundation,
38 # Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
39 #
40 # ***** END GPL LICENCE BLOCK *****
41 # --------------------------------------------------------------------------
42
43 import Blender
44 from Blender.Draw import *
45 from Blender.BGL import *
46
47 hotkeys={
48 'Specials 1 ':[
49 [',', 'Set Bounding Box rotation scaling pivot'],
50 ['.', 'Set 3D cursor as rotation scaling pivot'] ,
51 ['~', 'Display all layers'] ,
52 ['Shift-~', 'Display all/previous layers'] ,
53 ['TAB', 'Enter/exit edit mode'] ,
54 ['TAB', 'Edit Mode and Numerical Edit (see N key) : move to next input value'],
55 ['TAB', 'Sequencer: Edit meta strip'] ,
56 ['CTRL-TAB', 'Enter/exit pose mode']
57 ],
58
59 'Specials 2 ':[
60 ['F1', 'Open File'],
61 ['F2', 'Save File'],
62 ['F3', 'Save image'],
63 ['F4', 'Logic window (may change)'],
64 ['F5', 'Material window'],
65 ['F6', 'Texture window'],
66 ['F7', 'Object window'],
67 ['F8', 'World window'],
68 ['F9', 'Edit Mode window'],
69 ['F10', 'Render Window'],
70 ['F11', 'Recall the last rendered image'],
71 ['F12', 'Render current Scene'],
72 ['Shift-F1', 'Library Data Select'],
73 ['Shift-F4', 'Data Select '],
74 ['Shift-F5', '3D window'],
75 ['Shift-F6', 'IPO window'],
76 ['Shift-F8', 'Video Sequencer window'],
77 ['Shift-F9', 'OOP window'],
78 ['Shift-F10', 'Image Window']
79 ] ,
80
81 'Numbers  ':[
82 ['1..2..0-=', 'Show layer 1..2..12'] ,
83 ['ALT-1..2..0', 'Show layer 11..12..20'] ,
84 ['SHIFT-1..2..0-=', 'Toggle layer 1..2..12'] ,
85 ['SHIFT-ALT-...', 'Toggle layer 11..12..20'] ],
86
87 'Numpad  ':[
88 ['Numpad DEL', 'Zoom on object'] ,
89 ['Numpad /', 'Local view on object (hide others)'] ,
90 ['Numpad *', "Rotate view to object's local axes"] ,
91 ['Numpad +', 'Zoom in (works everywhere)'] ,
92 ['Numpad +', 'Proportional vertex edit mode: Increase range of influence'] ,
93 ['Numpad -', 'Zoom out (works everywhere)'] ,
94 ['Numpad -', 'Proportional vertex edit mode: Decrease range of influence'] ,
95 ['Numpad INS', 'Set Camera view'] ,
96 ['CTRL-Numpad INS', 'Set active object as camera'] ,
97 ['ALT-Numbad INS', 'Restore old camera'] ,
98 ['Numpad 1', 'Front view'] ,
99 ['CTRL-Numpad 1', 'Back view'] ,
100 ['Numpad 3', 'Right-Side view'] ,
101 ['CTRL-Numpad 3', 'Left-Side view'] ,
102 ['Numpad 7', 'Top view'] ,
103 ['CTRL-Numpad 7', 'Bottom view '] ,
104 ['Numpad 5', 'Toggle orthogonal // perspective view'] ,
105 ['Numpad 9', 'Redraw view'] ,
106 ['Numpad 2', 'Rotate view left'] ,
107 ['Numpad 6', 'Rotate view right'] ,
108 ['Numpad 8', 'Rotate view up'] ,
109 ['Numpad 2', 'Rotate view down'] ],
110
111 'Arrows ':[
112 ['PgUp', 'IPO: Select next keyframe'] ,
113 ['CTRL-PgUp', 'IPO: Select and jump to next keyframe'] ,
114 ['PgDn', 'IPO: Select previous keyframe'] ,
115 ['CTRL-PgDn', 'IPO: Select and jump to previous keyframe'] ,
116 ['LEFT', 'One frame backwards'] ,
117 ['RIGHT', 'One frame forwards'] ,
118 ['DOWN', '10 frames backwards'] ,
119 ['UP', '10 frames forwards'] ],
120
121 'Letters ':[ {"A":[ 
122 ['A', 'Select all / Deselect all'] ,
123 ['ALT-A', 'Animate current window'] ,
124 ['CTRL-A', "Apply object's size/rotation to object data"] ,
125 ['SHIFT-A', 'Sequencer: ADD menu'] ,
126 ['SHIFT-ALT-A', 'Animate all windows'] ,
127 ['SHIFT-CTRL-A', 'Apply lattice / Make dupliverts real']] ,
128
129 "B":[ 
130 ['B', 'Border select'] ,
131 ['BB', 'Circle select'] ,
132 ['SHIFT-B', 'Set render border'] ],
133
134 "C":[ 
135 ['C', 'Center view on cursor'] ,
136 ['C', 'Sequencer: Change images'] ,
137 ['C', 'IPO: Snap current frame to selected key'] ,
138 ['ALT-C', 'Convert menu'] ,
139 ['CTRL-C', 'Copy menu (Copy properties of active to selected objects)'] ,
140 ['SHIFT-C', 'Center and zoom view on selected objects']] ,
141
142 "D":[  
143 ['D', 'Set 3d draw mode'] ,
144 ['ALT-D', 'Create new instance of object'] ,
145 ['CTRL-D', 'Display alpha of image texture as wire'] ,
146 ['SHIFT-D', 'Create full copy of object'] ],
147
148 "E":[ 
149 ['E', 'Extrude'],
150 ['EX', 'Extrude along X axis'],
151 ['EY', 'Extrude along Y axis'],
152 ['EZ', 'Extrude along Z axis'],
153 ['ALT-E', 'Edit mode: exit edit mode'],] ,
154
155 "F":[ 
156 ['F', 'Edit mode: Make edge/face'] ,
157 ['F', 'Sequencer: Set Filter Y'] ,
158 ['F', 'Faceselect mode'] ,
159 ['ALT-F', 'Beautify fill'] ,
160 ['CTRL-F', 'Sort faces in Z direction'] ,
161 ['CTRL-F', 'Edit mode: Flip triangle edges'] ,
162 ['SHIFT-F', 'Edit mode: Fill with triangles']] ,
163
164 "G":[ 
165 ['G', 'Grab (move)'] ,
166 ['ALT-G', 'Clear location'] ,
167 ['SHIFT-ALT-G', 'Remove selected objects from group'] ,
168 ['CTRL-G', 'Add selected objects to group'] ,
169 ['SHIFT-G', 'Group menu'] ],
170
171 "H":[ 
172 ['H', 'Hide selected vertices/faces'] ,
173 ['H', 'Curves: Set handle type'] ,
174 ['ALT-H', 'Reveal vertices'] ,
175 ['CTRL-H', 'Curves: Automatic handle calculation'] ,
176 ['SHIFT-H', 'Hide deselected vertices'] ,
177 ['SHIFT-H', 'Curves: Set handle type']] ,
178
179 "I":[ 
180 ['I', 'Keyframe menu'] ],
181
182 "J":[ 
183 ['J', 'Mesh: Join all adjacent triangles to quads'] ,
184 ['J', 'Swap render page of render window'] ,
185 ['CTRL-J', 'Join selected objects'] ,
186 ['CTRL-J', 'Nurbs: Add segment'] ,
187 ['CTRL-J', 'IPO: Join keyframes menu'],
188 ['ALT-J', 'Edit Mode: convert quads to triangles']
189 ],
190
191 "K":[  
192 ['K', '3d window: Show keyframe positions'] ,
193 ['K', 'IPO: Show keyframe positions'] ,
194 ['K', 'Nurbs: Print knots'] ,
195 ['CTRL-K', 'Make skeleton from armature'] ,
196 ['SHIFT-K', 'Show and select all keyframes for object'] ,
197 ['SHIFT-K', 'Edit: Knife Mode select'],
198 ['SHIFT-K', 'Faceselect: Clear vertexcolours'],
199 ] ,
200
201 "L":[ 
202 ['L', 'Make local menu'] ,
203 ['L', 'Edit mode: Select linked vertices (near mouse pointer)'] ,
204 ['L', 'OOPS window: Select linked objects'] ,
205 ['CTRL-L', 'Make links menu'] ,
206 ['SHIFT-L', 'Select links menu'] ],
207
208 "M":[ 
209 ['M', 'Move object to different layer'] ,
210 ['M', 'Sequencer: Make meta strip (group) from selected strips'],
211 ['ALT-M', 'Edit Mode: Merge vertices'] ],
212
213 "N":[ 
214 ['N', 'Numeric input menu (Size/Rot/Loc)'] ,
215 ['N', 'OOPS window: Rename object/linked objects'] ,
216 ['CTRL-N', 'Armature: Recalculate bone roll angles'] ,
217 ['CTRL-N', 'Recalculate normals to outside'] ,
218 ['CTRL-ALT-N', 'Recalculate normals to inside'] ],
219
220 "O":[ 
221 ['O', 'Edit mode: Toggle proportional vertex editing'] ,
222 ['ALT-O', 'Clear object origin'] ,
223 ['CTRL-O', 'Revert current file to last saved'] ,
224 ['SHIFT-O', 'Proportional vertex edit mode: Toggle smooth/steep falloff'] ],
225
226 "P":[ 
227 ['P', 'Start realtime engine'] ,
228 ['P', 'Edit mode: Seperate vertices to new object'] ,
229 ['ALT-P', 'Clear parent relationship'] ,
230 ['CTRL-P', 'Make active object parent of selected object'] ,
231 ['CTRL-SHIFT-P', 'Make active object parent of selected object without inverse'] ,
232 ['CTRL-P', 'Edit mode: Make active vertex parent of selected object'] ],
233
234 "Q":[['Q', 'Quit'] ],
235
236 "R":[ 
237 ['R', 'Rotate'] ,
238 ['R', 'IPO: Record mouse movement as IPO curve'] ,
239 ['RX', 'Rotate around X axis'] ,
240 ['RXX', "Rotate around object's local X axis"] ,
241 ['RY', 'Rotate around Y axis'] ,
242 ['RYY', "Rotate around object's local Y axis"] ,
243 ['RZ', 'Rotate around Z axis'] ,
244 ['RZZ', "Rotate around object's local Z axis"] ,
245 ['ALT-R', 'Clear object rotation'] ,
246 ['SHIFT-R', 'Nurbs: Select row'], 
247 ['CTRL-R', 'Edit Mode: Knife, cut selected edges, accept left mouse/ cancel right mouse'],
248 ['SHIT-R', 'Edit Mode: loop Selection']],
249
250 "S":[ 
251 ['S', 'Scale'] ,
252 ['SX', 'Flip around X axis'] ,
253 ['SY', 'Flip around Y axis'] ,
254 ['SZ', 'Flip around Z axis'] ,
255 ['SXX', 'Flip around X axis and show axis'] ,
256 ['SYY', 'Flip around Y axis and show axis'] ,
257 ['SZZ', 'Flip around Z axis and show axis'] ,
258 ['ALT-S', 'Edit mode: Shrink/fatten (Scale along vertex normals)'] ,
259 ['ALT-S', 'Clear object size'] ,
260 ['CTRL-S', 'Edit mode: Shear'] ,
261 ['SHIFT-S', 'Cursor/Grid snap menu'] ],
262
263 "T":[ 
264 ['T', 'Sequencer: Touch and print selected movies'] ,
265 ['T', 'Adjust texture space'] ,
266 ['T', 'Edit mode: Flip 3d curve'] ,
267 ['T', 'IPO: Change IPO type'] ,
268 ['ALT-T', 'Clear tracking of object'] ,
269 ['CTRL-T', 'Make selected object track active object'] ,
270 ['CTRL-T', 'Mesh: Convert to triangles'] ,
271 ['CTRL-ALT-T', 'Blenchmark'] ],
272
273 "U":[ 
274 ['U', 'Make single user menu'] ,
275 ['U', 'Edit mode: Reload object data from before entering edit mode'] ,
276 ['U', 'Faceselect mode: Automatic UV calculation menu'] ,
277 ['U', 'Vertex-/Weightpaint mode: Undo'] ,
278 ['CTRL-U', 'Save current state as user default'],
279 ['SHIFT-U', 'EditMode : Redo Menu'],
280 ['ALT-U', 'Edit Mode: Undo Menu']
281  ],
282
283 "V":[ 
284 ['V', 'Curves/Nurbs: Vector handle'] ,
285 ['V', 'Vertexpaint mode'] ,
286 ['ALT-V', "Scale object to match image texture's aspect ratio"] ,
287 ['SHIFT-V', 'Edit mode: Align view to selected vertices'] ],
288
289 "W":[ 
290 ['W', 'Boolean operations menu'] ,
291 ['W', 'Edit mode: Specials menu'] ,
292 ['CTRL-W', 'Save current file'] ,
293 ['CTRL-W', 'Nurbs: Switch direction'] ,
294 ['SHIFT-W', 'Warp/bend selected vertices around cursor'] ] ,
295
296 "X":[ 
297 ['X', 'Delete menu'] ,
298 ['CTRL-X', 'Restore default state (Erase all)'] ],
299
300 "Y":[ 
301 ['Y', 'Mesh: Split selected vertices/faces from the rest'] ],
302
303 "Z":[ 
304 ['Z', 'Switch 3d draw type : solide/ wireframe (see also D)'],
305 ['Alt-Z', 'Switch 3d draw type : solid / textured (see also D)'],
306 ['Shift-Z', 'Switch 3d draw type : shaded / wireframe (see also D)'],
307
308 ]}]}
309
310
311 for k in hotkeys.keys():
312    hotkeys[k].append(Create(0))
313
314 for k in hotkeys['Letters '][0]:
315    hotkeys['Letters '][0][k].append(Create(0))
316
317 hotL=hotkeys['Letters '][0].keys()
318 hotL.sort()
319
320 hot=hotkeys.keys()
321 hot.sort()
322
323 glCr=glRasterPos2d
324 glCl3=glColor3f
325 glCl4=glColor4f
326 glRct=glRectf
327
328 cf=[0.95,0.95,0.9,0.0]
329 c1=[0.95,0.95,0.9,0.0]
330 c=cf
331 r=[0,0,0,0]
332
333 def trace_rectangle4(r,c):
334     glCl4(c[0],c[1],c[2],c[3])
335     glRct(r[0],r[1],r[2],r[3])
336
337 def trace_rectangle3(r,c,c1):
338     glCl3(c[0],c[1],c[2])
339     glRct(r[0],r[1],r[2],r[3])
340     glCl3(c1[0],c1[1],c1[2])
341
342 def draw():
343     global r,c,c1,hotkeys, hot, hotL
344
345     size=Buffer(GL_FLOAT, 4)
346     glGetFloatv(GL_SCISSOR_BOX, size)
347     size= size.list
348
349     for s in [0,1,2,3]: size[s]=int(size[s])
350
351     c=[0.9,0.95,0.95,0.0]
352     c1=[0.95,0.95,0.9,0.0]
353
354     r=[0,size[3],size[2],0]
355     trace_rectangle4(r,c)
356
357     c=[0.7,0.7,0.9,0.0]
358     c1=[0.95,0.95,0.9,0.0]
359     
360     r=[0,size[3],size[2],size[3]-20]
361     trace_rectangle4(r,c)
362
363     c1=[0.7,0.7,0.9,0.0]
364     c=[0.2,0.2,0.4,0.0]
365     c2=[0.87,0.87,0.95,0.0]     
366
367     r=[0,size[3]-20,size[2],size[3]-44]
368     trace_rectangle4(r,c)
369
370     glColor3f(0.1, 0.1, 0.15)
371     glRasterPos2f(10, size[3]-16)
372
373     Text("HotKey")
374
375     l=0
376     listed=0
377     Llisted=0
378     for k in hot:             
379        hotkeys[k][-1]=Toggle(k, hot.index(k)+10, 4+(20*26)/6*hot.index(k), size[3]-(40), len(k)*8, 20, hotkeys[k][-1].val )
380        l+=len(k)
381        if hotkeys[k][-1].val==1.0:
382            listed=hot.index(k)
383            #print listed
384     l=0
385     if hot[listed]!='Letters ':
386        for n in  hotkeys[hot[listed]][:-1]:
387           if l%2==0:
388              r=[4,size[3]-(18*l+66),
389                      8+(21*26), size[3]-(46+18*l)]
390              trace_rectangle4(r,c2)
391           glColor3f(0.1, 0.1, 0.15)
392           glRasterPos2f(4+8, size[3]-(58+18*l))
393           Text(n[0])
394           glRasterPos2f(4+8*15, size[3]-(58+18*l))
395           Text('  : '+n[1]) 
396           l+=1
397     else:
398        for k in hotL:
399             pos=hotL.index(k)
400             hotkeys['Letters '][0][k][-1]=Toggle(k,pos+20,4+hotL.index(k)*21, size[3]-(52+18), 20, 20, hotkeys['Letters '][0][k][-1].val )
401             if hotkeys['Letters '][0][k][-1].val==1.0:
402                Llisted=pos
403        for n in hotkeys['Letters '][0][hotL[Llisted]][:-1]:
404           if l%2==0:
405              r=[4,size[3]-(18*l+92),
406                      8+(21*26), size[3]-(74+18*l)]
407              trace_rectangle4(r,c2)
408           glColor3f(0.1, 0.1, 0.15)  
409           glRasterPos2f(4+8, size[3]-(88+18*l))
410           Text(n[0])
411           glRasterPos2f(4+8*15, size[3]-(88+18*l))
412           Text('  : '+n[1]) 
413           l+=1
414
415 def event(evt, val):
416     global hotkeys     
417     if (evt== QKEY and not val): Exit()
418
419 def bevent(evt):
420     global hotkeysmhot, hotL
421     if   (evt== 1):
422         Exit()
423
424     elif (evt in range(10,20,1)):
425         for k in hot:
426            if hot.index(k)+10!=evt:
427                  hotkeys[k][-1].val=0
428                  
429         Blender.Window.Redraw()
430
431     elif (evt in range(20,46,1)):
432         for k in hotL:
433            if hotL.index(k)+20!=evt:
434                  hotkeys['Letters '][0][k][-1].val=0
435
436         Blender.Window.Redraw()
437
438 Register(draw, event, bevent)