to read:
  * https://www.youtube.com/watch?v=cEVoGUnX1n4
  * https://grabcad.com/questions/35tutorials-keyshot-tips-step-by-step

====== Keyshot Shortcut ======

| focus select | right menu > set camera target |
| view selected | right menu > center and fit part |
| view all | right menu > center and fit model |
| Show all | right menu > show all part |
| outline part | LMB click |

**material**

| unlink material relationship | right click on part, unlink material |
| relink material relationship | right click part on copy material, and right click part on paste linked material |
| | (same) shift+LMB on source, shift+RMB to paste to target part |
====== Keyshot Basic ======

  * Hardware notes: Keyshot use CPU to render, and the speed increase linearly according to core count:
    * https://www.pugetsystems.com/labs/articles/Keyshot-Multi-Core-Performance-789/

  * Basic Workflow
    - Import Geo
    - assign material (to research, apply material by scripts)
    - assign HDRI lighting
    - tune lighting and rendering setting
    - render

===== basic task - Place Logo =====

  * Use label on the applied material, with color and bump texture option, you will get a good logo look on your existing material ready model
    * tutorial: https://www.youtube.com/watch?v=LCsmR23YVVo
    * advanced tutorial (showing your material < label < label material type of combon): https://www.youtube.com/watch?v=Lu1xTYYC-Mg

===== basic task - batch switch material =====

  * duplicate a copy, and right click and choose material > change material type
    * https://www.youtube.com/watch?v=z3T1kMttlz0

===== basic task - animate material =====

**To animate color**
  * right click on the color attribute and and choose animation and set it up
    * https://www.youtube.com/watch?v=9cjP6V_2mxA

**To animate visibility (not opacity)**: so no need post compositing for already confirmed animation
  * animation wizard > Fade > choose parts to fade; or choose parts > right click > animation > Fade. done
    * https://www.youtube.com/watch?v=ferGI5Pkid8
===== basic task - quick post color variation =====

  * click the edit pen icon in the final render viewer:
    * https://www.youtube.com/watch?v=EYL2u-Q6wY8

===== basic task - custom reflection =====

  * click on environment HDRI to open HDRI edit, and create new HDRI with dark color, then use pin to create custom light shape to create desired reflection
    * https://www.youtube.com/watch?v=nh1aiursXz8

====== Keyshot Material Example ======

**Cloudy Material / Translucent material / semi-transparent materail** (like paper, thin plasic)

  * render setting:
    * self shadow: on; global illumination: on; ground illumination: on;
  * material setting:
    * Advance material type > 
      * Specular transmission (amount of refraction related) setting to control transparency.
      * Specular color (reflection color cast, Black = no color cast) to control look casting color and strength of reflectivity
      * Roughness of Transmission: control internal structure roughness, basically disturb the refraction and give a blur look of refraction - "cloudiness" look
      * Roughness: control the surface roughness, basically disturb the reflection and give a blur look of environment reflection - "Glossy or matte" look
      * Diffuse color: color of object itself and strength of color compared to its reflection/specular color

  * tut: https://www.youtube.com/watch?v=heyF-wVVAdo

**Back-lit material**

  * create a light object with Point Light Diffuse Material
    * Power and Color: control light intensity

  * add glow post-effect:
    * Camera > Effect > Bloom (Glow) to add glow boost intensity and radius (highlight part blur)

**Glass material**
  * Glass (Solid) Grey: (type: Basic > Glass Solid)
    * texture option = only Refractive Index + Roughness
  * (type: Advanced > Dielectric) : allow color ramp option mapping to color
    * texture option = Transmission + Transparency distance + roughness + bump + opacity)
    * https://www.youtube.com/watch?v=Np-3e_TthF0
====== Keyshot Advanced ======
===== version control tips =====

  * to do list
    * update geometry
    * export material linking list
    * automated shot building script and tool
    * render layer control
    * element/material variation and compositing workflow

===== lighting control tips =====

  * to do list
    * light setups
    * reflection tips

  * animated environment light
    * as environment rotation can't be animated, you have to animate your model and camera together
      * ref: https://www.keyshot.com/2012/how-to-create-animate-lighting-in-keyshot/

  * animated Emissive geo light
    - Insert a plane or sphere and use a translate animation to move across the model.
    - Apply an Emissive material to the sphere/plane, increasing the intensity and disable ‘Visible to Camera’ in the Advanced settings.
    - In the Project, Setting tab, enable ‘Global Illumination’.

  * lighting tutorial: https://www.youtube.com/watch?v=upSNlInkSA8
  * jewelry lighting: https://www.youtube.com/watch?v=-oduJJ0Gq84
  * iphone lighting: https://www.youtube.com/watch?v=XSLQneVyZ4k
  * bottle lighting: https://www.youtube.com/watch?v=UHlPy61SIwY
===== geo-parts control tips =====

  * to do list
    * quick management tool for show and hide geo parts

  * scripts to do
    * copy position tool
===== animation control tips =====

  * to do

===== rendering control tips =====

  * animation and render advance feature: https://www.youtube.com/watch?v=y49WyMct9CA

===== scripting tip =====

  * https://keyshot.com/scripting/doc/6.0/quickstart.html

====== Resource ======

  * keyshot cloud, for tons of material, back plate, environment hdri, textures.
    * https://cloud.keyshot.com
  * For cloud resource, use web browser and click download to get special link for the download
    * then, use cmd line to bin and run code like this (free login acc required) <code>keyshot_cloud_handler.exe keyshotcloud://get?eyJpZCI6MzQ0OCwidHlwZSI6MH0%3D</code>
====== Keyshot learning ======

  * official learning site: https://www.keyshot.com/learning/
  * https://www.youtube.com/user/KeyShot3D/videos
  * https://www.youtube.com/user/5ar666/videos

====== Problem and Solution ======

  * Problem: glass render with alpha channel checked, but glass is not transparent in png, still with background behind it
    * Solution 1: use glass material with refraction checked on, not (no solid glass, or dielectric or transparent plastic) "because this is the only material rendering with an "alpha channel"
    * Solution 2: double render, one with your old glass setup, one with your simple glass material just for the alpha channel, then combine
    * Solution 3: render what you have with backplate as RGB 0-255-0, so perfect green screen, then key out green screen in nuke something like that, it may affect other transparent color as well though
    * ref: 
      * https://forum.keyshot.com/index.php?PHPSESSID=5e1d7fc7becd65e7730570fc545d2c55&topic=25995.0
      * https://forum.keyshot.com/index.php?topic=5613.0
      * double render method: https://forum.keyshot.com/index.php?topic=5613.15
      * offical guide on transparent bg: https://blog.keyshot.com/alpha-transparent-backgrounds-keyshot
      * a video explain on reason behind that limit in keyshot (you either composite or use other render): ( Rendering Transparent Objects in KeyShot ) https://www.youtube.com/watch?v=uhud-v4LYoA
        * composite guide: https://www.youtube.com/watch?v=YoDQ3F9S6s4&t=0s