Three steps

Once you have managed to register a Backblaze cloud storage account and created a public bucket, the hard work is done!

Upload your deep zoom image by executing the following code in a Jupyter notebook:

Step 1

First, change your working directory to the folder on your computer with the large image files that you would like to upload as deep zoom images. In my case a have two very large tif images from the same drawing.

'RP-T-1898-A-3689_Recto.tif' (2.3 GB) 
'RP-T-1898-A-3689_Trans-Recto.tif' (2.3 GB)

Step 2

Establish a connection to the Backblaze bucket that you would like to upload to by creating a DeepZoomBucket() object. You will need to fill in your own bucket credentials and bucket name.

You need to copy your own personal B2 bucket application-key, application-key-id and bucket-name in a notebook cell and run the cell (by pressing Shift-Enter).

application_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxx" 
application_key_id = "yyyyyyyyyyyyyyyyyyyyyyyyyy"  
bucket_name = "my-first-bucket"
from deepzoomup import DeepZoomBucket 

dzb = DeepZoomBucket(application_key_id, application_key, bucket_name)

Step 3

Convert and upload your images with the .upload_as_dzi() method.

dzb.upload_as_dzi('RP-T-1898-A-3689_Recto.tif')
dzb.upload_as_dzi('RP-T-1898-A-3689_Trans-Recto.tif')
CREATING DEEPZOOM IMAGE TILES...
Skipping local deepzoom creation for: RP-T-1898-A-3689_Recto.tif
(No need to overwrite already existing tiles)
SYNC LOCAL FOLDER WITH CLOUD BUCKET...
upload dzp_RP-T-1898-A-3689_Recto/tn_RP-T-1898-A-3689_Recto.png              
                                                                            
CREATING DEEPZOOM IMAGE TILES...
Skipping local deepzoom creation for: RP-T-1898-A-3689_Trans-Recto.tif
(No need to overwrite already existing tiles)
SYNC LOCAL FOLDER WITH CLOUD BUCKET...
upload dzp_RP-T-1898-A-3689_Trans-Recto/tn_RP-T-1898-A-3689_Trans-Recto.png  
                                                                            

That is it! You have successfully created and uploaded your cloud stored deep zoom image tiles.

Curious to see the result? See the next section.

API

class DeepZoomBucket[source]

DeepZoomBucket(application_key_id, application_key, bucket_name)

Create DeepZoomBucket object.