| Both sides previous revision Previous revision | |
| softwares:giocoso:adminmenu:settings [2026/02/16 13:26] – [3.0 Parameters requiring Text Values] hjr | softwares:giocoso:adminmenu:settings [2026/03/24 13:44] (current) – [Table] hjr |
|---|
| Since there are quite a few of these sorts of parameters, I'll go through them in table form: | Since there are quite a few of these sorts of parameters, I'll go through them in table form: |
| |
| ^ Parameter Name ^ Parameter Meaning ^ Description ^ | ^ Parameter Name ^ Parameter Meaning ^ Description ^ |
| |Number of plays per cycle|How many random selections of music does Giocoso make in one 'session', before terminating all playback?|Default value is 1: each play effectively stops Giocoso in its tracks. I like a decent number of plays in succession, so I've set mine in the screenshot to 10, meaning I listen to 10 different recordings, one after the other, before having to interact with Giocoso again.| | | Number of plays per cycle | How many random selections of music does Giocoso make in one 'session', before terminating all playback? | Default value is 1: each play effectively stops Giocoso in its tracks. I like a decent number of plays in succession, so I've set mine in the screenshot to 10, meaning I listen to 10 different recordings, one after the other, before having to interact with Giocoso again. | |
| |Hours before composer eligible|How many hours must elapse between plays of music by the same composer?|This is the 'time bar'. By default, it's 6 hours, meaning that if Wagner is played at 9AM, he can't be played again until at least 3PM. Setting this parameter to 0 means switching the time bar off completely: a piece of Mozart could be followed immediately by another piece by Mozart. At non-zero values, the parameter is designed to stop Giocoso randomly selecting work by the same composer over and over again.| | | Hours before composer eligible | How many hours must elapse between plays of music by the same composer? | This is the 'time bar'. By default, it's 6 hours, meaning that if Wagner is played at 9AM, he can't be played again until at least 3PM. Setting this parameter to 0 means switching the time bar off completely: a piece of Mozart could be followed immediately by another piece by Mozart. At non-zero values, the parameter is designed to stop Giocoso randomly selecting work by the same composer over and over again. | |
| |Minimum length of play|How many minutes must a recording (in total) last for, before it can be selected for playback?|The default value is 0, meaning 'any recording of whatever length is a candidate for random selection'. Note that it's the folder that's evaluated for duration when working out if it meets the minimum duration threshold. That is, if you have 4 tracks of a symphony each lasting 3 minutes, and you set this parameter to (say) 10, then the symphony is allowed to be played: its total duration of 12 minutes exceeds the threshold.| | | Minimum length of play | How many minutes must a recording (in total) last for, before it can be selected for playback? | The default value is 0, meaning 'any recording of whatever length is a candidate for random selection'. Note that it's the folder that's evaluated for duration when working out if it meets the minimum duration threshold. That is, if you have 4 tracks of a symphony each lasting 3 minutes, and you set this parameter to (say) 10, then the symphony is allowed to be played: its total duration of 12 minutes exceeds the threshold. | |
| |Maximum length of play|How many minutes must a recording (in total) last less than, for it to be a valid candidate for playback?|The default value is 525960, which is the number of minutes in a year if 365.25 days! That's longer than any recording in existence of course, so effectively the default means 'all recordings, whatever their length, are valid candidates to be randomly selected'. Set it to (say) 120, however, and you're saying that anything that lasts, in total, for more than 120 minutes (2 hours) cannot be selected for playback. This is a way to stop Wagner operas being randomly selected for playback, for example. As with the minimum length of play parameter, a folder's total duration is assessed when determining if it's an acceptable candidate for selection. Lots of short tracks are added together to work out that the recording as a whole exceeds the threshold, for example.| | | Maximum length of play | How many minutes must a recording (in total) last less than, for it to be a valid candidate for playback? | The default value is 525960, which is the number of minutes in a year if 365.25 days! That's longer than any recording in existence of course, so effectively the default means 'all recordings, whatever their length, are valid candidates to be randomly selected'. Set it to (say) 120, however, and you're saying that anything that lasts, in total, for more than 120 minutes (2 hours) cannot be selected for playback. This is a way to stop Wagner operas being randomly selected for playback, for example. As with the minimum length of play parameter, a folder's total duration is assessed when determining if it's an acceptable candidate for selection. Lots of short tracks are added together to work out that the recording as a whole exceeds the threshold, for example. | |
| |Screen width|How many pixels does your screen or monitor use to display in the horizontal direction?|Defaults to 1920. The parameter helps controls where on the screen an independent album art window will display, should you configure to use one. By making the parameter value bigger than your actual screen width, you cause the album art window to be pushed over to the right. By making it smaller, the window gets pushed over to the left. When both the screen width and height parameters are set to their correct, actual physical values, the album art window is meant to appear in the lower-centre of the screen.| | | Screen width | How many pixels does your screen or monitor use to display in the horizontal direction? | Defaults to 1920. The parameter helps controls where on the screen an independent album art window will display, should you configure to use one. By making the parameter value bigger than your actual screen width, you cause the album art window to be pushed over to the right. By making it smaller, the window gets pushed over to the left. When both the screen width and height parameters are set to their correct, actual physical values, the album art window is meant to appear in the lower-centre of the screen. | |
| |Screen height|How many pixels does your screen or monitor use to display in the vertical direction?|Defaults to 1080. The parameter helps controls where on the screen an independent album art window will display, should you configure to use one. By making the parameter value bigger than your actual screen height, you cause the album art window to be pushed downwards. By making it smaller, the window gets pushed upwards. When both the screen width and height parameters are set to their correct, actual physical values, the album art window is meant to appear in the lower-centre of the screen.| | | Screen height | How many pixels does your screen or monitor use to display in the vertical direction? | Defaults to 1080. The parameter helps controls where on the screen an independent album art window will display, should you configure to use one. By making the parameter value bigger than your actual screen height, you cause the album art window to be pushed downwards. By making it smaller, the window gets pushed upwards. When both the screen width and height parameters are set to their correct, actual physical values, the album art window is meant to appear in the lower-centre of the screen. | |
| |Size of Album Art|How many pixels wide and high should album art imagery be displayed at?|Defaults to 340. The parameter only takes one value, and then duplicates it for the other dimension. In other words, a value of 340 is converted into an image size of 340x340 pixels: Giocoso always expects to work with square album art imagery! You may need to play around with this parameter as you start working with Giocoso: the album art is usually displayed on the right-side of the main program window when something is playing and it may or may not fit that display area, depending on your terminal, its choice of font and font size and so on. The default of 340 has been set so that if you use the Xterm terminal and the fonts installed by Giocoso for the purpose, in-terminal album art should appear correctly. A 50-pixel high 'caption bar' is automatically added to the bottom of the actual album art: it displays text indicating the composer name and the composition/recording name being played. By default, therefore, you'd end up with a 340x390 piece of album art (that is, 340 pixels wide and 390 high).| | | Size of Album Art | How many pixels wide and high should album art imagery be displayed at? | Defaults to 340. The parameter only takes one value, and then duplicates it for the other dimension. In other words, a value of 340 is converted into an image size of 340x340 pixels: Giocoso always expects to work with square album art imagery! You may need to play around with this parameter as you start working with Giocoso: the album art is usually displayed on the right-side of the main program window when something is playing and it may or may not fit that display area, depending on your terminal, its choice of font and font size and so on. The default of 340 has been set so that if you use the Xterm terminal and the fonts installed by Giocoso for the purpose, in-terminal album art should appear correctly. A 50-pixel high 'caption bar' is automatically added to the bottom of the actual album art: it displays text indicating the composer name and the composition/recording name being played. By default, therefore, you'd end up with a 340x390 piece of album art (that is, 340 pixels wide and 390 high). | |
| |Seconds to wait before playback starts|Time to wait *after* selecting something to play before actually starting to play it.|Defaults to 0. If set to (say) 120, then Giocoso will select something new to play immediately, but a countdown timer will mean it waits for 2 minutes before beginning to play it. The point is to be able to see what's about to be played and to give you a chance (for example) to get the score for that work in hand before the music actually starts playing.| | | Seconds to wait before playback starts | Time to wait *after* selecting something to play before actually starting to play it. | Defaults to 0. If set to (say) 120, then Giocoso will select something new to play immediately, but a countdown timer will mean it waits for 2 minutes before beginning to play it. The point is to be able to see what's about to be played and to give you a chance (for example) to get the score for that work in hand before the music actually starts playing. | |
| | | Size of the Program Logo | Size of the program logo graphic displayed on the main program display, in pixels. | Defaults to 220. Determines how big the program logo (the little picture of Beethoven) appears on the right-hand of the screen. The supplied value is used to determine both height and width, so a value of 180 would turn into a square image of 180 x 180 pixels. | |
| | | Program Logo position (- or +) | Left or right position of the program logo graphic, in characters. | Defaults to 0. Shifts the program logo to the left (with negative numbers) or right (with positive ones), by as many characters as the number supplied. A value of -5 means 'move it five characters to the left'; a value of 8 means 'move it eight characters to the right'. Positive numbers should not use the '+' sign, but negative numbers will need to specify the '-' one. | |
| |
| ===== 5.0 Parameters requiring Yes/No Values ===== | ===== 5.0 Parameters requiring Yes/No Values ===== |