﻿Officina Gemmariorum 0.11.2 — launch edition
=================================================
"The workshop of the gem cutters": software to help cut faceted gemstones.

Installation
- Windows: run OfficinaGemmariorum-0.11.2-Setup.exe and follow the steps. The software installs
  for your Windows account, without administrator rights, creates a shortcut on the desktop and in
  the Start menu, and opens in its own window (with Microsoft Edge or Google Chrome).
  The installer speaks eleven languages and uses the language of Windows (English if it is not one of them).
- When the installer starts, Windows may show "Windows protected your PC", because the installer
  is not signed yet: click "More info", then "Run anyway".
- Mac, Linux or USB stick: open the file OfficinaGemmariorum.html from the "Sans installateur"
  (without installer) folder in Chrome or Edge, and keep manuel.html in the same folder. This has
  not yet been tried on a Mac: tell us what you find.
- The software connects only to activate the license and renew it. Your diagrams, your photos
  and your settings stay on your computer.
- The files you save go to the Downloads folder, or wherever your browser offers to put them.
- To remove the software: Windows Settings, Apps, Officina Gemmariorum, Uninstall.

Demo version, license and options
- Without a license key, the software is a demo version: it does what GemCad and GemRay do. Edit a
  diagram, cut by meet points, open and save .asc and .gem files, open .ofg files, print the
  cutting sheet, compute ISO and COS light return, optimize the angles. The installer may therefore
  be lent or copied freely.
- The base license is bought once, with no subscription. It opens the rest of the software, except
  four options: Pleochroism and color zones, Full 3D rough, Inventor, Bench. The options can be
  taken with the license or later, and are then added to the same license. The "License" box of
  the software gives the details of each level and the prices.
- A purchase on archedulivradois.fr delivers a personal license key, in your name, by email.
  To activate it: open the software, click "Demo" at the top of the page, paste the key and click
  "Activate". The badge then shows your name.
- Activation is done online, on two computers at most; an installation can be released from the
  same box to activate another one. It sends the license identifier, its activation code, a randomly
  drawn installation identifier and the software version, nothing else. It is valid for 180 days
  without a connection and renews itself; after that term and 30 days of grace, the software
  returns to the demo, without losing anything, until the next connection.
- The license is personal: your name and its number appear in your .ofg files and at the foot of
  the printed sheets. A key shared publicly is revoked.
- The key covers the updates of version 1.

What this edition does
In the demo (without a key)
- Workshop: creating and editing a diagram tier by tier, 3D view, cutting by meet points, index
  wheel conversion, transposing the angles to another material (with the score before and after,
  shown before applying).
- GemCad files (.asc, .gem): open, save, copy. Opening Officina files (.ofg).
- Cutting sheet in four views, printable.
- Optics: ray-traced rendering, ISO and COS light return, head shadow, tilt.
- Angle optimizer: pavilion and crown, with a trade-off between brilliance and weight.
- Library: example diagrams, your imported diagrams kept on the computer (one file, a batch or a
  whole folder, with progress), filters by shape, index, wheel and license, export and re-import
  of the whole library in one file.
- Eleven languages: French, English, Spanish, Portuguese, German, Italian, Russian, Chinese,
  Japanese, Thai, Hindi. The software uses the language of the browser; it can be changed at the
  top right. These notes also exist in French (LISEZMOI.txt); the manual and the license are in
  French. The translations have not yet been reviewed by a lapidary of each language: any
  correction is welcome.
- Illustrated manual (manuel.html, placed next to the software): "Aide" (Help) link at the top of
  the page, or the "Officina Gemmariorum — Manual (in French)" shortcut in the Start menu.

With the base license
- Optics: six named lighting setups and an overall score, loose or set stone, scintillation during
  a turn, map of where the light comes from, frosted facets.
- Workshop: diagram generators, step-by-step preview, stretching a shape.
- Files: saving in the Officina format (.ofg), reading and writing Gem Cut Studio (.gcs).
- Rough and advisor: yield in a rough described by its dimensions and weight.
- 3D rough from photos: model of the rough from photos taken on the machine, color read from the
  photos, placing the stone pavilion first or crown first, comparison with another axis.
- Favorites and library advisor: a star to keep a diagram, ranking of your diagrams in a rough.

Options
- Pleochroism and color zones: colors of the crystal depending on its orientation (two or three
  colors, tourmaline with a closed axis), known values offered for each material, reading from the
  photos of the rough, adjustment from what you see; fixed color zones of ametrine and bicolor
  stones, set in the stone or from the rough.
- Full 3D rough: zones to avoid around flaws, STL export, placement in the rough printed on the
  cutting sheet, dichroism read from the photos, video of the turn instead of photos, re-dopping
  flat to change axis, second turn.
- Inventor: new diagrams, built tier after tier by cutting references (rounds, ovals, cushions,
  step cuts, pears and marquises) and scored under several lightings, viewpoints and tilts, with
  their cutting tolerance. No proposal has been cut yet: try it on a stone of no value.
- Bench: guided cutting tier by tier for the screen next to the machine (angle in very large type,
  indexes to tick, transfer, help with index cheating, preform) and a log of each stone with the
  actual yield.

What is exploratory
- Reading dichroism and color zones from the photos of the rough, the video of the turn and the
  second turn have not yet been confirmed on enough real stones: check with a dichroscope and by
  eye before cutting.

The Officina format (.ofg)
- It keeps the whole diagram: hidden tiers, frosted facets, material, color, size, author.
- It opens only in Officina Gemmariorum.
- Optional password: with it, no one can open the file without knowing it.
  A lost password cannot be recovered: keep a record of it.

3D rough: how to take the photos
- The rough is glued on its dop, the dop in the machine, in front of a light, even background.
- One photo at each index step over a full turn (for example every 6 notches of a 96 wheel),
  or a video of the turn, phone on a stand: advance one step, stop for a second, and so on.
- The dop must be visible up to the chuck and the block of the machine.
- Measure the largest width of the stone and weigh it before gluing it.

Diagrams by other authors
- The software does not download any. It contains only one, "PC 11.134 Smallest Square" by
  Robert H. Long, which its author placed in the public domain (the notice is in the diagram).
- You can open those you own or download yourself; each remains subject to the license chosen by
  its author.

Updates and support
- The updates of version 1 are included. They are offered on archedulivradois.fr.
- The brightness and yield scores are calculated estimates: make a trial before cutting a
  valuable stone.

GemCad and Gem Cut Studio are trademarks of their respective owners; Officina Gemmariorum is
compatible with their files and has no connection with them.
