Images

The most important part of PureRef. Explore all the ways to interact with and organize them.

---

Adding images​

#insert #import

It should be easy to add images. That's why you can do it any way you want.

Paste image​

Paste an image from the clipboard.

Paste or drag/drop URL​

You can paste a URL straight into the canvas and PureRef will open every image it can find on that page. Dragging and dropping a URL works too.

Dragging & dropping​

Drag and drop images from your computer or web browser.

Import images from your computer​

Browse to import images from your computer.

---

Selecting images​

Select an item by clicking it. Click and drag to create a selection rectangle.

To select items inside locked groups, double click the item to enter that group. While a locked group has a child item selected, the selection rectangle can be used to select multiple items in a group by starting the select drag on the parent groups background or using the continuous select shortcut.

Selecting multiple images​

#multiselect

Hold Shift/⇧ and click to select multiple images.

Select all​

Select everything in the scene.

Continuous deselect​

Remove the item under the mouse cursor or all items inside a dragged out rectangle from the current selection.

Continuous deselect doesn't have a default shortcut so it needs to be bound in the keyboard shortcuts settings to be used.

---

Edit item​

Start editing a selected item, such as a note or drawing.

---

Duplicate​

Duplicate the current selection.

---

Manage images​

Batch modify image resolution, image sizes, formats and the location of image data.

Used for improving scene performance, scene file size and scene portability.

Change image resolutions​

Downscale images that exceed the set maximum dimensions set, or disable any existing downscaling. Images that have a greater resolution than the one selected, will be downscaled to fit the set dimensions when the settings are applied.

Downscaling does not alter image data. To make the resolution change permanent and reduce file size, enable downscaling together with Optimize images.

Optimize images​

Optimize images by changing image formats, applying downscaling, and choosing to discard cropped pixels. Optimizing alters the original image data to improve saving and loading performance, and to reduce save file size.

Format

Convert images of other formats to either JPG, PNG or BMP, or automatically select an optimal format depending on if the image has an alpha channel or not.

Discard cropped data

Permanently apply image cropping on cropped images. The cropping can't be undone or changed after this.

Change image locations​

Change where image data is stored. Embedded images' data is stored in the save file, while linked images references separate files on disk. To change the default storage method, see the setting Embed local images in save file.

Image data location

Link stores image data at an external location and references them from the save file. Will export all previously embedded images and/ or change location of already linked images.

Embed stores image data directly within the save file. Will embed any previously linked images.

Relink already linked images

If an image is linked, selecting this option will create a new copy at the chosen location and update the link accordingly.

Link to existing sources

If an embedded images' source exists on a local disk, link to that instead of exporting the embedded image to the save location.

Replace existing images

Choose whether to overwrite existing images at the destination or assign a unique name when exporting.

Naming

Specify a template to use for naming the exported images or create your own by using the following substitutions:

%0 - Original name
%1 - Sequence number
%2 - Sequence number with leading zeroes
%3 - Scene name

An empty template will result in the original name.

Preview​

The preview will display images in the scene that will be affected by the selected settings. Images that doesn't match the set conditions (or are not selected in the viewport if there's a selection) will not be shown in the preview, and will thus not receive any changes when applying them. For example, if Change image resolutions is set to downscale to 2000x2000px, an image which is 500x500px won't be downscaled, and won't show up in the preview.

Images with the symbol in the preview will have their original data altered when applying the current settings. Altering the image data cannot be undone. Optimizing images (changing file type) will always have this effect.

---

Rotate​

Grab outside the corners of the transform gizmo, or hold Ctrl/⌘, click left mouse button and drag on the image to rotate it.

Snapped rotate​

Rotate and snap to the nearest 45 degrees. Just hold Shift/⇧ while using the gizmo.

---

Scale​

Use the gizmo or keyboard shortcut to resize an image or note, non-destructively. Pull the image left or right while holding down the shortcut buttons.

Scale from the center of the image with the transform gizmo by holding Alt/⌥

---

Crop

Introduced in PureRef 2.0.0

​

Enable to use the gizmo to crop the selected image. Hold Shift to lock the current aspect ratio, or Shift + Alt to lock it to a square.

Crop selection​

Hold the shortcut buttons and drag out a rectangle with the cursor to crop inside the selection. The cropping is non-destructive.

Pan cropping​

Move the image around inside the cropping area by holding down the shortcut buttons and then dragging the image around.

Zoom cropping​

Zoom in and out inside the cropped area. Pull the image left or right while holding down the shortcut buttons.

Reset cropping​

Reset the cropping and restore the image to its original shape and size.

---

Flip images​

Flip images manually by holding the shortcut buttons and dragging the cursor in the direction you want to flip them.

Flip horizontally​

Flip selection horizontally.

Flip vertically​

Flip selection vertically.

---

Axis snapped move item​

Constrain images to move in straight lines.

Neighbor snapped move item​

Snap move images to the closest edges of other items.

---

Adjust image opacity​

Adjust the opacity of the selected image. Hold the shortcut buttons and drag the cursor left or right to decrease or increase opacity.

---

Focus​

Press space or double click to zoom in on selected images. Press space or double click again to go back to the previous view. Use the arrow keys to step to the next and previous images, in order of addition to the scene.

Focus next​

Step to the next image in the order of the hierarchy.

Focus previous​

Step to the previous image in the order of the hierarchy.

---

Slideshow​

Focus on an image in the selection for 10s (by default, can be changed in settings) before automatically moving to the next in line.

---

Toggle grayscale​

Make the selected images grayscale.

The grayscale formula used is (r*11+g*16+b*5)/32

---

Toggle bilinear sampling​

Switch pixel interpolation of selected images between nearest neighbor and bilinear filtering. Useful for displaying pixel art.

---

Open source​

Open the original location of an image, either locally on the computer or in the web browser.

---

Replace image​

Replace a single image with another one selected from disk.

Relink missing images​

If Embed local images is disabled and images cannot be found on disk, a question mark will be displayed instead of the images. If images are moved or renamed, they can be relinked. Use this shortcut or double-click on an image to choose the new sources.

Only local images on disk are able to be linked. Images pasted from the clipboard or added from the internet will be embedded.

---

Delete​

Delete selected images from the scene.

---

Comment

Introduced in PureRef 2.0.0

​

Read or edit a comment on the selected item.

Comments use the same rich text editing as notes.

---

Toggle locked

Introduced in PureRef 2.0.0

​

Lock or unlock the selected items. Locked items can't be selected for manipulation in the view but can be selected through the hierarchy.

Unlock a locked item by clicking it to make an unlock button appear in the items lower right corner.

---