GHShot consists of 3 components: GHShot, GH_Settings, and GH_Input. GHShot can be found under the Connect tab once it is installed. GHShot_AutoRecorder (the second icon if you see four icons under your tab) is experimental and is currently not used. It is used to record your design actions if it is connected to GH_Settings.
For this example, we will use a simple tower parametric model attached to Karamba components (note that you don't need Karamba to use GHShot, this is just an example).
If you don't have Karamba, you can either download it: here (version 1.3.2), or connect the geometry output to Pipe & Mesh. Download the Grasshopper file used in this project: initial parametric model , or final version .
Paste the url we copied before to the panel attached to the server input. Also, key in your username.
Contains key-value pair of variables/parameters you would like to record. Key stands for the variable name, value stands for the actual value of that variable. You can choose In this example, we get the Displacement value from AnalyzeThi component and numOfSides value representing the base polygon shape from the slider.
Once everything is piped in, click on the save Button and the info panel will be updated with information of your model being saved. Make sure that all data components are internalised, otherwise your Grasshopper file will have empty data components when it is downloaded
Congratulations! Your first snapshot had just been sent to the server! You can see that your design is available now in your main page.
Now let's continue to modify our tower model: add rotation, and send our second snapshot. Note that if we didn't specify new modelname, automatic numbering will be generated by the system. This is to simplify having to rename model everytime.
When we go to the web, in the 3D viewer page, we can now see the difference with its previous snapshot (parent). Notice that the newly added components are highlighted in green. Changed components are highlighted in yellow, and deleted ones are highlighted in red (we don't have red ones in this example).
This because by default branch settings in GHShot is set to false, and hence the linear progression.
Design snapshot can be downloaded using the download button on the project page (top) or the 3D viewer page (bottom). In this tutorial, we will be downloading from tower_1 to show how design can be continued from a specific snapshot.
Open your recently downloaded file with Grasshopper. Note that the format of file downloaded is .ghx, hence you can only open the file from File -> Open Document menu in Grasshopper (drag and drop the file in Grasshopper wouldn't work.) For every newly downloaded snapshot, username panel will be empty. Fill in with your username.
Finally, if you do modification and click to send again, your tree will look like this.
Image of History Tree and Graph View can be save as SVG (Scalar Vector Graphics) format.
To open downloaded SVG file in Adobe Illustrator correctly, first open the file with your web browser and print to PDF format. After, open the PDF in Adobe Illustrator.
Snapshot that has already be sent cannot be deleted, however, you can choose to hide them for exporting image purpose in the history tree page. Tick Delete Checkbox and start selecting snapshots (click on the nodes). Press delete button to delete the snapshots you have chosen. You could save this view so that it can be loaded the next time you visit the page.
Currently we provide mechanism to merge two snapshot manually and automatically. To merge, check on the checkbox beside manual merge and select 2 snapshots that you want to merge.
If you choose manual merge, the difference between two parametric model will be highlighted in the downloaded file. Once you finish editing the parametric model, you can send the model again to the server from GHShot in the blue-box. Automatic merging is experimental and the resulting parametric model might not be a valid parametric model.
Your merging is reflected in the history tree.