Skip to content

Latest commit

 

History

History
executable file
·
156 lines (91 loc) · 6.06 KB

README.md

File metadata and controls

executable file
·
156 lines (91 loc) · 6.06 KB
Raw

RIA (Early access)

RIA (Reference Image Application) is a cross platform image organizer for both Windows and Linux designed to help artists organize their reference material through the use of tags and folders. RIA supports PNG, JPEG, and WebP images.

NOTICE: When upgrading from v0.5 to v0.6, make sure you recreate any previously saved image packs. The app will crash if you try to load an old image pack.

Installation

Download the latest verion from release page for your operating system or compile it from source and run RIA. Note that RIA expects the icon image to be in the image folder in the directory you run it from.

NOTE: Currently, the Windows command prompt will open as a display for debug information

Tested Distros:

  • Arch
  • Ubuntu

NOTE: The Linux version relies on Zenity to add new folders to the folder view.

Image Board

Ctrl + S - Save the boards current state

Left mouse click - Select an image

Shift + left mouse click - Select multiple images

Left mouse drag - Select images in a window

Right mouse click - Open image options menu

Right mouse drag - Scale images

Shift + Right mouse drag - Scale images while maintaining their ratio

Scroll wheel/+/- - Zoom in/out

DELETE - Remove all selected images from the board

H - Flip selected images horizontally

R - Rotate the selected images (Cancelled by RMB or ESC and confirmed by LM)

WASD/Arrow keys/Middle mouse drag - Move the image board view

SPACE - Toggle the origin display

TAB - Open the folder view

V - Flip selected images vertically

~ - Open the tag view

FOR MORE INFO: Open help.html or press the help button in RIA

Folder View (TAB)

Contains saved paths to folders that contain the images that you want to tag/use.

DELETE (While hovered over a main folder) - Remove the folder from the view.

LMB Click (Folder) - Expand a folder and display its contents. If a file is tagged, a white box will be displayed on the left side of the file.

LMB Click (File) - Load the image into the preview on the bottom right side of the screen. Files that already have been tagged are indicated with a white bar to the left of the file name.

Ctrl + R - Refresh locations

The "+" Button - Add a new location to the view.

Tag View (~)

Only contains images that have been tagged under said tags.

LMB Click - Expand a tags and display its contents. While previewing an image, a white box will appear on the left side of any of the tags it belongs to.

LMB Click (File) - Load the image into the preview on the bottom right side of the screen.

RMB Click - Add/remove an image from a tag/sub tag.

RMB Click (No preview image) - Edit a tag/sub tag.

The "+" Button - Add a new tag to the view.

The "+" Button (Tag header) - Add a new sub tag to the tag.

The "edit" Button (Tag header) - Edit an existing tag.

Image Packs (Image Pack Button)

Image packs are an experimental idea only found in RIA. An image pack contains pre-tagged files so they can easily be shared between users. Follow the below instructions for how to create an image pack or see the help file for more detail. Image packs use folders like categories and relies on the images to be manually tagged by one users before being shared. While importing an image pack, it gives you the option to exclude folders in the image pack from being imported. EX) An image pack has 3 categories: Buildings, Landscapes, and Clothes. A user can choose to only import images from the Buildings and Landscapes folders and all the images in the Clothes folder will remain without being added to RIA.

NOTE: When creating an image pack, it only checks the tags that are in your program. Press the create button on a previously imported image pack and removed some of the tags prior, it will overwrite the import file and remove the untagged images from the import file.

Importing Image Packs

  1. Select and image pack and press the import button. A dot will appear next to the selected image pack.
  2. Select/deselect the folders from the image pack you want to import. A dot is again used to indicate if the folder is going to be imported.
  3. Verify you want to import the tags. Pressing the sub tag button will enable/disable importing sub tags.

NOTE: Imported tags do not overwrite existing tags with the same name

Creating Image Packs

  1. Create a new folder in the shared directory with the name of your image pack.
  2. Create subfolders to categorizes the images you will be using. Multiple levels of subfolders can be used.
  3. Tag the images in RIA.
  4. Open the import menu, select your image pack and press the create button.

NOTE: Importing can read multiple levels of sub directories but the example pack keeps things simple.

Image Pack Layout Example (See the example image pack in the latest release)

[Folder] Photographs (Image pack name)

	-> [Folder] Buildings (Category)

		-> [Sub Folder] Cities
 
			-> [Image] New York.png
  
			ect
   
	-> [Folder] Trees (Category)
 
		-> [Image] Oak.png
  
		ect

Compiling

RIA depends on:

Glad: https://github.com/Dav1dde/glad

STB_Image: https://github.com/nothings/stb

glfw3-x11 or glfw-dev (Sometimes called libglfw-dev or libglfw3-dev)

xorg-dev (Linux)

g++

libwebp or libwebp-dev

freetype font or libfreetype-dev

Ubuntu:

g++ -std=c++17 main.cpp src/dependencies/linux/glad/glad.c -o main -lstdc++fs -lglfw -lGL -lX11 -lpthread -lXrandr -lXi -ldl -lfreetype -I/usr/include/freetype2 -lwebp -static-libgcc -static-libstdc++

NOTE: Be sure to set UBUNTU to 1 in "config.hpp" before compiling. Ubuntu also requires the libwebp package to compile.

Windows:

g++ main.cpp src\dependencies\windows\glad\glad.c -o RIA  "src\dependencies\windows\glfw\libglfw3.a" -lopengl32 -lgdi32 -lole32 -loleaut32 -luuid -Lwebp freetype.dll libwebp.dll -static -static-libgcc -static-libstdc++

NOTE: The above may vary depending on your Windows workspace and installed libraries.