Skip to content

Commit

Permalink
readme
Browse files Browse the repository at this point in the history
  • Loading branch information
porres committed Sep 24, 2024
1 parent 58e60ee commit 2e91693
Show file tree
Hide file tree
Showing 11 changed files with 70 additions and 67 deletions.
51 changes: 25 additions & 26 deletions Documentation/Extra-files/All_about_else.pd
Original file line number Diff line number Diff line change
Expand Up @@ -39,28 +39,29 @@
#X text 175 166 Check [declare]'s help file for more information., f 27;
#X text 33 213 Also \, check the [else] object and its help file \, which carries more information about the library:, f 55;
#X obj 160 453 else/openfile -h https://github.com/porres/pd-else/issues;
#N canvas 558 286 460 535 all 0;
#X obj 59 28 inlet;
#X msg 208 114 version;
#X obj 214 199 symbol;
#X obj 59 244 file which;
#X obj 59 451 file splitname;
#X msg 59 480 \; pd open \$2 \$1;
#X obj 247 168 t s;
#X obj 154 231 t s b;
#X obj 154 256 spigot;
#X msg 214 257 1;
#X obj 154 341 pdcontrol;
#X obj 154 288 file splitname;
#X obj 154 400 file normalize;
#X obj 154 373 file which;
#X msg 154 311 dir 0 ../9.else/\$2;
#X obj 214 230 sel plugdata Pd-Vanilla;
#X obj 208 81 loadbang;
#X obj 288 296 print;
#X msg 286 264 ??????;
#X obj 208 135 else;
#X msg 59 174 symbol else/All_objects.pd;
#X obj 237 329 bng 22 250 50 0 empty empty empty 0 -8 0 10 #dfdfdf #000000 #000000;
#N canvas 558 286 432 535 all_objects 0;
#X obj 67 18 inlet;
#X msg 254 104 version;
#X obj 242 189 symbol;
#X obj 67 234 file which;
#X obj 67 441 file splitname;
#X msg 67 470 \; pd open \$2 \$1;
#X obj 275 158 t s;
#X obj 182 221 t s b;
#X obj 182 246 spigot;
#X msg 242 247 1;
#X obj 182 331 pdcontrol;
#X obj 182 278 file splitname;
#X obj 182 390 file normalize;
#X obj 182 363 file which;
#X msg 182 301 dir 0 ../9.else/\$2;
#X obj 242 220 sel plugdata Pd-Vanilla;
#X obj 254 79 loadbang;
#X obj 309 276 print;
#X msg 309 244 ??????;
#X obj 254 125 else;
#X msg 67 164 symbol else/All_else_objects.pd;
#X connect 0 0 20 0;
#X connect 1 0 19 0;
#X connect 2 0 15 0;
Expand All @@ -78,11 +79,9 @@
#X connect 13 0 12 0;
#X connect 14 0 10 0;
#X connect 15 0 9 0;
#X connect 15 1 18 0;
#X connect 16 0 1 0;
#X connect 18 0 17 0;
#X connect 19 2 6 0;
#X connect 20 0 3 0;
#X restore 237 367 pd all objects;
#X obj 237 329 bng 22 250 50 0 empty empty empty 0 -8 0 10 #dfdfdf #000000 #000000;
#X connect 38 0 37 0;
#X restore 237 367 pd all_objects;
#X connect 37 0 38 0;
File renamed without changes.
2 changes: 1 addition & 1 deletion Documentation/Extra-files/CHANGELOG.txt
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Breaking changes:
- [sfont~] uses now a simpler build system and this might not load very very rare and unusual sound formats.

Enhancements/fixes/other changes:
- builds for double precision is now supported and provided, by the way, the build system was changed from pd-lib-builder to pd.build by Pierre Guillot.
- builds for double precision is now supposedly supported, by the way, the build system was changed from pd-lib-builder to pd.build by Pierre Guillot.
- [play.file~] is now a compiled object instead of an abstraction thanks to Tim Schoen, and it supports MP3, FLAC, WAV, AIF, AAC, OGG & OPUS file extensions.
- Support for double precision compilation was improved and should be working for all objects (not yet providing binaries and fully tested yet by the way).
- The ELSE binary now loads a modified version of [pdlua], but no [pdlua] and [pdluax] objects are provided.
Expand Down
35 changes: 20 additions & 15 deletions Documentation/Extra-files/README.deken.pd
Original file line number Diff line number Diff line change
@@ -1,4 +1,7 @@
#N canvas 300 33 863 570 12;
#N struct 1007-cell float x float y float cellsize float color;
#N struct 1009-point float x0 float y0 float xs float ys float fg float in float gridx float gridy;
#N struct 1062-slot float x float y float slotsize float color float width float bordercolor;
#N canvas 349 48 856 601 12;
#X obj 73 25 cnv 15 250 40 empty empty empty 12 13 0 18 #7c7c7c #e0e4dc 0;
#N canvas 382 141 749 319 (subpatch) 0;
#X coords 0 -1 1 1 252 42 2 100 100;
Expand All @@ -11,21 +14,23 @@
#X obj 269 47 cnv 10 10 10 empty empty library 0 6 2 13 #7c7c7c #e0e4dc 0;
#X text 133 75 by Porres & others;
#X text 25 335 ELSE is shipped with a huge and general computer music tutorial that depends on the library. Find the folder named Live-Electronics-Tutorial inside the else folder and check its readme., f 52;
#X text 454 42 Please consider supporting this project by paying me a monthly coffe \, or beer \, or some other cheap drug on Patreon., f 50;
#X obj 479 105 else/openfile -h https://www.patreon.com/porres;
#X text 463 388 ELSE is also part of the amazing PlugData project by Tim Schoen. Check it out!, f 49;
#X obj 672 412 else/openfile -h https://plugdata.org/;
#X text 467 139 You can also send me some cash on paypal:;
#X text 698 104 <-- click;
#X text 467 192 Brasileiros podem apoiar mandando PIX:;
#X text 640 215 el.locus.solus@gmail.com;
#X text 651 157 mentalosmosis@yahoo.com;
#X text 449 48 Please consider supporting this project by paying me a monthly coffe \, or beer \, or some other cheap drug on Patreon., f 50;
#X obj 474 111 else/openfile -h https://www.patreon.com/porres;
#X text 458 394 ELSE is also part of the amazing PlugData project by Tim Schoen. Check it out!, f 49;
#X obj 667 418 else/openfile -h https://plugdata.org/;
#X text 462 145 You can also send me some cash on paypal:;
#X text 693 110 <-- click;
#X text 462 198 Brasileiros podem apoiar mandando PIX:;
#X text 635 221 el.locus.solus@gmail.com;
#X text 646 163 mentalosmosis@yahoo.com;
#X text 25 234 To use the browser plugin \, right click on an empty space on the patch canvas and check entry menus for 'vanilla' and 'else' \, which will allow you to choose and add the desired object in the spot you right clicked on. The objects are separated by categories and is a nice way to check the objects in ELSE., f 52;
#X obj 468 301 else/openfile -h https://www.instagram.com/alexandre.torres.porres/;
#X text 467 249 I post lots of Pd stuff in my instagram \, you can follow me if you like for some ELSE news and more stuff:, f 48;
#X obj 529 349 else/openfile -h https://www.instagram.com/el.locus.solus/;
#X text 469 328 sometimes it is named as:;
#X obj 463 307 else/openfile -h https://www.instagram.com/alexandre.torres.porres/;
#X text 462 255 I post lots of Pd stuff in my instagram \, you can follow me if you like for some ELSE news and more stuff:, f 48;
#X obj 524 355 else/openfile -h https://www.instagram.com/el.locus.solus/;
#X text 464 334 sometimes it is named as:;
#X obj 258 421 All_about_else;
#X text 65 421 Check for more details -->;
#X text 25 123 Hey \, you downloaded the 'ELSE' library from 'deken' \, nice! This is a library mostly composed of separate binaries \, so you need to add its path to your search paths. You must also load the 'else' binary as a library \, which will give you some information on the terminal \, install an object browser plugin and allow 'lua' scripting., f 52;
#X text 248 483 Note: - If you already had an earlier version of ELSE installed when you downloaded this version \, you have to restart Pure Data for some changes to take effect!!!, f 63;
#X text 252 511 Note: - If you already had an earlier version of ELSE installed when you downloaded this version \, you have to restart Pure Data for some changes to take effect!!!, f 63;
#X text 72 452 Check for all objects -->;
#X obj 257 452 All_else_objects;
2 changes: 1 addition & 1 deletion Documentation/Extra-files/else-meta.pd
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@
#X text 37 59 DESCRIPTION: multi purpose / swiss army knife / general signal modules and building blocks for audio and general patching, f 47;
#X text 37 156 AUTHOR: Alexandre Torres Porres 2017-2024, f 47;
#X text 37 105 VERSION: 1.0-0_release_candidate_12, f 47;
#X text 37 122 RELEASE DATE: August 6th 2024, f 47;
#X text 37 122 RELEASE DATE: September 23rd 2024, f 47;
23 changes: 10 additions & 13 deletions Documentation/Help-files/else-help.pd
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
#N canvas 426 23 562 535 10;
#N canvas 426 38 561 492 10;
#X declare -path else -lib else;
#X obj 307 4 cnv 15 250 40 empty empty empty 12 13 0 18 #7c7c7c #e0e4dc 0;
#N canvas 382 141 749 319 (subpatch) 0;
Expand Down Expand Up @@ -56,17 +56,14 @@
#X connect 25 1 27 0;
#X connect 25 2 26 0;
#X connect 28 0 21 0;
#X restore 226 386 pd the [else] object;
#X obj 310 467 All_about_else;
#X text 126 468 For more on "ELSE" \, check -->;
#X text 105 358 Now \, finally \, there's also a possibility to load [else] as an object \, see:;
#X obj 317 314 lua;
#X text 57 314 Check about the lua object and loader -->;
#X obj 5 431 cnv 15 552 21 empty empty empty 20 12 0 14 #e0e0e0 #202020 0;
#X obj 5 501 cnv 15 552 21 empty empty empty 20 12 0 14 #e0e0e0 #202020 0;
#X restore 215 347 pd the [else] object;
#X obj 310 427 All_about_else;
#X text 126 428 For more on "ELSE" \, check -->;
#X text 94 319 Now \, finally \, there's also a possibility to load [else] as an object \, see:;
#X obj 5 391 cnv 15 552 21 empty empty empty 20 12 0 14 #e0e0e0 #202020 0;
#X obj 5 461 cnv 15 552 21 empty empty empty 20 12 0 14 #e0e0e0 #202020 0;
#N canvas 97 74 445 205 browser-plugin 0;
#X text 59 38 To use the browser plugin \, right click on an empty space on the patch canvas and check entry menus for 'vanilla' and 'else' \, which will allow you to choose and add the desired object in the spot you right clicked on. The objects are separated by categories and is a nice way to check the objects in ELSE., f 52;
#X restore 307 278 pd browser-plugin;
#X text 92 278 Check about the browser-plugin -->;
#X text 344 314 (right click for help);
#X text 43 201 By loading the library \, some basic information about the ELSE library is printed on Pd's window \, object browser plugins are loaded and you also register a loader that allows Pd externals written in Lua (with the "*.pd_lua" extension). One such object provided in ELSE is the lua object that allows you to load scripts into an object.get the Lua object loader., f 76;
#X restore 323 271 pd browser-plugin;
#X text 108 271 Check about the browser-plugin -->;
#X text 43 201 By loading the library \, some basic information about the ELSE library is printed on Pd's window \, object browser plugins are loaded and you also register a loader that allows Pd externals written in Lua (with the "*.pd_lua" extension)., f 76;
Binary file modified Documentation/Live-Electronics-Tutorial/README.pdf
Binary file not shown.
Binary file modified Documentation/README.pdf
Binary file not shown.
15 changes: 6 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

### Version: 1.0-0 RC-12 (release candidate #12) With Live Electronics Tutorial.

### Released September 3rd 2024
### Released September 23rd 2024

Copyright © 2017-2024 Alexandre Torres Porres and others

Expand All @@ -16,7 +16,7 @@ This work is free. You can redistribute it and/or modify it under the terms of t
For details on authorship check the source code. Other licenses also apply for specific objects and this is also informed in the source code.
For instance:

- [beat~], [sfont~], [giga.rev~] and [lua] are licensed under the GNU GPL library
- [beat~], [sfont~], [giga.rev~] are licensed under the GNU GPL library
- [sfz~] and band limited oscillators like [bl.saw~] are licensed under the BSD 2-Clause library
- [plaits~], [osc.format], [osc.parse] and [osc.route] are licensed under the MIT library

Expand All @@ -29,7 +29,7 @@ For copies of the licenses and the terms, please check the 'license' subfolder.

### About ELSE

This version of ELSE needs **Pd 0.55-0** or above.
This version of ELSE needs **Pd 0.55-1** or above.

ELSE is a big library of externals that extends the performance Pure Data (Pd) - Miller S. Puckette's realtime computer music environment (download Pd from: http://msp.ucsd.edu/software.html).

Expand Down Expand Up @@ -97,19 +97,19 @@ Flávio Luis Schiavoni helped me out in a few things when I first started coding

I'd also like to thank my Cyclone buddies Derek Kwan and Matt Barber, cause I started learning how to code externals with them as part of the cyclone team. Other developers of cyclone need to be praised, like Czaja, the original author, as I did steal quite a bit from cyclone into ELSE. I'd like to give a special thanks for Matt Barber for developing the "magic" in cyclone that I'm using here and also collaborating to ELSE with the objects: [float2bits], [brown~], [gray~], [perlin~], [pink~] and [blip~].

Lucarda is an active tester and has helped countless times with compilation issues for windows and more. Seb shader is a tcl/tk master that helped me a lot with this (which I know next to nothing) and is responsible for the [keycode] object. Ben Wesch made [scope3d~] for ELSE, a nice 3D oscilloscope.
Lucarda is an active tester and has helped countless times with compilation issues for windows and more. Seb shader is a tcl/tk master that helped me a lot with this (which I know next to nothing) and is responsible for the [keycode] object.

Kudos and thanks to my buddy Esteban Viveros for helping with the compilation of ELSE for other systems as well as ELSE for Camomile and libpd projects, which opened the way for PlugData by Timothy Schoen, who's doing an amazing jaw dropping job with this project based on camomile that includes ELSE. Timothy has also helped me fix many ELSE related issues and has made incredible and countless contributions to ELSE with fixes, improvements and new objects. Other folks from the PlugData gang are being very helpful like Alex Mitchell and Amy. PlugData is a fork of Pd with a revamped GUI and comes with the ELSE library. See: <https://github.com/timothyschoen/PlugData>.

--------------------------------------------------------------------------

## Current Object list (553 objects):
## Current Object list (551 objects):

#assorted
else

#gui
knob numbox~ drum.seq bicoeff pad messbox mtx.ctl biplot zbiplot pic colors function circle slider2d display out.mc~ out~ out4~ out8~ gain~ gain2~ button keyboard graph~ range.hsl multi.vsl spectrograph~ meter~ meter2~ meter4~ meter8~ note mix2~ mix4~ setdsp~ openfile scope~ scope3d~
knob numbox~ drum.seq bicoeff pad messbox mtx.ctl biplot zbiplot pic colors function circle slider2d display out.mc~ out~ out4~ out8~ gain~ gain2~ button keyboard graph~ range.hsl multi.vsl spectrograph~ meter~ meter2~ meter4~ meter8~ note mix2~ mix4~ setdsp~ openfile scope~

#time
chrono datetime
Expand Down Expand Up @@ -159,9 +159,6 @@ Kudos and thanks to my buddy Esteban Viveros for helping with the compilation of
#analog circuitry emulation
circuit~

#scripting
lua

#fx: assorted
downsample~ conv~ chorus~ shaper~ crusher~ drive~ power~ flanger~ freq.shift~ pitch.shift~ stretch.shift~ stretch.shift~ ping.pong~ rm~ tremolo~ vibrato~ vocoder~ morph~ freeze~ pvoc.freeze~ phaser~

Expand Down
4 changes: 2 additions & 2 deletions pd.cmake
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,11 @@ function(add_pd_external PROJECT_NAME EXTERNAL_NAME EXTERNAL_SOURCES)
# Includes the path to Pure Data sources.
target_include_directories(${PROJECT_NAME} PRIVATE ${PD_SOURCES_PATH})

# Defines plateform specifix suffix and the linking necessities.
# Defines platform specific suffix and the linking necessities.
set_target_properties(${PROJECT_NAME} PROPERTIES PREFIX "")
if(APPLE)
set_target_properties(${PROJECT_NAME} PROPERTIES LINK_FLAGS "-undefined dynamic_lookup")
set_target_properties(${PROJECT_NAME} PROPERTIES SUFFIX ".d_fat")
set_target_properties(${PROJECT_NAME} PROPERTIES SUFFIX ".darwin-fat-32.so")
elseif(UNIX)
if (${CMAKE_SYSTEM_PROCESSOR} MATCHES "x86_64")
set_target_properties(${PROJECT_NAME} PROPERTIES SUFFIX ".l_amd64")
Expand Down
5 changes: 5 additions & 0 deletions tools/tools.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ cd Build
make -j7


cmake -BBuild -DPD_FLOATSIZE64=1 -DPD_PATH="/Applications/Pd-0.55-1.app/Contents/Resources/"
cd Build
make -j7


-------------------------------------------------------------------------
-------------------------------------------------------------------------

Expand Down

0 comments on commit 2e91693

Please sign in to comment.