]> git.sesse.net Git - casparcg/blob - CHANGES.txt
Updated documents
[casparcg] / CHANGES.txt
1 C H A N G E S\r
2 \r
3 CasparCG 2.0.4 Stable (as compared to 2.0.4 Beta 1)\r
4 ===================================================\r
5 \r
6 General\r
7 -------\r
8 \r
9   o Can now open media with digit only names.\r
10   o Misc stability and performance improvements.\r
11 \r
12 Video mixer\r
13 -----------\r
14 \r
15   o Conditional compilation of chroma key support and straight alpha output\r
16     support in shader (just like with blend-modes) because of performance impact\r
17     even when not in use on a layer/on a channel. New <mixer /> element added to\r
18     configuration for turning on mixer features that not everybody would want to\r
19     pay for (performance-wise). blend-modes also moved into this element.\r
20   o MIXER LEVELS interpretet arguments in the wrong order, so that gamma was\r
21     interpreted as max_input and vice versa.\r
22 \r
23 Consumers\r
24 ---------\r
25 \r
26   o Replaced usage of SFML for <system-audio /> with PortAudio, because of\r
27     problems with SFML since change to static linkage. Also PortAudio seems to\r
28     give lower latency.\r
29   o Added support for NewTek AirPlay. Enables the use of the CasparCG Server\r
30     output as an input source in a NewTek TriCaster without requiring a video\r
31     card. <newtek /> element in config enables AirPlay on a channel.\r
32   o Decklink: Created custom decklink allocator for reducing memory footprint.\r
33 \r
34 Producers\r
35 ---------\r
36 \r
37   o ffmpeg: Added support for arbitrary ffmpeg options in ffmpeg_producer.\r
38   o flash: No longer starts a flash player to service CG commands that means\r
39     nothing without an already running flash player.\r
40   o flash: globally serialize initialization and destruction of flash players,\r
41     to avoid race conditions in flash.\r
42   o flash: changed so that the flash buffer is filled with flash player\r
43     generated content at initialization instead of empty frames.\r
44 \r
45 OSC\r
46 ---\r
47 \r
48   o Performance improvements.\r
49   o Never send old values to OSC reveivers, collect the latest value of each\r
50     path logged since last UDP send, and send the new UDP packet (to each\r
51     subscribing OSC receiver) with the values collected.\r
52   o Batch as many OSC messages as possible in an OSC bundle to reduce the number\r
53     of UDP packets sent. Breakup into separate packages if necessary to avoid\r
54     fragmentation.\r
55   o Removed usage of Microsoft Agents library (server ran out of memory after a\r
56     while) in favour of direct synchronous invocations.\r
57 \r
58 \r
59 CasparCG 2.0.4 Beta 1 (as compared to 2.0.3 Stable)\r
60 ===================================================\r
61 \r
62 General\r
63 -------\r
64 \r
65   o Front-end GUI for simplified configuration and easy access to common tasks.\r
66   o Added support for video and images file thumbnail generation. By default the\r
67     media directory is scanned every 5 seconds for new/modified/removed files\r
68     and thumbnails are generated/regenerated/removed accordingly.\r
69   o Support for new video modes: 1556p2398, 1556p2400, 1556p2500, 2160p2398,\r
70     2160p2400, 2160p2500, 2160p2997 and 2160p3000.\r
71   o Experimental ATI graphics card support by using static linking against SFML\r
72     instead of dynamic. Should improve ATI GPU support, but needs testing.\r
73   o Added support for playback and pass-through of up to 16 audio channels. See\r
74     http://casparcg.com/forum/viewtopic.php?f=3&t=1453 for more information.\r
75   o Optimizations in AMCP protocol implementations for large incoming messages,\r
76     for example base64 encoded PNG images.\r
77   o Logging output now includes milliseconds and has modified format:\r
78     YYYY-MM-DD hh:mm:ss.zzz\r
79   o Improved audio playback with 720p5994 and 720p6000 channels.\r
80   o An attempt to improve output synchronization of consumers has been made. Use\r
81     for example:\r
82 \r
83     <consumers>\r
84       <synchronizing>\r
85         <decklink>\r
86           <device>1</device>\r
87           <embedded-audio>true</embedded-audio>\r
88         </decklink>\r
89         <decklink>\r
90           <device>2</device>\r
91           <key-only>true</key-only>\r
92         </decklink>\r
93       </synchronizing>\r
94     </consumers>\r
95 \r
96     ...to instruct the server to keep both DeckLink consumers in sync with each\r
97     other. Consider this experimental, so don't wrap everything in\r
98     <synchronizing /> unless synchronization of consumer outputs is needed. For\r
99     synchronization to be effective all synchronized cards must have genlock\r
100     reference signal connected.\r
101 \r
102 Layer\r
103 -----\r
104 \r
105   o Fixed a problem where the first frame was not always shown on LOAD.\r
106 \r
107 Audio mixer\r
108 -----------\r
109 \r
110   o Added support for a master volume mixer setting for each channel.\r
111 \r
112 Video mixer\r
113 -----------\r
114 \r
115   o Added support for chroma keying.\r
116   o Fixed bug where MIXER CONTRAST set to < 1 can cause transparency issues.\r
117   o Experimental support for straight alpha output.\r
118 \r
119 Consumers\r
120 ---------\r
121 \r
122   o Avoid that the FFmpeg consumer blocks the channel output when it can't keep\r
123     up with the frame rate (drops frames instead).\r
124   o Added support for to create a separate key and fill file when recording with\r
125     the FFmpeg consumer. Add the SEPARATE_KEY parameter to the FFmpeg consumer\r
126     parameter list. The key file will get the _A file name suffix to be picked\r
127     up by the separated_producer when doing playback.\r
128   o The Image consumer now writes to the media folder instead of the data\r
129     folder.\r
130   o Fixed bug in DeckLink consumer where we submit too few audio samples to the\r
131     driver when the video format has a frame rate > 50.\r
132   o Added another experimental DeckLink consumer implementation where scheduled\r
133     playback is not used, but a similar approach as in the bluefish consumer\r
134     where we wait for a frame to be displayed and then display the next frame.\r
135     It is configured via a <blocking-decklink> consumer element. The benefits of\r
136     this consumer is lower latency and more deterministic synchronization\r
137     between multiple instances (should not need to be wrapped in a\r
138     <synchronizing> element when separated key/fill is used).\r
139 \r
140 Producers\r
141 ---------\r
142 \r
143   o Added support for playing .swf files using the Flash producer.\r
144   o Image producer premultiplies PNG images with their alpha.\r
145   o Image producer can load a PNG image encoded as base64 via:\r
146     PLAY 1-0 [PNG_BASE64] <base64 string>\r
147   o FFmpeg producer can now use a directshow input filters:\r
148     PLAY 1-10 "dshow://video=Some Camera"\r
149 \r
150 AMCP\r
151 ----\r
152 \r
153   o The master volume feature is controlled via the MASTERVOLUME MIXER\r
154     parameter. Example: MIXER 1 MASTERVOLUME 0.5\r
155   o THUMBNAIL LIST/RETRIEVE/GENERATE/GENERATE_ALL command was added to support\r
156     the thumbnail feature.\r
157   o ADD 1 FILE output.mov SEPARATE_KEY activates the separate key feature of the\r
158     FFmpeg consumer creating an additional output_a.mov containing only the key.\r
159   o Added KILL command for shutting down the server without console access.\r
160   o Added RESTART command for shutting down the server in the same way as KILL\r
161     except that the return code from CasparCG Server is 5 instead of 0, which\r
162     can be used by parent process to take other actions. The\r
163     'casparcg_auto_restart.bat' script restarts the server if the return code is\r
164     5.\r
165   o DATA RETRIEVE now returns linefeeds encoded as an actual linefeed (the\r
166     single character 0x0a) instead of the previous two characters:\r
167     \ followed by n.\r
168   o MIXER CHROMA command added to control the chroma keying. Example:\r
169     MIXER 1-1 CHROMA GREEN|BLUE 0.10 0.04\r
170   o Fixed bug where MIXER FILL overrides any previous MIXER CLIP on the same\r
171     layer. The bugfix also has the side effect of supporting negative scale on\r
172     MIXER FILL, causing the image to be flipped.\r
173   o MIXER <ch> STRAIGHT_ALPHA_OUTPUT added to control whether to output straight\r
174     alpha or not.\r
175   o Added INFO <ch> DELAY and INFO <ch>-<layer> DELAY commands for showing some\r
176     delay measurements.\r
177 \r
178 \r
179 OSC\r
180 ---\r
181 \r
182   o Support for sending OSC messages over UDP to either a predefined set of\r
183     clients (servers in the OSC sense) or dynamically to the ip addresses of the\r
184     currently connected AMCP clients.\r
185   o /channel/[1-9]/stage/layer/[0-9]\r
186     + always             /paused           [paused or not]\r
187     + color producer     /color            [color string]\r
188     + ffmpeg producer    /profiler/time    [render time]     [frame duration]\r
189     + ffmpeg producer    /file/time        [elapsed seconds] [total seconds]\r
190     + ffmpeg producer    /file/frame       [frame]           [total frames]\r
191     + ffmpeg producer    /file/fps         [fps]\r
192     + ffmpeg producer    /file/path        [file path]\r
193     + ffmpeg producer    /loop             [looping or not]\r
194     + during transitions /transition/frame [current frame]   [total frames]\r
195     + during transitions /transition/type  [transition type]\r
196     + flash producer     /host/path        [filename]\r
197     + flash producer     /host/width       [width]\r
198     + flash producer     /host/height      [height]\r
199     + flash producer     /host/fps         [fps]\r
200     + flash producer     /buffer           [buffered]        [buffer size]\r
201     + image producer     /file/path        [file path]\r
202 \r
203 \r
204 CasparCG 2.0.3 Stable (as compared to 2.0.3 Alpha)\r
205 ==================================================\r
206 \r
207 Stage\r
208 -----\r
209 \r
210   o Fixed dead-lock that can occur with multiple mixer tweens.\r
211 \r
212 AMCP\r
213 ----\r
214 \r
215   o DATA STORE now supports creating folders of path specified if they does not\r
216     exist.\r
217   o DATA REMOVE command was added.\r
218 \r
219 \r
220 CasparCG 2.0.3 Alpha (as compared to 2.0 Stable)\r
221 ================================================\r
222 \r
223 General\r
224 -------\r
225 \r
226   o Data files are now stored in UTF-8 with BOM. Latin1 files are still\r
227     supported for backwards compatibility\r
228   o Commands written in UTF-8 to log file but only ascii characters to console.\r
229   o Added supported video formats:\r
230     + 720p2398 (not supported by DeckLink)\r
231     + 720p2400 (not supported by DeckLink)\r
232     + 1080p5994\r
233     + 1080p6000\r
234     + 720p30 (not supported by DeckLink)\r
235     + 720p29.976 (not supported by DeckLink)\r
236 \r
237 CLK\r
238 ---\r
239 \r
240   o CLK protocol implementation can now serve more than one connection at a time\r
241     safely.\r
242   o Added timeline support to the CLK protocol.\r
243   o Refactored parts of the CLK parser implementation.\r
244 \r
245 Consumers\r
246 ---------\r
247 \r
248   o Consumers on same channel now invoked asynchronously to allow for proper\r
249     sync of multiple consumers.\r
250   o System audio consumer:\r
251     + no longer provides sync to caspar.\r
252   o Screen consumer:\r
253     + Support for multiple screen consumers on the same channel\r
254     + No longer spin-waits for vsync\r
255     + Now deinterlaces to two separate frames so for example 50i will no longer\r
256       be converted to 25p but instead to 50p for smooth playback of interlaced\r
257       content.\r
258   o Decklink consumer now logs whether a reference signal is detected or not.\r
259 \r
260 Producers\r
261 ---------\r
262 \r
263   o Image scroll producer:\r
264     + Field-rate motion instead of frame-rate motion with interlaced video\r
265       formats. This can be overridden by giving the PROGRESSIVE parameter.\r
266     + SPEED parameter now defines pixels per frame/field instead of half pixels\r
267       per frame. The scrolling direction is also reversed so SPEED 0.5 is the\r
268       previous equivalent of SPEED -1. Movements are done with subpixel accuracy\r
269     + Fixed incorrect starting position of image.\r
270     + Rounding error fixes to allow for more exact scrolling.\r
271     + Added support for motion blur via a new BLUR parameter\r
272     + Added PREMULTIPLY parameter to support images stored with straight alpha.\r
273 \r
274 \r
275 CasparCG 2.0 Stable (as compared to Beta 3)\r
276 ===========================================\r
277 \r
278 General\r
279 -------\r
280 \r
281   o Misc stability and performance fixes.\r
282 \r
283 Consumers\r
284 ---------\r
285 \r
286   o File Consumer\r
287     + Changed semantics to more closely follow FFmpeg (see forums).\r
288     + Added options, -r, -acodec, -s, -pix_fmt, -f and more.\r
289   o Screen Consumer\r
290     + Added vsync support.\r
291 \r
292 \r
293 CasparCG 2.0 Beta 3 (as compared to Beta 1)\r
294 ===========================================\r
295 \r
296 Formats\r
297 -------\r
298 \r
299   o ProRes Support\r
300     + Both encoding and decoding.\r
301   o NTSC Support\r
302     + Updated audio-pipeline for native NTSC support. Previous implementation\r
303       did not fully support NTSC audio and could cause incorrect behaviour or\r
304       even crashes.\r
305 \r
306 Consumers\r
307 ---------\r
308 \r
309   o File Consumer added\r
310     + See updated wiki or ask in forum for more information.\r
311     + Should support anything FFmpeg supports. However, we will work mainly with\r
312       DNXHD, PRORES and H264.\r
313     - Key-only is not supported.\r
314   o Bluefish Consumer\r
315     + 24 bit audio support.\r
316     - Embedded-audio does not work with Epoch cards.\r
317   o Decklink Consumer\r
318     + Low latency enabled by default.\r
319     + Added graphs for driver buffers.\r
320   o Screen Consumer\r
321     + Changed screen consumer square PAL to the more common wide-square PAL.\r
322     + Can now be closed.\r
323     + Fixed interpolation artifacts when running non-square video-modes.\r
324     + Automatically deinterlace interlaced input.\r
325 \r
326 Producers\r
327 ---------\r
328 \r
329   o Decklink Producer\r
330     + Improved color quality be avoiding uneccessary conversion to BGRA.\r
331   o FFMPEG Producer\r
332     + Fixed missing alpha for (RGB)A formats when deinterlacing.\r
333     + Updated buffering to work better with files with long audio/video\r
334       interleaving.\r
335     + Seekable while running and after reaching EOF. CALL 1-1 SEEK 200.\r
336     + Enable/disable/query looping while running. CALL 1-1 LOOP 1.\r
337     + Fixed bug with duration calculation.\r
338     + Fixed bug with fps calculation.\r
339     + Improved auto-transcode accuracy.\r
340     + Improved seeking accuracy.\r
341     + Fixed bug with looping and LENGTH.\r
342     + Updated to newer FFmpeg version.\r
343     + Fixed incorrect scaling of NTSC DV files.\r
344     + Optimized color conversion when using YADIF filters.\r
345   o Flash Producer\r
346     + Release Flash Player when empty.\r
347     + Use native resolution TemplateHost.\r
348     + TemplateHosts are now choosen automatically if not configured. The\r
349       TemplateHost with the corresponding video-mode name is now chosen.\r
350     + Use square pixel dimensions.\r
351 \r
352 AMCP\r
353 ----\r
354 \r
355   o When possible, commands will no longer wait for rendering pipeline. This\r
356     reduces command execution latencies, especially when sending a lot of\r
357     commands in a short timespan.\r
358   o Fixed CINF command.\r
359   o ADD/REMOVE no longer require subindex,\r
360     e.g. "ADD 1 SCREEN" / "REMOVE 1 SCREEN" instead of "ADD 1-1 SCREEN" / ...\r
361   o PARAM is renamed to CALL.\r
362   o STATUS command is replaced by INFO.\r
363   o INFO command has been extended:\r
364     + INFO (lists channels).\r
365     + INFO 1 (channel info).\r
366     + INFO 1-1 (layer info).\r
367     + INFO 1-1 F (foreground producer info).\r
368     + INFO 1-1 B (background producer info).\r
369     + INFO TEMPLATE mytemplate (template meta-data info, e.g. field names).\r
370   o CG INFO command has been extended.\r
371     + CG INFO 1 (template-host information, e.g. what layers are occupied).\r
372 \r
373 Mixer\r
374 -----\r
375 \r
376   o Fixed alpha with blend modes.\r
377   o Automatically deinterlace for MIXER FILL commands.\r
378 \r
379 Channel\r
380 -------\r
381 \r
382   o SET MODE now reverts back to old video-mode on failure.\r
383 \r
384 Diagnostics\r
385 -----------\r
386 \r
387   o Improved graphs and added more status information.\r
388   o Print configuration into log at startup.\r
389   o Use the same log file for the entire day, instead of one per startup as\r
390     previously.\r
391   o Diagnostics window is now closable.\r
392 \r
393 \r
394 CasparCG 2.0 Beta 1 (as compared to Alpha)\r
395 ==========================================\r
396 \r
397   o Blending Modes (needs to be explicitly enabled)\r
398     + overlay\r
399     + screen\r
400     + multiply\r
401     + and many more.\r
402   o Added additive keyer in addition to linear keyer.\r
403   o Image adjustements\r
404     + saturation\r
405     + brightness\r
406     + contrast\r
407     + min input-level\r
408     + max input-level\r
409     + min output-level\r
410     + max output-level\r
411     + gamma\r
412   o Support for FFmpeg-filters such as (ee http://ffmpeg.org/libavfilter.html)\r
413     + yadif deinterlacer (optimized in CasparCG for full multi-core support)\r
414     + de-noising\r
415     + dithering\r
416     + box blur\r
417     + and many more\r
418   o 32-bit SSE optimized audio pipeline.\r
419   o Decklink-Consumer uses external-key by default.\r
420   o Decklink-Consumer has 32 bit embedded-audio support.\r
421   o Decklink-Producer has 32 bit embedded-audio support.\r
422   o LOADBG with AUTO feature which automatically playes queued clip when\r
423     foreground clip has ended.\r
424   o STATUS command for layers.\r
425   o LOG LEVEL command for log filtering.\r
426   o MIX transitation work with transparent clips.\r
427   o Freeze on last frame.\r
428   o Producer buffering is now configurable.\r
429   o Consumer buffering is now configurable.\r
430   o Now possible to configure template-hosts for different video-modes.\r
431   o Added auto transcoder for FFmpeg producer which automatically transcodes\r
432     input video into compatible video format for the channel.\r
433     + interlacing (50p -> 50i)\r
434     + deinterlacing (50i -> 25p)\r
435     + bob-deinterlacing (50i -> 50p)\r
436     + bob-deinterlacing and reinterlacing (w1xh150i -> w2xh250i)\r
437     + doubling (25p -> 50p)\r
438     + halfing (50p -> 25p)\r
439     + field-order swap (upper <-> lower)\r
440   o Screen consumer now automatically deinterlaces when receiveing interlaced\r
441     content.\r
442   o Optimized renderer.\r
443   o Renderer can now be run asynchronously with producer by using a\r
444     producer-buffer size greater than 0.\r
445   o Improved error and crash recovery.\r
446   o Improved logging.\r
447   o Added Image-Scroll-Producer\r
448   o Key-only has now near zery performance overhead.\r
449   o Reduced memory requirements\r
450   o Removed "warm up lag" which occured when playing the first media clip after\r
451     the server has started.\r
452   o Added read-back fence for OpenGL device for improved multi-channel\r
453     performance.\r
454   o Memory support increased from standard 2 GB to 4 GB on 64 bit Win 7 OS.\r
455   o Added support for 2* Decklink cards in FullHD.\r
456   o Misc bugs fixes and performance improvements.\r
457   o Color producer now support some color codes in addition to color codes, e.g.\r
458     EMPTY, BLACK, RED etc...\r
459   o Alpha value in color codes is now optional.\r
460   o More than 2 Decklink cards might be possible but have not yet been tested.\r
461 \r
462 \r
463 CasparCG 2.0 Alpha (as compared to 1.8)\r
464 =======================================\r
465 \r
466 General\r
467 -------\r
468 \r
469   o Mayor refactoring for improved readability and mainainability.\r
470   o Some work towards platorm-independence. Currently the greatest challenge for\r
471     full platform-independence is flash-producer.\r
472   o Misc improved scalability.\r
473   o XML-configuration.\r
474   o Decklink\r
475     + Support for multiple DeckLink cards.\r
476 \r
477 Core\r
478 ----\r
479 \r
480   o Multiple producers per video_channel.\r
481   o Multiple consumers per video_channel.\r
482   o Swap producers between layers and channels during run-time.\r
483   o Support for upper-field and lower-field interlacing.\r
484   o Add and remove consumers during run-time.\r
485   o Preliminary support for NTSC.\r
486 \r
487 AMCP\r
488 ----\r
489 \r
490   o Query flash and template-host version.\r
491   o Recursive media-folder listing.\r
492   o Misc changes.\r
493 \r
494 Mixer\r
495 -----\r
496 \r
497   o Animated tween transforms.\r
498   o Image-Mixer\r
499     + Fully GPU accelerated (all features listed below are done on the gpu),\r
500     + Layer composition.\r
501     + Colorspaces (rgba, bgra, argb, yuv, yuva, yuv-hd, yuva-hd).\r
502     + Interlacing.\r
503     + Per-layer image-transforms:\r
504       + Opacity\r
505       + Gain\r
506       + Scaling\r
507       + Clipping\r
508       + Translation\r
509   o Audio-Mixer\r
510     + Per-layer and per-sample audio-transforms:\r
511         + Gain\r
512     + Fully internal audio-mixing. Single output-video_channel.\r
513 \r
514 Consumers\r
515 ---------\r
516 \r
517   o Decklink-Consumer\r
518     + Embedded audio.\r
519     + HD support.\r
520     + Hardware clock.\r
521   o Bluefish-Consumer\r
522     + Drivers are loaded on-demand (server now runs on computers without\r
523       installed bluefish-drivers).\r
524     + Embedded-audio.\r
525     + Allocated frames are no longer leaked.\r
526 \r
527 Producers\r
528 ---------\r
529 \r
530   o Decklink-Producer\r
531     + Embedded audio.\r
532     + HD support.\r
533   o Color-Producer\r
534     + GPU accelerated.\r
535   o FFMPEG-Producer\r
536     + Asynchronous file IO.\r
537     + Parallel decoding of audio and video.\r
538     + Colorspace transform are moved to gpu.\r
539   o Transition-Producer\r
540     + Fully interlaced transition (previsously only progressive, even when\r
541       running in interlaced mode).\r
542     + Per-sample mixing between source and destination clips.\r
543     + Tween transitions.\r
544   o Flash-Producer\r
545     + DirectDraw access (sligthly improved performance).\r
546     + Improved time-sync. Smoother animations and proper interlacing.\r
547   o Image-Producer\r
548     + Support for various imageformats through FreeImage library.\r
549 \r
550 Diagnostics\r
551 -----------\r
552 \r
553   o Graphs for monitoring performance and events.\r
554   o Misc logging improvements.\r
555   o Seperate log-file for every run of the server.\r
556   o Error logging provides full exception details, instead of only printing that\r
557     an error has occured.\r
558   o Console with real-time logging output.\r
559   o Console with AMCP input.\r
560 \r
561 Removed\r
562 -------\r
563 \r
564   o Registry-configuration (replaced by XML-Configuration).\r
565   o TGA-Producer (replaced by Image-Producer).\r
566   o TGA-Scroll-Producer\r