# Which sample opts can we control?

**URL:** <https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625>\
**Category:** \[P\] Patreon Support\
**Created:** [April 12, 2020, 12:27pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625 "2020-04-12T12:27:57Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![nlb](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/nlb/32/997_2.png) [@nlb](https://in-thread.sonic-pi.net/u/nlb)\
**Post date:** [April 12, 2020, 12:27pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/1 "2020-04-12T12:27:58Z")

</div>

hi,

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/sonic_pi/original/2X/8/87008935821cedbaca8806820c4b6e261cb0ae3d.png)

Where can we find in the doc the available options we can control ?

Cheers !

---

<div class="post-metadata">

**Author:** ![ethancrawford](https://avatars.discourse-cdn.com/v4/letter/e/a88e4f/32.png) [@ethancrawford](https://in-thread.sonic-pi.net/u/ethancrawford)\
**Post date:** [April 12, 2020, 12:45pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/2 "2020-04-12T12:45:44Z")

</div>

Hi @nlb 🙂  
In the ‘Samples’ help section.  
If you browse one of the sample categories, and scroll down to where it lists all the information about each sample opt, underneath where it describes what the opt is, are some comments listing the constraints and allowances that the opt has:

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/sonic_pi/original/2X/f/ffc608633047a20a8b015990c66bb33ee758217b.png)  
What you are interested in is one of these - if an opt is available to change with `control`, then it will have the message ‘May be changed whilst playing’ listed there.

(The same thing applies for Synth and FX in their parts of the documentation).

---

<div class="post-metadata">

**Author:** ![nlb](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/nlb/32/997_2.png) [@nlb](https://in-thread.sonic-pi.net/u/nlb)\
**Post date:** [April 12, 2020, 1:46pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/3 "2020-04-12T13:46:07Z")

</div>

ok thank you @ethancrawford but wouldn’t it be better to have a more “visible” sign  
Search with eyes the keyword "whilst " is a bit hazardous no ?  
Is there a hope for a `find ` command into spi gui ? It would be great to navigate among the different variables occurences as example or among serached keywords.

So to find the opts avaiable i think of using the tutorial online html version and `ctrl` + `F`

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/sonic_pi/original/2X/0/0087886d601655d8da4b3f5731d65818b85a41f5.png)

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/sonic_pi/original/2X/e/e5969f1a2baad09abe126e21f4f0c7676d4d50df.png)

i didn’t find lot of things.

So is the `lang` part of the doc included into the gui is available online ?  
 ![image](https://europe1.discourse-cdn.com/flex017/uploads/sonic_pi/original/2X/f/f82ca359607f00526ef6c1ed0e2b6db49b7ab216.png)

Cheers

---

<div class="post-metadata">

**Author:** ![ethancrawford](https://avatars.discourse-cdn.com/v4/letter/e/a88e4f/32.png) [@ethancrawford](https://in-thread.sonic-pi.net/u/ethancrawford)\
**Post date:** [April 12, 2020, 2:15pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/4 "2020-04-12T14:15:10Z")

</div>

No, only the tutorial is available online.

I would ideally like to see _all_ of the documentation available online at some point, but whether that will happen is firstly up to Sam and whether he is happy with the idea, and then down to someone (or several people) having the time to work on it. Currently the online tutorial has a bit of manual work to transform it for web viewing - it would be great if there was a way to make it easy to reuse the documentation between the app and the web with the least amount of manual fiddling necessary 🙂

---

<div class="post-metadata">

**Author:** ![nlb](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/nlb/32/997_2.png) [@nlb](https://in-thread.sonic-pi.net/u/nlb)\
**Post date:** [April 12, 2020, 2:16pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/5 "2020-04-12T14:16:48Z")

</div>

ok does the doc included into the gui is in markdown format ?

---

<div class="post-metadata">

**Author:** ![ethancrawford](https://avatars.discourse-cdn.com/v4/letter/e/a88e4f/32.png) [@ethancrawford](https://in-thread.sonic-pi.net/u/ethancrawford)\
**Post date:** [April 12, 2020, 2:29pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/6 "2020-04-12T14:29:03Z")

</div>

The tutorial is initially present as markdown files, which are transformed into html when the app is built.  
The other help sections are generated at the same time from various sources including some of the ruby files (synthinfo.rb).  
As such it would currently not be a simple matter to generate all of the documentation for a web format with the same method - some work would need to be done to simplify things first.  
(I have been thinking about a way to do something like this for a related issue - I would like to be able to have part or all of the documentation loaded in when Sonic Pi starts up, or while the app is running rather than compile-time).

---

<div class="post-metadata">

**Author:** ![nlb](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/nlb/32/997_2.png) [@nlb](https://in-thread.sonic-pi.net/u/nlb)\
**Post date:** [April 12, 2020, 2:36pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/7 "2020-04-12T14:36:40Z")

</div>

ok thank you for these precisions !

---

<div class="post-metadata">

**Author:** ![nlb](https://dub1.discourse-cdn.com/flex017/user_avatar/in-thread.sonic-pi.net/nlb/32/997_2.png) [@nlb](https://in-thread.sonic-pi.net/u/nlb)\
**Post date:** [April 12, 2020, 4:24pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/8 "2020-04-12T16:24:08Z")

</div>

> [@ethancrawford](#):
>
> each sample opt

i haven’t read correctly your post…

 ![image](https://europe1.discourse-cdn.com/flex017/uploads/sonic_pi/original/2X/2/288d0de6b2637ffbe90fe3b5c86a30a85f9f9626.png)

So a workaround is to `ctrl` + `a` the doc for the sample family and then paste into your favorite editor and `¢trl` + `F`.

So now, i got another question : which parameters are available for external samples from other providers ?  
Cheers

---

<div class="post-metadata">

**Author:** ![ethancrawford](https://avatars.discourse-cdn.com/v4/letter/e/a88e4f/32.png) [@ethancrawford](https://in-thread.sonic-pi.net/u/ethancrawford)\
**Post date:** [April 12, 2020, 11:54pm UTC](https://in-thread.sonic-pi.net/t/which-sample-opts-can-we-control/3625/9 "2020-04-12T23:54:28Z")

</div>

It is the same for built in samples and external samples.
