________________________________________________ | Satori Circulation | | current version: 0.770.0 beta - in development | | (C) 2002 - 2009 Satori, s.r.o. | ------------------------------------------------ notation: '' ; `config_tag` ; "documentation_section"; ; >gui_element< ($ released only for licensed users) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - change log: in preparation: 23.12.09 (ver. 0.770.0) not yet released engine: --------- * 4th source added to render pipeline. Logically after MPE (master-posteffects) new master source been introduced at the very end of rendering pipeline. So somehow this master source can be called a "backup" source - in the moment you have your engine up-side-down in live mixing you can mix-up with 3rd mixer (not yet visible in GUI) your master source and overlay the final output - (so please note MPE are not applyed after master source rendering - this is the difference from other sources!) See rendering pipeline chart for updated info. See below midi config tag to access 3rd fader on 3rd mixer. You can access 3rd mixer with keyboard shortcutsl all you need is to set keyboard focus to MIX3 and this is new. * new keyboard focus to MIX3 added. Before Left arrow made focus to MIX1 and RCTRL+Left made focus to MIX2. Down arrow focuses on SRC1 and Up one to SRC2. Right arrow focuses SRC3 and RCTRL+Right make focus to Master source (SRC4). Now comes the new feature to focus MIX3. Press RCTRL+RightArrow2times. Hold RCTRL and press Right arrow 2 times (with delay less than 200ms). This will focus your keyboard on MIX3 and you can select mixing fader for Master source. Default is cross-fade. * render-store-point-3 { TO_DO } system: --------- * Loader - during start-up sequence pressing ESC terminates application immediatelly! * Totally new handling to keyboard. Classical approach to windows applications is replaced by total control over keyboard via low-level keyboard hook. So while Circ is active application in GUI fullscreen mode, what is typical mode you use for gigs, none of pressed keys are passed further to the system's processing. Why does it makes sense? There is all kind of strange shortcuts reacting in your system from installed application or system itself. Unwanted pop-up dialogs can occur or Circ can lose focus. Also pressing WIN keys or ALT-TAB during concert is not really welcomed. Now you are safe and you can be sure keyboard while playing is processed only by application itself. Keyboard hook is used in GUI windowed mode however ALT-TAB is possible. * LWIN started to be used for very special purposes. Because WIN keys are generally not passed to system we can use LWIN for special system tasks. First set of them been introduced in this version - see further. RWIN key is used only in mac-keyb emulating mode substituting RCTRL. * Midi re(connect) - LWIN-M. In previous versions midi been initialised only at startup sequence and you had to restart app if you lost connection with the midi device. Now you can plug midi device even while Circ is running and if you let system load driver few seconds and then press LWIN-M you reconnect midi devices. If it does not work right away after plugging the device try few seconds later. * Capture re(connect) - LWIN-C. The same as for midi states for capture device. Now it's possible to reconnect to the driver or, if the capture device was not present at loading sequence and therefore skipped, it's possible to connect now and add 'capture' source to active sources. But be sure that capture driver config dialogs will popup to your fullscreen GUI. { TO_DO } * Output display re(connect) - LWIN-D. This will also enable second head output in system if disabled. { TO_DO } sources: ---------- { TO_OD } * aviplay 'aviplay' features now autoimport capabilities: `aviplay_autoimport` - this tag turns on 'aviplay' auto-import feature. it inserts all videos (*.avi) in standard aviplay_dir directory, or in defined `aviplay_autoimport_dir` directory. matter of inserting videos is one by one from defined autoimport starting bank or from bank 0. keyboard shortcuts for videos are taken sequentially by the rows (QWERTY...) already taken slot in bank is skipped. IMPORTANT NOTE: first the standdardly defined videos in list.txt are loaded and then autoimport feature is applied. `aviplay_autoimport_dir=dir$` `aviplay_autoimport_bank_start=#` `aviplay_autoimport_save=file$` for you courtnesy you can save 'raw' list.txt out of this autoimport procedure so you can add this list to your main aviplay list config file. be sure to remove this tag after processing the saving operation so you don't save the list over and over. `aviplay_autoimport_postfix="string$"` this is powerfull way to add standard attributes to all videos, e.g. you can define "pingping deinterlace" for processing all video in loop mode and with fields removal aviplay tagging with gui support for creating tag-based view according to typed string e.g. you got 4 videos in bank _ _ video1.avi tag=tree,flower _ _ video2.avi tag=flower,sun _ _ video3.avi tag=ground,water,flower _ _ video4.avi tag=tree idea is: if you hold ALT button while focused in 'aviplay' and you type on keyboard "tree" new view will be created including 2 videos: video1.avi and video4.avi if you type while holding ALT "flower" 2 videos will be available on select: video1.avi, video3.avi Please select bank number to disable tag-view. ( this is a powerfull way in live improvised situations to select proper fitting video footage ) { /TO_DO } * picblur 'picblur' source is extended up to 1024 images (before limited was 256) with extended possibility to select 10 more banks with ALT+bank#, e.g. you will access bank #12 by pressing ALT+2 (10 for ALT and 2 for key) new config tags: ------------------ * `app_switch_on` new keyboard handling been introduced so ALT-TAB and other application switch shortcuts are disabled in fullscreen GUI mode. but if you need this function for whatever reason you can turn on passing this shortcuts to system and switch to other application. this tag is used only in fullscreen GUI mode. * `mac_keyb` this is great help for users using WinOS on Intel MACs. because Apple's laptop keyboards does not feature RCTRL and RALT it's impossible to control proprely Circulation. with this tag you force translation or RWIN key to RALT and small ENTER next to RCTRL. * `stripes_size=#` - size of horizontal wide-screen stripes displayed upon RCTRL-Z in mixer keyboard focus. size of these stripes can be defined with this new config tag { TO_DO } * `sources_off` disables load of sources. usefull for development and maybe for other purpose too others: --------- * fancy shutdown-fx :] * logically reordered GUI short-cuts for posteffects panels: - ALT+F1-F4 for SRC1, SRC2, SRC3 and MASTER - ALT+F5-F8 for PESRC1, PESRC2, PESRC3, MSTPE - ALT+F9-F12 for SET1, SET2, PIPELINE, COMBOS * now is software distributed with only circulation.exe executable and circulation.dat is removed * console font in loader's log display GUI: ------ * while using touchpad midi device (configured via `midi_touchpad_on` and other tags) you will get in the bottom status line new info telling you actually controlling parameters. next to KEYfocus: will appear PADfocus: with values MX1-MX2, CON-BRT, CLR-COL, SRC1, SRC1PFX etc. focus of pad is controlled via 12 buttons. see doc for more. bugfixes: ----------- * thumbnail aviplay cache fixed { TO_DO_NOT_WORKING } * change on/off of posteffects is not updated while watching pipeline !!! { TO_DO } * delete combos from disk as well!! { TO_DO } * strange behaviour of picblur if file is not found on disk { TO_DO } posteffects: -------------- * all fx on/off - now you can turn off all effects by skipping posteffects in pipeline * +fx button to add ability to use another posteffects unit. above the switch button selector is placed to choose which posteffects will be applyed. * chart of keyboard shortcuts' mapping is created for better orientation { TO_DO } ~~~~~~~ midi ~~~~ * config tag `midi_mixer_xfade3=#num` to define controller to adjust 3rd mixer fader level. * {almost done TO_DO} all paramatric values supported by relative midi controller (suggested brand is "doepher pocket control" - with info how to configure this model) * "Korg nanoPad" support and actually it should work with other touch controllers easily (tested with KP1 and nanoPad) * "Novation Launch Pad" 8x8 button matrix support ========================================================================================= 09.Mar.09 (ver. 0.767) `midi_relative_source1`, `midi_relative_source2`, `midi_relative_source3` and `midi_relative_master` to define midi-relative-controller's starting offsets. instead of defining every single controller by a value, defined controllers are grouped into source1,2,3 and master. then for each group 8 relative controllers are processed. offsetting controllers are defined as follow: [midi_rel_offset] | [source / post-effects control ] --------------------+--------------------------------------------- 0 | source control 1 1 | source control 2 2 | source control 3 3 | post-effects control 1 4 | post-effects control 2 5 | post-effects control 3 6 | post-effects control 4 7 | post-effects control 5 detailed description should follow in next version of documentation as feature of relative midi controllers is ability to control more values via single knob by holding CTRL, ALT, SHIFT or combinations of these keys. wide variety (but not all!) of maped control is present and currently is left for the exploration by the users. (sorry) ========================================================================================= 17.Nov.08 {ver. 0.766} `gui_windowed` config tag for GUI embedded in standard os-window. this feature is in experimental stage and not recommended for live performance. it's stable in single-GUI mode when no final render is used on second display. customable `output_mode_width` and `output_mode_height` with starting and ending projection scanline control by `output_scanline_start` and `output_scanline_end` tags what gives you ability to project your final output in 16:9 mode! GUI supports marking of scanline "cut-offs" in output view example to enable 16:9 output: output_mode_width=1280 output_mode_height=1080 output_scanline_start=60 output_scanline_end=420 note: use in Circulation to blank upper and down 16:9 cut-offs by RCtrl-Z black-stripes toggle feature while having keyboard focus on MIX1,2 `capture_16:9` to enable usage of 16:9 signal with capture source. image is vertically stretched to 640x360 resolution in order to keep correct aspect radio on output 16:9 device. to use with combination of outmode_mode's and output_scanline's tags in 16:9 enviroment. >combo< panel now extended to 9 pages of posteffects' snap-shots. this gives you possibility to maintain 450 of combos alltogether. 'picblur' source with new LCtrl-R toggle command to rescale large images in order to fit the screen. 'ocean' source as a bonus plug. replace with your own bitmaps for custom effect. few more bugfixes and features for you to explore. please reports all strange behaviours and bugs. your help will be appreciated. new features implementation is really problematic at the time. please let's try to get rid of current bugs. THIS RELEASE IS INTENDED TO REPLACE YOUR CURRENT CIRCULATION.EXE AND CIRCULATION.DAT. PLEASE KEEP YOUR ORIGINAL SET. KEEP THE PREVIOUS VERSION IF THIS ONE BRINGS UNPLEASANT PROBLEMS AND REPORT THE PROBLEMS. I'LL TRY TO RELEASE THIS YEAR ONE MORE VERSION WITH FIXED REPORTED BUGS. ========================================================================================= 23.May.07 {ver. 0.763} 'swfplay' Adobe Flash source with ability to replay most of swf files and support for interactive mouse control. basic GUI scratch. next version will support either keyboard control and complete GUI. this replayer is based on active-x flash player for IE. please upgrade your flash plugin for this browser (sorry :)). Flash examples by courtesy of Arcangel Constantini. 'slider' source GUIfication (75% done) multi-mouse support with separate mouse control for all section of rendering pipeline: (src1, src2, src3, mix1, mix2, master/output). please read new "8.1 Multi-mouse control" section in manual how to navigate your mouse focus new `posteffects_all_gens` tag (config.ini) to enable selection of all 4 generators in both posteffects set-panels quadra view selector with improoved image rescaling. use `quadra_raw` to switch back previous noninterpolated scaling >LOCK< switch for locking of opening both posteffects and sources GUI pannels on mouse click selection. use tag `gui_plock_on` for enablig this option by default config files documented for sources 'slider' and 'swfplay' tip: check new updated section "4.1 Aviplay" for link of Koepi's VfW codec installation in order to replay DivX/XviD videos smoothly ========================================================================================= 23.Feb.07 {ver. 0.754} Circulation show-reel video is now available for download as an example of timeline scripted composition OSC network control including oscmd.exe utility to send commands from other computer including first version of scripting documentation touchpad and mixer midi configuration described in configs doc saving AVI is now checking for available disk space and stops recording authomatically if volume is full capture source now accepts newly also YUY2 and I420 modes ========================================================================================= 23.Jan.07 {ver. 0.753} unpleasant combo bug, you could save combos only for source1 posteffects, now combos should work fine refined posteffects scripting control including documentation. detailed config files documentation started shortcuts for selecting source/posteffect GUI panels (ALT-F1..ALT-F11) and view selector (SHIFT-F1..F7) including SHIFT-F12 for toggling fullscreen view operation (full only) capture source is now accepting all resolutions in uncompressed 16, 24 and 32 bits RBG modes and gui features at least a preview screen keyboard focus is now displayed in bottom right corner of GUI ========================================================================================= 31.Oct.06 {ver. 0.752} few system instabilities fixed e.g. engine crashed if you selected the last (unexisting) fadermap in timedistort via GUI engine should be even more stable but please report all crashes and describe your situation (input data) if system crashes in startup loading inform us as well ========================================================================================= 25.Sep.06 {ver. 0.751} first public release =========================================================================================