Monday, 2017-11-06

rgareusColaEuphoria: only users who have old graphics cards00:02
rgareusfrom a LV2 and also portability POV it's sane.  -- another plugin graphics stack that needs OGL 3.x shaders is https://github.com/wrl/rutabaga00:03
ColaEuphoriait's just that, surely fixed function works, but i feel like the buffer objects and array objects of 3+ can offload more work to the gpu and leave more cpu for audio processing00:56
rgareusColaEuphoria: most lv2/pugl-based plugins just map a single texture (shared memory) and render onto it using cairo00:58
rgareusthe same concept is also used for some commercial/proprietary openGL plugins00:58
*** Yruama_Lairba has quit IRC01:16
*** diqidoq has quit IRC02:40
*** artfwo has quit IRC03:24
*** artfwo has joined #lv203:34
*** NickSB has quit IRC03:51
*** artfwo has quit IRC06:31
*** johmue has quit IRC06:31
*** wumpus has quit IRC06:31
*** artfwo has joined #lv207:12
*** johmue has joined #lv207:12
*** wumpus has joined #lv207:12
*** doublemetres[m] has quit IRC07:18
*** unclechu has quit IRC07:22
*** wumpus has quit IRC08:40
*** wumpus has joined #lv208:55
*** sigma6 has joined #lv209:03
*** doublemetres[m] has joined #lv209:15
*** doublemetres[m] has quit IRC09:37
*** doublemetres[m] has joined #lv209:44
*** unclechu has joined #lv210:11
*** edo_pc has joined #lv210:52
*** Yruama_Lairba has joined #lv211:17
*** m4l3z has joined #lv211:20
*** diqidoq has joined #lv211:56
*** NickSB has joined #lv212:23
*** edo_pc has quit IRC13:15
*** stever has quit IRC13:23
*** stever has joined #lv213:23
*** diqidoq has quit IRC17:14
*** sigma6 has quit IRC17:29
*** oofus has joined #lv218:15
*** NickSB has quit IRC18:33
*** NickSB has joined #lv218:33
*** oofus has quit IRC18:50
*** oofus has joined #lv218:52
ssj71hmm. I don't like this: https://docs.google.com/document/d/1DCp2u-toDDQiwBq4zPzYN3AfyKpJKFKssawcoUj-Udc/edit19:00
*** oofus has quit IRC19:04
ssj71IMHO the breaks the doap#description meaning19:06
ssj71in a ttl string do you just have mupltiple lines or put \n characters in? I've never done a line break in one...19:15
ssj71https://forum.moddevices.com/t/the-infamous-stuck-round-2/1804/3?u=ssj7119:29
ssj71I'm curious to know everyone's thoughts on whether this is "proper" or not19:35
m4l3zi don't know if the 2-4 lines if really an issue ssj7119:46
m4l3zis*19:46
m4l3zThey seem to go beyond that in their examples19:48
rgareusssj71: I think it's good to keep all documentation centralized (write once) and include it with the plugin19:52
rgareusssj71: I tend to document plugin-ports and provide a small reference manual in the plugin's description19:52
rgareusbut explicily line-breaks should be avoided (assuming a given line-length break layout for various hosts)19:57
rgareusIn ttl, multi-line is easiest done by tripple quotes      <URI>  """  RAW MULTI-LINE TEXT HERE   """ .20:00
rgareussee https://www.w3.org/TR/turtle/#turtle-literals20:01
*** unclechu has quit IRC20:15
*** doublemetres[m] has quit IRC20:15
ssj71m4l3z: who does, mod? or doap?20:19
ssj71rgareus: I feel mod isn't utilizing that documentation but instead wants it duplicated in the description. Or am I reading it wrong?20:19
rgareusssj71: doap:description  does sound the right place to put doc. describe how to use the plugin and describe what it does20:22
ssj71rgareus: so you think their guide is a good idea?20:22
rgareusssj71: I think it's actually drobilla's idea, a bit extended20:22
ssj71rgareus: ok, if you and drobilla are fine with it I don't care that much20:23
rgareusdrobilla doesn't use line-breaks or specific formatting, nor do I20:23
ssj71rgareus: how would you do the multiple paragraph form they recommend?20:24
rgareusssj71: I probably wouldn't :)20:24
m4l3zssj71: doap20:25
m4l3zssj71: https://github.com/ewilderj/doap/blob/master/examples/redland-doap.rdf20:26
rgareusssj71: a one line summary, like the convention used for git commits may would make sense IFF there wasn't a plugin-name already20:26
m4l3zhttps://github.com/ewilderj/doap/blob/master/examples/doap-doap.turtle20:26
rgareusssj71: but I'm not a fan of explicit paragraphs in the description.20:26
ssj71rgareus: that is exactly what mod is recommending/requiring to get plugins to the store...20:27
rgareusmeh20:27
rgareuscompare to drobilla's fomp,  or e.g  https://github.com/x42/fat1.lv2/blob/master/lv2ttl/fat1.ttl.in#L28   https://github.com/x42/fat1.lv2/blob/master/lv2ttl/fat1.ttl.in#L10920:28
ssj71I have a similar description and they are saying its inadequate20:29
ssj71I propose we keep descriptions of that nature and longer more "marketing" type documentation in an rdfs:comment or something20:29
ssj71rgareus: did you read through that doc I linked above?20:30
rgareusssj71: no :)20:30
rgareusssj71: I read the forum, not the g-doc20:30
ssj71rgareus: I was just trying to provide some more context20:30
ssj71I don't like what they are recommending and what may become the status-quo for lv2 plugins20:31
m4l3zwhat is it you don't like ?20:31
ssj71but if the community thinks its fine I'm not going to fight it20:31
ssj71m4l3z: doap:description """ Open Big Muff   Open Big Muff is inspired by the classic Electro-Harmonix Big Muff Pi*. This massive pedal has defined the sound of rock guitar!  Throughout the late 1960s and early 1970s the fuzz revolution took place spicing up rock and roll music. The Electro-Harmonix Big Muff Pi* was one of its greatest representatives.   It's rich tone and creamy, violin-like sustain made its name among legends of all tim20:32
ssj71"""20:32
ssj71except the copy paste lost the linebreaks20:32
rgareusthey also recommend to document controls in the description?  that's weird, the MOD already shows doc for each control in the tooltip20:32
ssj71rgareus: exactly, now you are seeing more of why I'm pushing back a little20:33
rgareusssj71: OK, you're right their proposal is mostly BS.20:33
ssj71thank you :)20:33
rgareus1. wrong -- the title should not be in the description. there's already a plugin-name20:34
ssj71I see their motivation, they want the plugins to sell themselves a little so that they can move hardware20:34
rgareus2. wrong -- there's explicit ttl description for the author .20:34
rgareus3. tagline. that's kinda ok.  -- but why only if "deserved" ?!20:34
rgareus4. odd.  nobody cares about historical context when you want to *use* a plugin20:35
m4l3zi agree (4)20:35
rgareus5 "What it does"  hmm yeah.. I guess that's good idea.20:35
ssj71they want us to write marketing material20:37
rgareusI guess (4) is a gray area.  if you emulate - say - a 1970 vintage effect it can be mentioned.  as  part of (5)20:37
rgareustheir examples are not great IMHO20:38
* rgareus closes the g-doc20:38
ssj71rgareus: if you care to comment on the forum I think we can nip it in the bud20:39
rgareus"Simple volume gain without "zipping" noise while messing with the gain parameter"    -- worst description, ever20:40
rgareusapparently they didn't like   https://github.com/x42/tinyamp.lv2/blob/master/lv2ttl/tinygain.ttl.in#L26-L32  (which interestinly does have a title + newline20:41
rgareusmea culpla20:41
m4l3zwhat host actually shows those info ?20:42
rgareusssj71: since falktx left MOD, I kinda lost interest20:42
rgareusm4l3z: I know that Ardour does,  jalv shows per-port doc in the tooltips20:42
rgareusthe MOD-host shows it. I think Carla does, too20:43
ssj71rgareus: I just worry that that document is going to become percieved as lv2 cannon by developers that take interest in MOD20:43
m4l3zcan't see where20:46
rgareusssj71: I'm working on a longer reply20:52
ssj71m4l3z: those are all still only a few sentences mod is proposing several short paragraphs and even bullet style feature lists21:10
m4l3ztrue21:18
*** m4l3z has quit IRC21:23
*** m4l3z has joined #lv221:24
rgareusssj71: sent21:24
* ssj71 goes to check it out21:25
ssj71rgareus: for the 3. "if deserved" non-sense, couldn't the doap:shortdesc be used for that?21:29
ssj71I think they could compose most of that (or a sensible version at least) by just combining existing ttl fields21:30
ssj71if there are port doc descriptions put a list of them at the bottom21:31
ssj71etc21:31
rgareusssj71: yes and yes :)21:57
rgareusssj71: there's a half-baked project (https://github.com/x42/lv2toweb)  that can generate a html from lv2 ttl21:58
rgareusexample:  http://x42.github.io/midifilter.lv2/http___gareus_org_oss_lv2_midifilter_mididelay.html21:59
*** doublemetres[m] has joined #lv221:59
rgareusincluding the port-range and scale-points is perhaps overkill in the html doc22:00
ssj71yeah that doesn't market well22:00
rgareusalso it does't have a proper CSS style..22:00
ssj71its an unfortunate thing that marketing works. I much prefer if it didn't and then things would just be written clearly22:00
rgareusanyway, the key point is that (1) description/doc should be "host-neutral" running text in the .ttl.  (2) other information as sematic meta-data.22:04
rgareustoo bad it's too late for a Jimi Hendrix Signature LV2 Plugins :)22:07
*** stanley has joined #lv222:11
*** stanley has quit IRC22:49
*** doublemetres[m] has quit IRC23:00
*** doublemetres[m] has joined #lv223:14
*** doublemetres[m] has quit IRC23:35
*** doublemetres[m] has joined #lv223:55

Generated by irclog2html.py 2.13.0 by Marius Gedminas - find it at mg.pov.lt!