PIXILAB Wiki

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
blocks:app-note:start [2020-07-09 12:21] – Moved app note TOC to the main Blocks page adminblocks:app-note:start [2026-10-07 12:47] (current) – admin
Line 1: Line 1:
 ====== General setup application notes ====== ====== General setup application notes ======
  
-Blocks application notes make it easy to try out features, hone your Blocks skills and learn best practice. Follow these general steps to use most application notes:+Application notes lets you try out features, hone your Blocks skills and learn best practice. Follow these general steps to use most application notes:
  
   - Download a .zip file containing the application note files.    - Download a .zip file containing the application note files. 
   - Unzip it to a directory of your choice.   - Unzip it to a directory of your choice.
-  - Stop Blocks if it is runnng.+  - Stop Blocks if it is running.
   - Make sure you have a file named //PIXILAB-Blocks-config.yml// in your home directory, containing your preferred Blocks settings, as described [[blocks:server_configuration_file|here]].   - Make sure you have a file named //PIXILAB-Blocks-config.yml// in your home directory, containing your preferred Blocks settings, as described [[blocks:server_configuration_file|here]].
   - Locate or create a //root// entry in that configuration file, specifying the path to the application note directory unzipped in step 2 above, as described [[blocks:server_configuration_file#alternative_blocks_data_location|here]].   - Locate or create a //root// entry in that configuration file, specifying the path to the application note directory unzipped in step 2 above, as described [[blocks:server_configuration_file#alternative_blocks_data_location|here]].
Line 12: Line 12:
 :!: If you don't already have a configuration file in your home directory, you can download this {{:blocks:app-note:start:pixilab-blocks-config.yml.zip|generic configuration file}}. :!: If you don't already have a configuration file in your home directory, you can download this {{:blocks:app-note:start:pixilab-blocks-config.yml.zip|generic configuration file}}.
  
-Most application notes also require that you re-assign the Display Spot used in the example to a display or browser window of yout choice. Do so by double clicking the Display Spot in the editor and select yout spot's ID under "Re-assign to Display Spot".+To open a test display spot using your computer's browser with a server running on the same computer, use the standard Blocks spot url: 
 +  
 +<code>http://localhost:8080/spot</code>  
 + 
 +If you need more that one display spot, a query parameter can be addad to the URL like this: 
 + 
 +<code>http://localhost:8080/spot?display=1</code> 
 + 
 +You can add any number of "fake displays" in this way. Make sure all the browser windows use display numbers, or the spot/window will misbehave (indicated by the connection status indicator of the display spot flashing in the editor).  
 +  
 +Replace localhost:8080 with your server's IP or domain name if the server is accessed over the network. 
 +  
 +You must most likely reassigned any Display Spots used in the application note to your fake display windows by double clicking the Display Spot in the editor and selecting your spot's ID under "Re-assign to Spot ID".