diff --git a/WIP_311_update/contents.html b/WIP_311_update/contents.html new file mode 100644 index 0000000..d5120df --- /dev/null +++ b/WIP_311_update/contents.html @@ -0,0 +1,147 @@ + + + +Art of Illusion 3.1 + + + + + + +
Art of Illusion
+
Manual for version 3.1
+
+
+

About the manual

+

This Work In Progress

+
+
+

We need a more tutorial like crash course for new users. The manual itself should stay more technical and detailed.

+
+ +
+
+Contents

+ +
    +
  1. Introduction +
      +
    1. What is Art of Illusion? +
    2. How does it work? +
    3. Software build-up +
    +
  2. Getting Started +
      +
    1. Downloading and installing +
        +
      1. Mac +
      2. Windows +
      3. Linux +
      4. Other / general +
      +
    2. Launcing the program +
        +
      1. Default start +
      2. Allocating extra memory +
      +
    3. Installing plugins +
    +
  3. User interface +
      +
    1. Layout Window +
        +
      1. Menus +
      2. Views +
      3. Tools pallette +
      4. Object list +
      5. Object list and properties +
      6. Animation score +
      +
    2. User preferences +
        +
      1. Language selection +
      2. Appearance +
      3. Performance +
      4. Preferences file +
      +
    3. Using views +
        +
      1. Display modes +
      2. Selecting shown items +
      3. One view / four views toggle +
      4. Orientation and camera assignment +
      5. Magnification +
      6. Perspective +
      7. Navigation mode +
      +
    4. Mouse controls +
        +
      1. Multi-button mouse +
      2. Single-button mouse +
      3. Mouse functions in detail +
      +
    5. Keyboard_shortcuts +
    6. Interface enhancement +
        +
      1. Display Mode Icons +
      2. Connecting a 3D-Controller +
      3. Changing appearance +
      +
    + +
  4. Working with scenes and files +
      +
    1. Opening a single scene +
    2. Opening multiple scenes +
    3. SceneProperties +
        +
      1. Environment settings +
      2. Managing textures and materials +
      3. Managing images +
      +
    4. Exchangin contents between scenes +
        +
      1. Copying objects +
      2. Retrieving textures and materials +
      +
    5. Handling other file formats + +
    +
  5. Procedural editing +
      +
    1. Editor interface +
    2. Building a procedure +
    3. Mathematical expressions +
    +
  6. Modeling +
  7. Textures and materials +
      +
    1. A texture or a material? +
    2. Texture types +
        +
      1. Uniform texture +
      2. Image Mapped Texture +
      3. Procedural 2D-Texture +
      4. Procedural 3D-Texture +
      +
    3. Material types +
        +
      1. Uniform material +
      2. Procedural material +
      +
    +
  8. Animation +
  9. Rendering +
  10. Scripting +
  11. Writing plugins +
+ +
+ +
+
+
+
November 2019
+
+ + diff --git a/WIP_311_update/foldertemplate/document.html b/WIP_311_update/foldertemplate/document.html new file mode 100644 index 0000000..7646869 --- /dev/null +++ b/WIP_311_update/foldertemplate/document.html @@ -0,0 +1,33 @@ + + + + +Art of Illusion 3.1 + + + + + + + + + +

Chapter

+

+Intoduction text +

+ +

Main topic

+

+Paragraph +

+ +
+
+ +
+
+
+
+ + diff --git a/WIP_311_update/index.html b/WIP_311_update/index.html new file mode 100644 index 0000000..b9b4309 --- /dev/null +++ b/WIP_311_update/index.html @@ -0,0 +1,7 @@ + + + + + + + diff --git a/WIP_311_update/introduction/introduction.html b/WIP_311_update/introduction/introduction.html new file mode 100644 index 0000000..d92d403 --- /dev/null +++ b/WIP_311_update/introduction/introduction.html @@ -0,0 +1,71 @@ + + + +AoI 3.1 Intorduction + + + + + + + + + + + +

Introduction

+
+ +

What is Art of Illusion?

+

+ +Art of Illusion is a 3D-graphics software for creating photorealistic (or not so photorealistic) still images and animations. + +

+ +
a gif animation
+ +

The main drivers in developing this software have been easiness of use and open environment for development. The program is widely customizable and the program code is freely available on the development site.

+ +

How does it work ?

+ +

To create an image or a movie you first create a 3D-scene, which consists of threedimensional objects.

+ +
modeling time image
+ +

At simplest the objects may be simple forms like spheres or discs or they can represent more complex or organic shapes like buldings or animals. You may assign the objects with textures and materials to achieve the visual appearance you like. You can have the objects move and change shape in time to create an animation. You have several different options availabe for creating the lighting conditions you need.

+ +
texturing image (collage?)
+ +

To render an image or a movie you define a rendering sequence. There is a large variety of choices for image quality, illumination processing and animation parameters. Finally you start the renderer to create the image or the animated movie.

+ +
a final piece (possibly animated)
+ +

The file extension for Art of Illusion scenes files is .aoi. There are no separate file formats for objects, animations or assemblies. You can exchange information between scenes by copying or linking and you can import images to your scenes either for reference or to be used with textures or materials.

+ +

To lears to use Art of Illusion, please study this manual and try out some of the step-by-tep tutorials or tutorial videos on the homepages.

+ +

Software build-up

+ +

Art of Illusion runs on Java versions 6 up. The software consists of the core software, that comes with the installation package and add-on parts, that may be compiled plugins or user editable scripts.

+ +

The core software contains all the necessary tools to start modelling, texturing, animating and rendering but it is recommended to add at least a few of the most useful pluging enhancements. A full API (application programming interface) documentation is available on the homepages for scipts and plugins development.

+ +

Plugins can add a large variety of functions and properties to the core software. They can bring in new object types with the tools to work on them, add improved properties to the user interface, add new types of textures and material, add new properties to editors, add completely new tools.... Plugins are written in Java and compiled into .jar files, which can simply be added to the relevand directory under the instalation and they'll be immediately in use.

+ +

Scripts can add tools, construct objects or alter setting of the software. Art of Illusion supports two scripting languages, Groovy and Beanshell. The benefit in using scripts is, that they can be tailored for very specific needs.

+ +

The installation package comes with a tool for retrieving extension parts from an online library. Using the tool is not obligatory though: plugins and script can simply be added manually to their specific directories. Art of Illusion also provides a basic text editor for writing and editing scripts.

+ +

To find out more, please have a look at the Writing plugins and Scripting sections of the maunal or the software development site on Github.

+ +
+
+
+
November 2019
+
+ + + diff --git a/WIP_311_update/introduction/style/h1_counter.css b/WIP_311_update/introduction/style/h1_counter.css new file mode 100644 index 0000000..901349a --- /dev/null +++ b/WIP_311_update/introduction/style/h1_counter.css @@ -0,0 +1,5 @@ +body +{ + counter-reset: c1; + counter-increment: c1 1; +} \ No newline at end of file diff --git a/WIP_311_update/scene/image/broken.png b/WIP_311_update/scene/image/broken.png new file mode 100644 index 0000000..3a4ac04 Binary files /dev/null and b/WIP_311_update/scene/image/broken.png differ diff --git a/WIP_311_update/scene/image/image_details.png b/WIP_311_update/scene/image/image_details.png new file mode 100644 index 0000000..6c1eb70 Binary files /dev/null and b/WIP_311_update/scene/image/image_details.png differ diff --git a/WIP_311_update/scene/image/image_tools.png b/WIP_311_update/scene/image/image_tools.png new file mode 100644 index 0000000..df2ee4e Binary files /dev/null and b/WIP_311_update/scene/image/image_tools.png differ diff --git a/WIP_311_update/scene/image/linked.png b/WIP_311_update/scene/image/linked.png new file mode 100644 index 0000000..eaf506c Binary files /dev/null and b/WIP_311_update/scene/image/linked.png differ diff --git a/WIP_311_update/scene/image/load_or_link.png b/WIP_311_update/scene/image/load_or_link.png new file mode 100644 index 0000000..7782177 Binary files /dev/null and b/WIP_311_update/scene/image/load_or_link.png differ diff --git a/WIP_311_update/scene/image/manage_images.png b/WIP_311_update/scene/image/manage_images.png new file mode 100644 index 0000000..6b0e3da Binary files /dev/null and b/WIP_311_update/scene/image/manage_images.png differ diff --git a/WIP_311_update/scene/image/purge_dialog.png b/WIP_311_update/scene/image/purge_dialog.png new file mode 100644 index 0000000..6d5a808 Binary files /dev/null and b/WIP_311_update/scene/image/purge_dialog.png differ diff --git a/WIP_311_update/scene/image/selected.png b/WIP_311_update/scene/image/selected.png new file mode 100644 index 0000000..114fdff Binary files /dev/null and b/WIP_311_update/scene/image/selected.png differ diff --git a/WIP_311_update/scene/image/used.png b/WIP_311_update/scene/image/used.png new file mode 100644 index 0000000..b610492 Binary files /dev/null and b/WIP_311_update/scene/image/used.png differ diff --git a/WIP_311_update/scene/managing_images.html b/WIP_311_update/scene/managing_images.html new file mode 100644 index 0000000..e2e1e31 --- /dev/null +++ b/WIP_311_update/scene/managing_images.html @@ -0,0 +1,131 @@ + + + +Art of Illusion 3.1 + + + + + + + +
+

Scene properties

+
+ +

Managing images

+ +

In Art of Illusion you can use images to generate textures. To manage the images select Scene Images...

+ + + +

Imagemapped textures and procedural editors also open this dialog to handle images.

+ +
+Stretching the dialog will enlarge the icons. +
+

The icon symbols

+ + + + + + + + + + + + + + + + + + +
+Colored frame: Currently selected for an action.
+The selection color is defined in the current color theme. +
+Paper clip: A texture or a material is using the image.
+Images that are in use can not be deleted. +
+Chain: This image is linked from an external file.
+You can keep editing the file and Refresh for changes +
+Broken chain: The linked image file could not be read.
+The icon shows, what kind of an image is missing.
+Try View Details → Reconnect to find the image
+
+ +

Using images

+ +

To pick an image for your texture, click an image icon to select it and click OK.

+ +

Importing images

+ +

You have two options for importing images: You can load them into the scene as local images or you can link them as external files.

+ + + +

A loaded image will be saved with the scene. It will be kept safe from any changes to the original image but it can not be edited or replaced.

+ + +

A linked image stays as an independent image file. You can edit the image afterwards or even change the image, that the link is referring to. The link is saved in both relative and absoulte forms, so if you move the scene inside your hard drive, you can either move an entire folder structure including your images or you can keep the images in a stationary library.

+ +

Linked images are marked by a piece of a chain on lower left corner of the image icon. If the image file is not found, the chain icon appears broken and the displayed replacement icon will show, what type of an image is missing. To reconnect the link to a lost image, first click the icon to select it and then click View Details... Reconnect.

+ +

Tools to manage the images

+ + + +

Refresh: Reload linked images. Use this if you have edited one.

+ +

Delete: Remove the selected image or link.

+ +

View Details: Open a dialog to handle the currently selected image

+ + + +Here you can: + + + +
+Idea, how to use:
+ - Link an image, while you are working on it.
+ - Convert to local, when finished. +
+ +

Purge: Delete unused images.

+ +
+
+

The Purge dialog will suggest to remove all unused images and links. You can select individually which ones to remove before performing the action. Purge does not delete images, that are currently in use.

+
+
+ +
+
+ +
+
+
+
November 2019
+
+ + \ No newline at end of file diff --git a/WIP_311_update/scene/style/h1_counter.css b/WIP_311_update/scene/style/h1_counter.css new file mode 100644 index 0000000..71dab75 --- /dev/null +++ b/WIP_311_update/scene/style/h1_counter.css @@ -0,0 +1,5 @@ +body +{ + counter-reset: c1; + counter-increment: c1 4; +} \ No newline at end of file diff --git a/WIP_311_update/style/contents.css b/WIP_311_update/style/contents.css new file mode 100644 index 0000000..228c19a --- /dev/null +++ b/WIP_311_update/style/contents.css @@ -0,0 +1,84 @@ + +.aoi-caption +{ + color: #C34; + color: #DA4; + font-family: "Candara"; + font-size: 102px; + font-weight: bold; + text-shadow: 5px 5px 10px #7548; +} + +.manual-caption +{ + color: #C34; + font-size: 25px; + text-shadow: 3px 3px 4px #A688; +} + +.contents +{ + color: #47D; + margin: 20px; + font-size: 19px; +} + +a +{ + text-decoration: none; +} +a:link +{ + color: #26F; +} +a:visited +{ + color: #79D; +} +a:hover +{ + color: #F60; +} +a:active +{ + color: #4F8; +} + +ul, ol +{ + color: #248; + margin: 5px 0px 10px ; + font-size: 0.9em; + padding-left: 0px; +} + +ol +{ + counter-reset: topic; +} + +ol ol +{ + padding-left: 15px; +} + +ol ol ol +{ + padding-left: 25px; +} + +ol ol ol ol +{ + padding-left: 35px; +} + +li +{ + display: block +} + +li::before +{ + content: counters(topic, ".") " "; + counter-increment: topic; +} \ No newline at end of file diff --git a/WIP_311_update/style/h_counters.css b/WIP_311_update/style/h_counters.css new file mode 100644 index 0000000..d9a576f --- /dev/null +++ b/WIP_311_update/style/h_counters.css @@ -0,0 +1,35 @@ +body { + counter-reset: c1; +} +h1 { + counter-reset: c2; +} +h2 { + counter-reset: c3; +} +h3{ + counter-reset: c4; +} +h4{ + counter-reset: c5; +} + +h1::before { + content: counter(c1) ". "; +} +h2::before { + counter-increment: c2; + content: counter(c1) "." counter(c2) " "; +} +h3::before { + counter-increment: c3; + content: counter(c1) "." counter(c2) "." counter(c3) " "; +} +h4::before { + counter-increment: c4; + content: counter(c1) "." counter(c2) "." counter(c3) "." counter(c4) " "; +} +h5::before { + counter-increment: c4; + content: counter(c1) "." counter(c2) "." counter(c3) "." counter(c4) "." counter(c5) " "; +} diff --git a/WIP_311_update/style/header.css b/WIP_311_update/style/header.css new file mode 100644 index 0000000..a45d2de --- /dev/null +++ b/WIP_311_update/style/header.css @@ -0,0 +1,4 @@ +body +{ + padding: 10px 20px 10px 20px; +} diff --git a/WIP_311_update/style/manual.css b/WIP_311_update/style/manual.css new file mode 100644 index 0000000..47bed4d --- /dev/null +++ b/WIP_311_update/style/manual.css @@ -0,0 +1,219 @@ +html +{} + +body +{ + max-width: 600px; + min-width: 300px; + margin: 50px; + padding: 10px 20px 120px 20px; + margin: auto; + font-family: Segoe UI, Gadugi, Helvetica, Sans-serif; + font-size: 14px; + color: #458; + background: #FDFFF0; + /*background: #FEFFFA;*/ + scroll-behavior: smooth; +} + +a +{ + text-decoration: none; +} +a:link +{ + color: #26F; +} +a:visited +{ + color: #04B; +} +a:hover +{ + color: #F60; +} +a:active +{ + color: #4F8; +} + +h1 +{ + color: #8BE; + padding: 0px; + margin: 0px; + margin-bottom: 5px; + font-size: 32px; + font-weight: 600; + text-shadow: 1.8px 1.8px 2.5px #47A6; +} + +h2 +{ + color: #69C; + font-size: 24px; + font-weight: 600; + text-shadow: 1.6px 1.6px 1.8px #AAF6; +} + +h3 +{ + color: #58A; + font-size: 20px; + font-weight: 600; + text-shadow: 1.2px 1.2px 1.6px #AAF6; +} + +h4 +{ + color: #257; + font-size: 18px; + font-weight: 600; + text-shadow: 1.1px 1.1px 1.4px #AAF6; +} + +code +{ + font-family: "Source Code Pro", "Courier New", Monospace; + color: #480; +} + +.code +{ + font-family: "Source Code Pro", "Courier New", Monospace; + background: #FFF; + padding: 15px; + padding-top: 0.75em; + margin:20px; + border: 1px solid #4442; +} + +em +{ + font-style: normal; + font-weight: 550; + color: #26A; +} + +big +{ + font-size: 1.2em; +} + +.last_update +{ + text-align: center; + /*font-family: "Segoe Script", "Comic Sans MS", cursive;*/ + font-family: cursive; + + font-size: 0.62em; + font-style: italic; + /*font-weight: 550;*/ + color: #26A8; +} + +hr +{ + display: block; + margin-top: 0.3em; + margin-bottom: 0.4em; + margin-left: auto; + margin-right: auto; + border-style: solid; + border-width: 1px; + border-color: #8884; +} + +table, th, td +{ + border: 1px solid #9A8; + border-collapse: collapse; + padding: 4px; + text-align: left; + vertical-align: top; +} + +table +{ + margin-left: 20px; + margin-right: auto; + margin-bottom: 20px; + max-width: 90%; +} + +table.no_frame, table.no_frame tr, table.no_frame td +{ + border: 0px; + vertical-align: top; +} + +img.center +{ + display: block; + margin-right: auto; + margin-left: auto; + padding-right: auto; + padding-left: auto; +} + +note +{ + color: #CC0044; + font-style:italic; + font-size: 1.1em; + margin-left: 20px; + padding: 8px; +} +.tba +{ + color: #A46; + font-family: cursive; + font-size: 1.2em; + font-variant: small-caps; + font-weight: 540; + text-align: center; + margin: auto; + padding: auto; +} + +.alertbox +{ + border: 1px solid #AA0044; + color: #AA0044; + font-style:italic; + font-size: 0.9em; + padding: 8px; +} + +.infobox +{ + border: 1px solid #0066AA; + color: #0066AA; + font-style:italic; + font-size: 0.9em; + padding: 8px; +} + +.flex-container +{ + display: flex; + flex-direction: row; + flex-wrap: wrap-reverse; +} + +.textbox-left +{ + padding-right: 20px; + width: calc(100% - 312px - 20px); +} + +.imagebox-right +{ + width: 312px; +} + +@media screen and (max-width:720px) +{ + .textbox-left{width: 100%;} + .imagebox-right{width: 100%;} +} diff --git a/WIP_311_update/style/responsive.css b/WIP_311_update/style/responsive.css new file mode 100644 index 0000000..d2c9fc8 --- /dev/null +++ b/WIP_311_update/style/responsive.css @@ -0,0 +1,40 @@ + +.column50 +{ + +/* This has to be left or right. Center stacks the boxes vertically.*/ + + float: left; + +/* Another thing that looks like a logical glitch + to me: 50% + 50% > 100%. Padding and border have no effect + but 48% + 48% fits 100% of width. + + I'm making it a bit smaller to give it some flexibility */ + + width: 47%; + padding: 0px 10px 0px 0px; +} + +/* Clear floats after the columns */ +.row:after + { + content: ""; + display: table; + clear: both; +} +.responsive +{ + width: 100%; + height: auto; +} +/* This defines the width, where the view switches to vertical stacking. + The setting favors stacting side-by-side boxes over compressing + them in width + + This has to be after the declaration of the class */ + +@media screen and (max-width: 600px) +{ + .column50 {width: 100%;} +} diff --git a/WIP_311_update/text_icon/arrow_right.png b/WIP_311_update/text_icon/arrow_right.png new file mode 100644 index 0000000..f1116c6 Binary files /dev/null and b/WIP_311_update/text_icon/arrow_right.png differ diff --git a/WIP_311_update/user_interface/image/3bm.jpg b/WIP_311_update/user_interface/image/3bm.jpg new file mode 100644 index 0000000..00ac391 Binary files /dev/null and b/WIP_311_update/user_interface/image/3bm.jpg differ diff --git a/WIP_311_update/user_interface/image/layoutwindow_out_of_box.png b/WIP_311_update/user_interface/image/layoutwindow_out_of_box.png new file mode 100644 index 0000000..07875b5 Binary files /dev/null and b/WIP_311_update/user_interface/image/layoutwindow_out_of_box.png differ diff --git a/WIP_311_update/user_interface/image/mac-keys.jpg b/WIP_311_update/user_interface/image/mac-keys.jpg new file mode 100644 index 0000000..9af6b77 Binary files /dev/null and b/WIP_311_update/user_interface/image/mac-keys.jpg differ diff --git a/WIP_311_update/user_interface/image/mac-keys_original.jpg b/WIP_311_update/user_interface/image/mac-keys_original.jpg new file mode 100644 index 0000000..ada4792 Binary files /dev/null and b/WIP_311_update/user_interface/image/mac-keys_original.jpg differ diff --git a/WIP_311_update/user_interface/image/navigationmode.png b/WIP_311_update/user_interface/image/navigationmode.png new file mode 100644 index 0000000..352c60b Binary files /dev/null and b/WIP_311_update/user_interface/image/navigationmode.png differ diff --git a/WIP_311_update/user_interface/image/scrollcues.png b/WIP_311_update/user_interface/image/scrollcues.png new file mode 100644 index 0000000..4532caf Binary files /dev/null and b/WIP_311_update/user_interface/image/scrollcues.png differ diff --git a/WIP_311_update/user_interface/image/viewtools.png b/WIP_311_update/user_interface/image/viewtools.png new file mode 100644 index 0000000..e58b39e Binary files /dev/null and b/WIP_311_update/user_interface/image/viewtools.png differ diff --git a/WIP_311_update/user_interface/image/workingdepth.png b/WIP_311_update/user_interface/image/workingdepth.png new file mode 100644 index 0000000..9f924b8 Binary files /dev/null and b/WIP_311_update/user_interface/image/workingdepth.png differ diff --git a/WIP_311_update/user_interface/keyboard_shortcuts.html b/WIP_311_update/user_interface/keyboard_shortcuts.html new file mode 100644 index 0000000..873d547 --- /dev/null +++ b/WIP_311_update/user_interface/keyboard_shortcuts.html @@ -0,0 +1,153 @@ + + + +Art of Illusion 3.1 + + + + + + + + + +
+ +

User interface

+
+ +

Keyboard Shortcuts

+ +

+To speed up workflow, many of the tools and functions have keyboard shortcuts. Some of them are written in the program code -- some can be edited on the Preferences/Shorcuts tab. They are summarised below: +

+ + +

Scene window

+These are partially out of date + + + + + + + + + + + + + + +
+
+File Functions:
+
+Ctrl+N - Create a new AoI file
+Ctrl+O - Open an existing AoI file
+Ctrl+W - Close the current AoI file
+Ctrl+S - Save the current AoI file with the same name
+Ctrl+Q - Quit Art of Illusion
+
+
+Edit +Functions:
+
+ Crtl+Z - Undo/Redo +last action
+Ctrl+X - Cut the selected object(s) to the clipboard
+Ctrl+C - Copy the selected object(s) to the clipboard
+Ctrl+V - Paste the object(s) from the clipboard into the file
+Ctrl+A - Select all the objects in the scene
+Delete - Clear selected object(s)
+
+		 +
+Object +Functions:
+
+Ctrl+E - Edit Object
+Ctrl+L - Edit the object layout
+Ctrl+T - Open the Transform Object Dialogue
+Ctrl+U - Set Texture for currently selected object(s)
+Ctrl+M - Set Material for currently selected object(s)
+
+Arrow keys can be used to move/rotate selected object(s) in the plane +of the currently selected view window if the Move/Rotate Icons are on. +Holding Ctrl while pressing the up/down keys moves/rotates +in the other axis. Holding ALT while pressing the arrow keys +moves/rotates the object by 10 pixels.
+

+Animation Functions:
+
+Ctrl+P - Preview Animation
+Ctrl+] - Move forward one frame
+Ctrl+[ - Move backward one frame
+Ctrl+J - Jump to time ...
+Ctrl+D - Edit selected keyframe
+Ctrl+K - Keyframe selected track(s)
+Ctrl+Shift+K - Keyframe modified tracks
+Ctrl+Shift+A - Select all tracks of selected objects
+
+		 +
+Scene Functions:
+
+Ctrl+R - Open the Render dialogue window
+Ctrl+Shift+R - Render immediately with current settings
+Ctrl+Shift+U - Open Textures dialogue window
+Ctrl+Shift+M - Open Materials dialogue window
+		 +View functions

+Ctrl+B - Toggle between one view mode and four view mode
+Ctrl+G - Open Grid dialogue window
+Ctrl+Shift+F - Fit model to selection
+Numberpad * - Align view to closest axis directions +
+ +

Mesh editor window

+These need to be split into separate lists per function + + + + + + + +

+Mesh +Editor Functions:
+
+Ctrl+Z - Undo/redo last action
+Ctrl+A - Select all vertices/edges/faces
+Ctrl+X - Extend selection
+Ctrl+F - Fit view to selection
+Ctrl+Shift+F - Fit model to selection
+Cthr+H - Toggle freehand selection mode
+Ctrl+W - Display as quads
+Ctrl+M - Open Mesh Tension dialogue
+Ctrl+E - Edit selected point(s)
+Ctrl+T - Transform selected point(s)
+Ctrl+B - Bevel/Extrude selection
+Ctrl+P - Open texture parameters dialogue
+Ctrl+S - Set smoothness for selected vertices/edges
+Ctrl+R - Render preview
+Ctrl+D - Open Edit Bone dialogue
+Ctrl+G - Open Grid dialogue
+
+Arrow keys can be used to move selected points one pixel at a time in +the plane of the view if the Move Icon is selected. Holding Ctrl while +pressing the up/down keys moves +in the other axis. Holding ALT while pressing the arrow keys moves the +points by 10 pixels.
+
+ +
+
+
+
November 2019
+
+ + diff --git a/WIP_311_update/user_interface/layoutwindow.html b/WIP_311_update/user_interface/layoutwindow.html new file mode 100644 index 0000000..25237e9 --- /dev/null +++ b/WIP_311_update/user_interface/layoutwindow.html @@ -0,0 +1,95 @@ + + + +AoI 3.1 Userinterface + + + + + + + + + + + + +

User interface

+
+ +

Layout window

+

+ +The main window of Art of Illusion is called the "Layout Window". +

+

+When you launch the software the firts time, the Layout Winodw appears like this. The local language will be selected automatically if a matching translaton is available. +

+

+We recommend, that you have a look at the User preferences and the Interface enhancement sections. +

+ + + +

Menus

+ +

On the top of the window you can see the menubar.

+ +image + +

The menus provide access to everyhing, that can be done with the software. The content of each menu will be introduced later in the manual, where each function is explained.

+ +

Tools pallette

+ +

+On the left you can find the tools pallette. The pallette contains tools for: +

+

+ +

Scene editing tools

+ +

Object creation tools

+ +

Each object type comes with their dedicated editors or property dialogs, where detailed edithing happens.

+ +

View tools

+ +

+Normally, you'd handle the views by the mouse buttons, scroll wheel and modifier keys but on the toolbar you can find two icons, 'move' and 'rotate' for view handling. +

+ +

+If you select one of these tools, dragging on the view the left mouse button will perform the move or rotate. The icon activated tools also work in stylus or finger use on touch operated devices.

+ +

+Please have a look at Using views, Mouse functions and Keyboard Shortcuts. Even though you will easily find the basic fuctions of the mouse just by experimenting, there is a lot more there, that you will be very helpful, when you start to become more familiar with Art of Illusion. +

+ +

Object list and properties

+ +

On the right you have the object list and the object properties panel. Both of those can be undocked and redocked.

+ +

The objects list

+

On the object list you can see the contents of the scene. On the list you can select the object for operations, change their visibility on the scene or arrange the objects to have a suitable parent/child hierarchy. Otherwise moving objects up and down on the list does not change their order in the model data.

+ +

The object properties panel

+

The Object Properties panel containd information about the currently selected object(s). Some of the setting, like the position and orientation of each object, are editable or accessible directly on the panel. What is accessible tepends on the object type.

+ +

Animatoin score

+ +

+

+ +
+
+
+
November 2019
+
+ + diff --git a/WIP_311_update/user_interface/mouse_controls.html b/WIP_311_update/user_interface/mouse_controls.html new file mode 100644 index 0000000..5d310e5 --- /dev/null +++ b/WIP_311_update/user_interface/mouse_controls.html @@ -0,0 +1,135 @@ + + + +AoI 3.1 Mouse controls + + + + + + + + + + +
+ +

User interface

+
+ +

Mouse controls

+ +- Need new mouse pictures.
+- The mouse button maps need to be more visual. + +

Multi-button mouse

+ +

+The UI is mostly controlled by mouse buttons and modifier keys. The basic approach is designed over a 3-button mouse with a scroll wheel: +

+
+
+ +
+
+

+

    +
  • Left button = select, edit +
  • Middle button = center / rotate view +
  • Scroll wheel = zoom +
  • Right button = move view +
+Shift and Ctrl keys modify the functions. + +

+
+In case you are wondering: There is no way of assigning functions to more than three mouse buttons. +
+
+
+ +

Single-button mouse

+

+If you are using a single button mouse, you can use modifier keys to obtain the right and middle button functions. This applies to all functions: For example Ctrl+Right Button would be the combination Meta+Ctrl+Mousebutton: +

+

+

+
+
    +
  • No modifiers = select, edit +
  • Alt = center / rotate view +
  • Meta = move view +
  • Meta + Ctrl = zoom +
+Shift and Ctrl keys modify the functions further. +

+
+NOTE: You have to release the Alt-key before releasing the mouse button.
Else the next click will revert the rotation and center the view to the point you clicked on. This is a known bug. +
+
+
+ +
+
+

+"Meta" is the name of the key in the coding though few computers have an actual key by that name. On Mac-systems the installation package takes care of assingning the meta-key approproately. +

+ +

+ + +

Mouse functions in detail

+

+The full set of control functions consists of click, double click, dragging (moving the mouse while a button pressed) and pressing modifier keys whie usin the mouse. The table below introduces all the common functions. More left button functions of the left button may be introduced in greater in the descriptions of each tool. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Left button / Mouse button alone
ClickActivate tools or select single objects
Shift + ClickAdd objects to selection
Double clickOpen dialogs or editors (on the tools pane, open tool settings)
Dragselect/move/create objects
Shift + Drage.g. create objects with equal proportions
Middle button / Alt + Mouse button
'Click'Center the view and set working depth.
The function is actually NOT coded as 'click' but as 'press and release'.
Click on object listFit view to object(s)
DragRotate view
Ctrl + DragTilt view (if tilt is available, see Navigation modes)
Ctrl + Shift + DragPan the view around the viewing point
Right button / Meta + Mouse button
ClickOpen pop-up menus
DragMove view (left, right, up or down).
Ctrl + DragSpace and Tray modes: Zoom in/out to the rotation center point.
+ Drone and Dolly modes: Move forward.
Scroll wheel
ScrollSpace and Tray modes: Zoom in/out to the rotation center point.
+ Drone and Dolly modes: Move forward. +
Alt + ScrollPrecision scroll (slow)
+ +
+
+
+
November 2019
+
+
+ + diff --git a/WIP_311_update/user_interface/navigation_mode.html b/WIP_311_update/user_interface/navigation_mode.html new file mode 100644 index 0000000..c61cd31 --- /dev/null +++ b/WIP_311_update/user_interface/navigation_mode.html @@ -0,0 +1,85 @@ + + + +Art of Illusion 3.1 + + + + + + + + +
+ +

User interface

+
+ +

Working with views

+ + +I'm not happy with this one yet + +

+Navigation modes define, how the view responds to the mouse. +

+ +

+There are four modes, called 'Sphere', 'Tray', 'Drone' and 'Dolly'. +Tray and Sphere are suitable for ediitng the scene and individual objects. Drone and Dolly modes are suitable for exploring large models or for example designing and recording camera drives. +

+

Edit modes, 'Sphere' and 'Tray'

+

+In edit modes the view always rotates around a point (the 'rotation center'), that is in the model sphere on the center axis of the view. The rotation center also defines the working depth of the view. Zoom will bring you closer to the rotation center allowing you work on small details. Use Middle button-click to focus to a point. +

+Sphere: This allows free rotation to all directions. Sphere is the default mode for mesh editors. +

+ +-- this needs more pictures! -- + +

+Tray: Y-axis is locked up (tilting to either side is not possible in tray-mode) and rolling forward and back are limited to [-90°, +90°]. In essense the behavior is as if you had your scene set on a tray. Tray mode is the default for scene views. +

+ +

Travel modes, 'Drone' and 'Dolly'

+

+The idea of travel modes is, that instead of looking at the model on the outside, you place yourself into the model space. In these modes rotate becomes pan and zoom becomes move forward/back. These modes probably require some practice to be truely useful but they may come in handy in appropriate use cases. The travel modes make better sense with relatively wide camera angles and crowded scenes. Set the window to one view mode (Ctrl+B) or camera angle to 45° or higher. The modes are designed to be used mostly by the scroll wheel, though other controls work as well. +

+

+Note that using center-button click sets the working distance of the view, which directly affects the scroll step size and hence the speed of movement. You can also set the working depth by typing into the magnification field. +

+ + +

+When either of the travel modes is activated, cue graphics are drawn onto the view. The cues are meant to help with the aim, when using the scroll wheel. You can find cue graphics settings in the Preferences. +

+ +

+Drone: Equivalent to Space. Allows you to fly in the model space into any direction. The positon of the mouse cursor affects the scroll function like this: +

+ +

+Dolly: Equivalent to Tray. Allows you to travel along the x-z-plane with y-direction always up. +

+ + +
+
+
+
November 2019
+
+ + + diff --git a/WIP_311_update/user_interface/style/h1_counter.css b/WIP_311_update/user_interface/style/h1_counter.css new file mode 100644 index 0000000..739e5ae --- /dev/null +++ b/WIP_311_update/user_interface/style/h1_counter.css @@ -0,0 +1,5 @@ +body +{ + counter-reset: c1; + counter-increment: c1 3; +} \ No newline at end of file diff --git a/WIP_311_update/user_interface/style/mouse_controls.css b/WIP_311_update/user_interface/style/mouse_controls.css new file mode 100644 index 0000000..7895826 --- /dev/null +++ b/WIP_311_update/user_interface/style/mouse_controls.css @@ -0,0 +1,10 @@ +td +{ + min-width: 120px; +} + +tr.hide_sides +{ + border-right-style: hidden; + border-left-style: hidden; +} diff --git a/WIP_311_update/user_interface/user_preferences.html b/WIP_311_update/user_interface/user_preferences.html new file mode 100644 index 0000000..b2ca5cb --- /dev/null +++ b/WIP_311_update/user_interface/user_preferences.html @@ -0,0 +1,65 @@ + + + +AoI 3.1 Preferences + + + + + + + + + +

User interface

+
+ +

User preferences

+

+The preferences setting dialog can be found at the bottom of the Edit menu. +

+ +

Language selection

+

+You can select the language of the userinterface in the drop down menu on the top of the Preference dialog. +

+--image-- + + +

When you change the language, the new setting affects only the new windows and dialogs in the session. It is recommended to restart after changing the language.

+ +

The selected language does not affect default names of the objects or any internal functions of the software. It only translates the user interface.

+ +

Unfortunately many of the translations are incomplete. The default translation for any missing texts is (US) English. If you wish to contribute to improving any of the translatiosn, you can start by having a look at the translation files on Github.

+ +

Appearance

+

Theme

+

Background color

+

Performance

+

Preferences file

+ +

Your preferences setting are stored in a folder called .artofillusion under your personal user directory. The folder may appear hidden on your system. An individual preferences folder will be created for username, that uses Art of Illusion.

+ +

The two files, that belong to Art of Illusion core software are: + +

+
aoiprefs
+

The settings from the 'General'-tab on the preferences dialog.

+
keystrokes.xml
+

The programmable keyboard shortcuts form the 'Shortcuts' tab on the preferences dialog. Some most used shorcuts are hardcoded an can not be changed but there are plenty of editable ones, that are adapted to each different diffent editor.

+

To edit or add your own shortcuts you should familiarize yourself with scripting.

+
+ +

The files are automatically generated text files and it is possible to read and edit the files by a text editor but editing is not recommended. Editing shoud happen through the Preferences dialog.

+ +

Deleting a preferences file or the folder reset prefrences. The folder and/or file will be recreated, when you start Art of Illusion the next time.

+ +
+
+
+
November 2019
+
+ + diff --git a/WIP_311_update/user_interface/using_views.html b/WIP_311_update/user_interface/using_views.html new file mode 100644 index 0000000..e987716 --- /dev/null +++ b/WIP_311_update/user_interface/using_views.html @@ -0,0 +1,65 @@ + + + +Art of Illusion 3.1 + + + + + + + + + + +
+ +

User interface

+
+ +

Using views

+ +

+You have great freedom in how you use the views: +

+

+ +

Display modes

+

+There are five display modes avaliable +

+

Selectig shown items

+

One view / four views toggle

+

Perspective mode toggle

+

Magnification control

+

Navigation modes

+ +

+The views of the Layout Window and the Object Editor Windows follow the same set of rules, except that object editors cannot be assigned with cameras. +

+ +

Default settings

+

+...Hmmm... wonder if that is needed... +

+

4/1 view modes

+

In four view mode you can work on the model through any of the views. Also all the views can be oriented independently. You don't have to stick to the preset orientations.

+

Note that, if a view oriantation is set to a Camera, moving and rotating the view will also move the camera. This is especially handy to find camera angles or to record camera movements for animation or to aim spotlights to their targets.

+ +

Usually it is easier to edit a scene/object through one large view rather than four small ones.

+ +

To switch to one view mode, select View/One View. The active view will be expanded to fill the entire viewing area. This may also be a camera view. To switch back use the same menu selection, which will be now called Four View. The keyboard shotcut to toggle between one and four views is Ctrl+B.

+ +
+
+
+
November 2019
+
+ +