live view mode

A PDF Version of the interactive guide is available : PDF.

Description on the ArtBlocks Voyager webpage 

You can interact with keyboard commands or through URL parameters.

- press S : to save the current image in png

- press 2, 3... 9 (URL, add DP=2) : change resolution. Increase the value step by step. Can be very long to draw, but it's worth it for printing. Very High Resolution can be achieved. File is saved automatically when finished.

- press L (URL, add liveMode=true) : to discover different views of your planetary system (images will be drawn one after the other, with the same parameters for the main planet and the space environment).

- press F (URL, add fitToScreen=true) : to adapt the artwork to any screen size (artwork is changed but parameters remain the same)

- press M (URL, add monoChromatic=true) : to force the artwork to be monochromatic

- press G (URL, add GW=false) : to remove the gravitational wave effect

- URL, add offset=<Number>, to offset the image production (same planet parameters and space environment)

- URL, add grainy=true, to change the size of the grain (useful for displays to speed up the creation process)

URL Parameters are added to the end of a URL after a ‘?’ symbol, and multiple parameters can be included when separated by the ‘&’ symbol.

You can combine "?liveMode=true&fitToScreen=true&grainy=true" in the URL for display purpose (TV, Art show...). 

Combining liveMode and DP for resolution allows you to save all the images produced.

Let's review the main use cases :

Display to show/enjoy Voyager on any screen

High resolution exports (for prints, etc...)

dISPLAY OPTIONS

Voyager can be displayed on any screen thanks to the fitToScreen option. Let's look at the different options we can use.

Use Case : Voyager mint #0 : https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000

For all examples replace the last 3 digits (000) by your mint number (009 for mint #9)

fitToScreen

To add the fitToScreen option, press f or add fitToScreen=true to the URL :

https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000?fitToScreen=true

The first argument to the URL must start with ? and following ones with &

fitToScreen + liveMode


If you want the artworks to loop endlessly and produce new images, activate the liveMode by pressing l or add liveMode=true to the URL :

https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000?fitToScreen=true&liveMode=true



fitToScreen + liveMode + grainy

In order to speed up the drawing you can add grainy=true to the URL :

https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000?fitToScreen=true&liveMode=true&grainy=true

fitToScreen + liveMode + grainy + offset

In order to start the generation loop from a different position, use offset (to avoid starting the same loop and thus discover new images)

https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000?fitToScreen=true&liveMode=true&grainy=true&offset=64

replace 64 by any number

HIGH RESOLUTION

Voyager can be exported to high resolutions (for printing, static display, screen saver...).

UseCase : Voyager mint #0 : https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000

For all examples replace the last 3 digits (000) by your mint number (009 for mint #9)

Resolution

To change the resolution, press a number between 2 and 9 or add DP=2 (or 3, 4...) to the URL :

https://generator.artblocks.io/0x99a9b7c1116f9ceeb1652de04d5969cce509b069/434000000?DP=2



The file will be saved automatically at the end of the building process (no need to save it manually, but you can save it before as well in case you want it lighter).

On my Macbook Pro (15-inch, 2018, 2.6 GHz Intel Core i7) I've got roughly the following values (for Print Size I used standard 2:3 formats and around 300 DPI). For the largest size (seen form a distant position, it can be enlarged... Upscaling processes with ImageMagick gives very good result and can double the image size without problems : more infos).

To monitor the time required to build the artwork for a given DP, you can use the Console.

In Chrome, Right-click on the canvas and select inspect. A Window will appear and look for Console.

You'll see the artwork completion express in percentage and the time it took to reach that level.

From these numbers you can infer the time to reach completion on your computer for a given DP. 

For the largest sizes I suggest to run during the night.

liveMode and resolution

If you use the liveMode possibility in addition to DP : liveMode=true&DP=4 for example.

All the images produced one after the other will be saved (interesting for a night run in not too high DP to build lot of images).

Exploration and resolution

In case you want to produce very high resolution images of your system the best way is the following :

1. use offset=<number>&DP=1 to look for a nice image you want to build in high resolution (fast drawing, so you can try many numbers for offset and look for an outstanding one)

2. you find for example <number>=1022 is worth a high resolution image... simply add : offset=1022&DP=8 => you will build the very same image you've seen with DP=1 but with DP=8

3. write somewhere (in the filename of the png for example) the offset numbers you like to retrieve them easily

Caveat

In liveMode, images following the first one will depend on DP. For the same DP you will retrieve the same image sequence, but for a different DP you'll get another set of images... 
This is why exploring with offset is better because it does not depend on DP. You can combine offset and liveMode to be sure to produce the image you want and let other images be built after for discovery.

EXPLORATION EXAMPLES